---
title: "Criar Assinatura"
method: POST
path: "/subscriptions"
---

# Criar Assinatura

`POST /subscriptions`

Cria uma Assinatura. [Para mais informações sobre como criar uma assinatura](https://dev.iugu.com/docs/realizar-cobran%C3%A7as-recorrentes-por-api)

## Request body

- object
  - `plan_identifier` string — Identificador do Plano. Só é enviado para assinaturas que não são credits_based
  - `customer_id` string, required — ID do Cliente
  - `expires_at` string, date — Data de Expiração "YYYY-MM-DD HH:MM:SS +TIMEZONE". (Data da primeira cobrança, as próximas datas de cobrança dependem do "intervalo" do plano vinculado).
  - `splits` object[] — Regras de divisão (Split Payment) para todas as Faturas geradas por esta Assinatura.
    - `recipient_account_id` string — ID da Conta que receberá o split. **Não inserir o account_id da conta que requisitará este endpoint**.
    - `cents` integer — Valor fixo, em **centavos**, a serem enviados à esta conta.
    - `percent` number, float — Porcentagem do **valor total** da fatura a ser dividido para o `recepient_account_id`.
    - `permit_aggregated` boolean — Se `true`, permite utilizar Splits tanto do tipo `percent` quanto `cents`.
    - `bank_slip_cents` integer — Valor a ser dividido se a fatura for paga por **Boleto Bancário** — `bank_slip`.
    - `bank_slip_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga por **Boleto Bancário** — `bank_slip`.
    - `credit_card_cents` integer — Valor fixo, em **centavos**, a ser dividido se a fatura for paga por **Cartão de Crédito** — `credit_card`.
    - `credit_card_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga por **Cartão de Crédito** — `credit_card`.
    - `pix_cents` integer — Valor fixo, em **centavos**, a ser dividido se a fatura for paga por **PIX** — `pix`.
    - `pix_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga por **PIX** — `pix`.
    - `credit_card_1x_cents` integer — Valor, **em centavos**, a ser dividido se a fatura for paga em `1x` (à vista) no **Cartão de Crédito**.
    - `credit_card_2x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `2x` no **Cartão de Crédito**.
    - `credit_card_3x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `3x` no **Cartão de Crédito**.
    - `credit_card_4x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `4x` no **Cartão de Crédito**.
    - `credit_card_5x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `5x` no **Cartão de Crédito**.
    - `credit_card_6x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `6x` no **Cartão de Crédito**.
    - `credit_card_7x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `7x` no **Cartão de Crédito**.
    - `credit_card_8x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `8x` no **Cartão de Crédito**.
    - `credit_card_9x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `4x` no **Cartão de Crédito**.
    - `credit_card_10x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `10x` no **Cartão de Crédito**.
    - `credit_card_11x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `11x` no **Cartão de Crédito**.
    - `credit_card_12x_cents` integer — Valor, em **centavos**, a ser dividido se a fatura for paga em `12x` no **Cartão de Crédito**.
    - `credit_card_1x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `1x` (á vista) no **Cartão de Crédito**.
    - `credit_card_2x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `2x` no **Cartão de Crédito**.
    - `credit_card_3x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `3x` no **Cartão de Crédito**.
    - `credit_card_4x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `4x` no **Cartão de Crédito**.
    - `credit_card_5x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `5x` no **Cartão de Crédito**.
    - `credit_card_6x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `6x` no **Cartão de Crédito**.
    - `credit_card_7x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `7x` no **Cartão de Crédito**.
    - `credit_card_8x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `8x` no **Cartão de Crédito**.
    - `credit_card_9x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `9x` no **Cartão de Crédito**.
    - `credit_card_10x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `10x` no **Cartão de Crédito**.
    - `credit_card_11x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `11x` no **Cartão de Crédito**.
    - `credit_card_12x_percent` number, float — Percentual do **valor total** da fatura a ser dividido se for paga em `12x` no **Cartão de Crédito**.
  - `only_on_charge_success` boolean — Apenas Cria a Assinatura se a Cobrança for bem sucedida. Isso só funciona caso o cliente já tenha uma forma de pagamento padrão cadastrada. Não enviar "expires_at".
  - `ignore_due_email` boolean — Desabilita o envio de emails notificando o vencimento de uma fatura em assinaturas que podem ser pagas com boleto bancário
  - `payable_with` string[] — Método de pagamento que será disponibilizado para as Faturas desta Assinatura (all, credit_card, bank_slip ou pix). Obs: Dependendo do valor, este atributo será herdado, pois a prioridade é herdar o valor atribuído ao Plano desta Assinatura; caso este esteja atribuído o valor ‘all’, o sistema considerará o payable_with da Assinatura; se não, o sistema considerará o payable_with do Plano
  - `automatic_pix` object — Ao utilizar o objeto `automatic_pix`, o cliente informado no `customer_id` deve possuir nome e CPF/CNPJ cadastrados, a assinatura não possui o objeto `payer`. Se necessário, atualize o cadastro pelo endpoint [Editar Cliente](https://dev.iugu.com/reference/alterar-cliente).
    - `journey` integer, required — Tipo de jornada: `3` ou `4`. <br> - Jornada 3: QRCode com primeiro pagamento - Cria recorrência junto com a primeira cobrança imediata. <br> - Jornada 4: QRCode de pagamento com proposta de criar recorrência para cobranças imediatas ou futuras.
    - `frequency` string, required — Frequência das cobranças. Deve ser compatível com o intervalo do plano.
    - `recurrence_beginning` string, date, required — Data de início da recorrência (deve ser futura, formato: 'AAAA-MM-DD').
    - `contract_number` string, required — Identificador do contrato/pedido. Máx. 35 caracteres. Alguns PSPs Pagadores podem recusar contratos com o mesmo número já ativos
    - `end_date` string, date — Data de encerramento da recorrência junto ao BACEN (Formato: 'AAAA-MM-DD'). Não encerra a assinatura iugu, os dois precisam ser alinhados pelo lojista
    - `retry_policy` string — Política de retentativa do PIX Automático
  - `credits_based` boolean — É uma assinatura baseada em créditos? booleano
  - `price_cents` integer — Preço em centavos da recarga para assinaturas baseadas em crédito
  - `credits_cycle` integer — Quantidade de créditos adicionados a cada ciclo, só enviado para assinaturas credits_based
  - `credits_min` integer — Quantidade de créditos que ativa o ciclo, por ex: Efetuar cobrança cada vez que a assinatura tenha apenas 1 crédito sobrando. Esse 1 crédito é o credits_min
  - `subitems` object[] — Adiciona itens de cobrança a mais na assinatura do cliente. "price_cents" valor mínimo 100. <b> Limite de 30 subitems </b>
    - `description` string — Descrição do Item
    - `price_cents` integer — Preço em Centavos. Valores negativos entram como desconto no total das Faturas criadas pela Assinatura. "price_cents" valor mínimo 100.
    - `quantity` integer — Quantidade
    - `recurrent` boolean — Item recorrente? booleano
  - `custom_variables` object[] — Variáveis Personalizadas
    - `name` string — Nome da Variável
    - `value` string — Valor da Variável
  - `two_step` boolean — Habilita/Desabilita transações em duas etapas para a assinatura (precisa ter o da conta ativado para usar)
  - `suspend_on_invoice_expired` boolean — Quando uma assinatura tem uma fatura expirada, se esse campo estiver como FALSE, assinatura não será suspensa. (porém é necessário ajustar a data de vencimento para seguir com o ciclo.
  - `only_charge_on_due_date` boolean — Somente efetua a cobrança do primeiro ciclo no dia do vencimento. Por padrão, ao criar uma assinatura e a data atual esteja menor que o billing_days da conta ou do plano, será cobrado.
  - `soft_descriptor_light` string — Altera a descrição da cobrança no cartão de crédito do cliente final (Até 12 caracteres). Caso não seja enviado, será utilizada a descrição configurada na conta.
  - `return_url` string — Cliente é redirecionado para essa URL após efetuar o pagamento da Fatura pela página de Fatura da Iugu.

## Response `200`

200

- object
  - `id` string
  - `suspended` boolean
  - `plan_identifier` string
  - `price_cents` integer
  - `currency` string
  - `features` object
  - `customer_name` string
  - `customer_email` string
  - `cycled_at` string
  - `credits_min` integer
  - `credits_cycle` unknown
  - `payable_with` string[]
  - `ignore_due_email` unknown
  - `max_cycles` integer
  - `cycles_count` integer
  - `recent_invoices` object[]
    - `id` string
    - `due_date` string
    - `status` string
    - `total` string
    - `secure_url` string
  - `subitems` object[]
  - `logs` object[]
    - `id` string
    - `description` string
    - `notes` string
    - `subscription_changes` string
    - `created_at` string
  - `custom_variables` object[]
  - `expires_at` unknown
  - `created_at` string
  - `updated_at` string
  - `customer_id` string
  - `plan_name` string
  - `customer_ref` string
  - `plan_ref` string
  - `active` boolean
  - `two_step` boolean
  - `suspend_on_invoice_expired` boolean
  - `in_trial` unknown
  - `credits` integer
  - `credits_based` boolean

## Other responses

- `404` — 404
- `422` — 422

---

[API](https://skmtc.net/iugu/apis/tokens-de-api.md) · [All operations](https://skmtc.net/iugu/apis/tokens-de-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iugu/tokens-de-api/versions/4590fc729d1e/schema)