---
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.

## 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.
  - `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 — Moeda. Valores possíveis: **BRL**, **ARS**, **BOB**, **CLP**, **COP **, **MXN**, **PYG**, **USD **, **UYU** e **EUR**.
  - `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[], required — 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.mundipagg.com/v1/reference#item-do-plano)
    - unknown
  - `metadata` object — Objeto chave/valor utilizado para armazenar informações adicionais sobre o plano.<br>[Saiba mais sobre metadata](https://docs.mundipagg.com/v1/reference#metadata)

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `url` string
  - `minimum_price` integer
  - `interval` string
  - `interval_count` integer
  - `billing_type` string
  - `payment_methods` string[]
  - `installments` integer[]
  - `status` string
  - `currency` string
  - `created_at` string
  - `updated_at` string
  - `items` object[]
    - `id` string
    - `name` string
    - `quantity` integer
    - `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/mundipagg/apis/mundipagg-api.md) · [All operations](https://skmtc.net/mundipagg/apis/mundipagg-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mundipagg/mundipagg-api/versions/1ddb9f03a82d/schema)