---
updatedAt: 2026-04-06T17:18:46.000Z
agentTools:
  projectIndex: https://docs.pagar.me/v1/llms.txt
---

# Atualizando um plano

Atualiza um plano previamente criado

> ❗️ Alterando o amount, days, charges, etc...
>
> **NÃO é possível alterar outros parâmetros além do nome e de trial\_days do plano**

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-settings",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://api.pagar.me/1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "x-default": "",
        "type": "apiKey",
        "name": "api_key",
        "in": "query"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/plans/{plan_id}": {
      "put": {
        "summary": "Atualizando um plano",
        "description": "Atualiza um plano previamente criado",
        "operationId": "atualizando-planos",
        "parameters": [
          {
            "name": "plan_id",
            "in": "path",
            "description": "id de identificação do plano previamente criado",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nome do plano"
                  },
                  "trial_days": {
                    "type": "string",
                    "description": "Dias para testar o produto/serviço gratuitamente"
                  },
                  "invoice_reminder": {
                    "type": "integer",
                    "description": "Define em até quantos dias antes o cliente será avisado sobre o vencimento do boleto.",
                    "format": "int32"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "  {\n    \"object\": \"plan\",\n    \"id\": 163871,\n    \"amount\": 500000,\n    \"days\": 30,\n    \"name\": \"The Pro Plan - Susan\",\n    \"trial_days\": 7,\n    \"date_created\": \"2017-06-07T14:00:23.871Z\",\n    \"payment_methods\": [\n      \"credit_card\"\n    ],\n    \"color\": null,\n    \"charges\": 0,\n    \"installments\": 12,\n    \"invoice_reminder\": null\n  }"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string",
                      "example": "plan"
                    },
                    "id": {
                      "type": "integer",
                      "example": 163871,
                      "default": 0
                    },
                    "amount": {
                      "type": "integer",
                      "example": 500000,
                      "default": 0
                    },
                    "days": {
                      "type": "integer",
                      "example": 30,
                      "default": 0
                    },
                    "name": {
                      "type": "string",
                      "example": "The Pro Plan - Susan"
                    },
                    "trial_days": {
                      "type": "integer",
                      "example": 7,
                      "default": 0
                    },
                    "date_created": {
                      "type": "string",
                      "example": "2017-06-07T14:00:23.871Z"
                    },
                    "payment_methods": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "example": "credit_card"
                      }
                    },
                    "color": {},
                    "charges": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "installments": {
                      "type": "integer",
                      "example": 12,
                      "default": 0
                    },
                    "invoice_reminder": {}
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl -X  PUT https://api.pagar.me/1/plans/163871 -H 'content-type: application/json' -d '{\n    \"api_key\": \"SUA_API_KEY\", \n    \"name\": \"The Pro Plan - Susan\", \n    \"trial_days\": \"7\"\n}'"
            },
            {
              "language": "ruby",
              "code": "require 'pagarme'\n\nPagarMe.api_key = \"SUA_API_KEY\"\n\nplan = PagarMe::Plan.find_by_id(\"163871\")\n\nplan.name = \"The Pro Plan - Susan\"\nplan.trial_days = 7\n\nplan.save"
            },
            {
              "language": "php",
              "code": "<?php\nrequire(\"vendor/autoload.php\");\n$pagarme = new PagarMe\\Client('SUA_CHAVE_DE_API');\n\n$updatedPlan = $pagarme->plans()->update([\n  'id' => '365403',\n  'name' => 'The Pro Plan - Susan',\n  'trial_days' => '7',\n]);"
            },
            {
              "language": "csharp",
              "code": "PagarMeService.DefaultApiKey = \"SUA_API_KEY\";\nvar plan = PagarMeService.GetDefaultService().Plans.Find(\"163871\");\nplan.Name = \"The Pro Plan - Susan\";\nplan.TrialDays = 7;\nplan.Save();"
            },
            {
              "language": "java",
              "code": "import me.pagar.model.PagarMe;\nimport me.pagar.model.PagarMeException;\nimport me.pagar.model.Plan;\n\nPagarMe.init(\"SUA_API_KEY\");\nPlan planF = new Plan();\nplanF.setName(\"The Pro Plan - John\");\nplanF.setTrialDays(7500);\nplanF.setId(\"ID DO PLANO A SER ATUALIZADO\");\nplanF.save();"
            },
            {
              "language": "javascript",
              "code": "const pagarme = require('pagarme')\n  \npagarme.client.connect({ api_key: 'SUA_API_KEY' })\n  .then(client => client.plans.update({\n    id: 163871,\n    name: 'The Pro Plan - Susan',\n    trial_days: '7'\n\t}))\n  .then(plan => console.log(plan))",
              "name": "JS"
            }
          ],
          "samples-languages": [
            "curl",
            "ruby",
            "php",
            "csharp",
            "java",
            "javascript"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```