---
title: "Criar plano"
method: POST
path: "/plans"
---

# Criar plano

`POST /plans`

Este recurso possibilita a criação de um `plan` que poderá ser utilizado futuramente para a criação de uma assinatura. Para mais detalhes consulte a [pagina principal do objeto](https://docs.pagar.me/reference/planos-1).

## Request body

- object
  - `name` string, required — Nome do plano. Max: 64 caracteres.
  - `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. O número de parcelas deverá ser 1 em recorrências.
  - `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. Max: 13 caracteres.
  - `currency` string — Moeda. Valores possíveis: **BRL**.
  - `interval` string — Frequência da recorrência. Valores possíveis: **day**,**week**, **month** ou **year**.
  - `interval_count` integer — 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` object[] — Itens do plano. [Saiba mais sobre um itens do plano](https://docs.pagar.me/reference/item-do-plano-1)
    - `description` string — Descrição de itens.
    - `quantity` string — Quantidade de itens.
    - `pricing_scheme` object — Esquema de precificação do item.
      - `scheme_type` string, required — Esquema de precificação do item. Valores possíveis: **unit**, **package**, **volume** e **tier**. Valor default: unit
      - `price` integer — Valor do item. Este atributo está disponível para o scheme_type : **Unit**
      - `mininum_price` integer — Valor mínimo a ser cobrado.
      - `price_brackets` object[] — Intervalo de preços. Este atributo está disponível para os scheme_type : **package**, **volume** e **tier**.
        - `start_quantity` integer — Valor que define a quantidade inicial de unidades do intervalo.
        - `end_quantity` integer — Valor que define a quantidade final de unidades do intervalo.
        - `overage_price` integer — Valor para cálculo do preço por unidade que exceder o intervalo.
        - `price` integer — Valor para cálculo do preço dentro do intervalo. OBS: o preço a ser cobrado do cliente será calculado de acordo com a quantidade e o scheme_type
    - `cycles` string — Indica quantas vezes o item será cobrado.
  - `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)
  - `pricing_scheme` object — Esquema de precificação.<br>Obrigatório na ausência de **items**.
    - `scheme_type` string, required — Esquema de precificação do item. Valores possíveis: **unit**, **package**, **volume** e **tier**. Valor default: unit
    - `price` integer — Valor do item. Este atributo está disponível para o scheme_type : **Unit**
    - `mininum_price` integer — Valor mínimo a ser cobrado.
    - `price_brackets` object[] — Intervalo de preços. Este atributo está disponível para os scheme_type : **package**, **volume** e **tier**.
      - `start_quantity` integer — Valor que define a quantidade inicial de unidades do intervalo.
      - `end_quantity` integer — Valor que define a quantidade final de unidades do intervalo.
      - `overage_price` integer — Valor para cálculo do preço por unidade que exceder o intervalo.
      - `price` integer — Valor para cálculo do preço dentro do intervalo. OBS: o preço a ser cobrado do cliente será calculado de acordo com a quantidade e o scheme_type
  - `quantity` integer — Quantidade para o **pricing_scheme**.<br>Obrigatório quando o **pricing_scheme.scheme_type** for igual a **unit**.

## Response `200`

200

## 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)