---
title: "Editar plano"
method: PUT
path: "/plans/{plan_id}"
---

# Editar plano

`PUT /plans/{plan_id}`

Com o verbo HTTP PUT, através do identificador do plano (`plan_id`)  é possível atualizar os dados do plano.

## Path parameters

- `plan_id` string, required

## Request body

- object
  - `name` string, required — Nome do plano. Max: 64 caracteres.
  - `status` string, required — Status do plano. Valores possíveis: **active** ou **inactive**
  - `description` string — Descrição do plano.
  - `shippable` boolean — Indica se o plano oferece entrega.
  - `payment_methods` string[] — Meios de pagamento disponíveis para assinaturas criadas a partir do plano. <br>Valores possíveis: **credit_card**, **boleto** ou **debit_card**. Caso nenhum seja informado, o único meio de pagamento disponível por padrão será **credit_card**
  - `installments` integer[] — Opções de parcelamento disponíveis para assinaturas criadas a partir do plano.<br>Caso não seja informado, o plano irá disponibilizar apenas assinaturas com pagamentos à vista.
  - `minimum_price` integer — Valor mínimo em centavos da fatura.
  - `statement_descriptor` string — Texto exibido na fatura do cartão. <br>Será aplicado para assinaturas de cartão de crédito criadas a partir do plano.
  - `currency` string, required — Moeda. Valores possíveis: **BRL**, **ARS**, **BOB**, **CLP**, **COP **, **MXN**, **PYG**, **USD **, **UYU** e **EUR**.
  - `interval` string, required — Frequência da recorrência. Valores possíveis: **day**,**week**, **month** ou **year**.
  - `interval_count` integer, required — Número de intervalos de acordo com a propriedade **interval** entre cada cobrança da assinatura. <br>Ex.: plano mensal = **interval_count** (1) e **interval** (month) <br> plano trimestral = **interval_count** (3) e **interval** (month) <br> plano semestral = **interval_count** (6) e** interval** (month)
  - `trial_period_days` integer — Dias de teste. A assinatura será iniciada após o término deste período.
  - `billing_type` string — Tipo de cobrança. Valores possíveis: **prepaid**, **postpaid **ou **exact_day**.
  - `billing_days` integer[] — Dias disponíveis para cobrança das assinaturas criadas a partir do plano. Deve ser maior ou igual a 1 e menor ou igual a 28. **Obrigatório**, caso o **billing_type** seja igual a **exact_day**.
  - `items` unknown[] — Itens do plano. [Saiba mais sobre um itens do plano](https://docs.pagar.me/reference/item-do-plano-1)
    - unknown
  - `metadata` string — Objeto chave/valor utilizado para armazenar informações adicionais sobre o plano.<br>[Saiba mais sobre metadata](https://docs.pagar.me/reference/metadata-1)

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `description` string
  - `url` string
  - `currency` string
  - `interval` string
  - `interval_count` integer
  - `billing_type` string
  - `installments` integer
  - `statement_descriptor` string
  - `status` string
  - `created_at` string
  - `updated_at` string
  - `minimum_price` integer
  - `items` object[]
    - `id` string
    - `name` string
    - `status` string
    - `created_at` string
    - `updated_at` string
    - `pricing_scheme` object
      - `price` integer
      - `scheme_type` string
  - `metadata` object
    - `id` string

## Other responses

- `422` — 422

---

[API](https://skmtc.net/pagar/apis/pagarme-api.md) · [All operations](https://skmtc.net/pagar/apis/pagarme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagar/pagarme-api/versions/dababf062743/schema)