Assinaturas

Atributos	Tipo	Descrição
`id`	string	Código da assinatura. Formato: `sub_XXXXXXXXXXXXXXXX`.
`payment_method`	string	Meio de pagamento. Valores possíveis: `credit_card`, `boleto`, `cash` ou `debit_card`.
`currency`	string	Moeda. Valor possível: `BRL`.
`start_at`	datetime	Data de início da assinatura. Observação: Por padrão, os ciclos se iniciam as 00:00:00, por isso, apenas a data deve ser levada em consideração na response.
`interval`	string	Intervalo da recorrência. Valores possíveis: `day`, `week`, `month` ou `year`.
`interval_count`	string	Repetições do intervalo da recorrência. Ex: plano mensal = interval_count (1) e interval (month); plano trimestral = interval_count (3) e interval (month); plano semestral = interval_count (6) e interval (month).
`billing_type`	string	Tipo de cobrança. Valores possíveis: `prepaid`, `postpaid` ou `exact_day`.
`billing_day`	integer	Dia da cobrança. Obrigatório, caso o `billing_type` seja `exact_day`.
`current_cycle`	object	Período atual da assinatura.
`next_billing_at`	datetime	Data da próxima cobrança.
`installments`	integer	Quantidade de parcelas. Será aplicada caso o método de pagamento da assinatura seja cartão de crédito .
`statement_descriptor`	integer	Texto exibido na fatura do cartão.
`customer`	object	Dados do cliente. Saiba mais sobre clientes.
`card`	object	Dados do cartão de crédito. Saiba mais sobre cartões.
`plan`	object	Dados do plano. Saiba mais sobre planos.
`discounts`	array of objects	Descontos.
`increments`	array of objects	Incrementos.
`minimum_price`	integer	Valor mínimo, em centavos, da assinatura.
`items`	array of objects	Itens da assinatura. Saiba mais sobre itens da assinatura.
`status`	string	Status da assinatura. Valores possíveis: `active`, `canceled` ou `future`.
`created_at`	datetime	Data de criação da assinatura (UTC).
`updated_at`	datetime	Data de atualização da assinatura (UTC).
`canceled_at`	datetime	Data de cancelamento da assinatura (UTC).
`metadata`	object	Objeto chave/valor utilizado para armazenar informações adicionais sobre o assinatura. Saiba mais sobre metadata.
`split`	object	Split na assinatura. Saiba mais sobre split na recorrência.

🚧
Formas de Pagamento de Assinaturas
Podemos criar uma assinatura com os dois meios de pagamento distintos: credit_card ou boleto. Caso utilize credit_card será necessário o envio do card dentro da requisição juntamente do payment_method. Já no caso do boleto somente será necessário o payment_method.

🚧
Assinaturas e o Staus Chargeback
A partir do dia 12 de setembro, o status chargedback será acrescentado à API do Pagar.me como um novo status de cobrança.
Saiba mais sobre o fluxo de Assinaturas com cobranças em status Chargeback.
Quando uma charge de uma assinatura sofre chargeback, essa assinatura será cancelada de forma automática.