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) einterval (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_. O número de parcelas deverá ser 1 em recorrências.
`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 Status Chargeback
Quando uma charge de uma assinatura sofre chargeback, essa assinatura será cancelada de forma automática.
Saiba mais sobre o fluxo de Assinaturas com cobranças em status Chargeback.

Atenção:
Para clientes PSP, desde 12/09/2022, sempre que uma charge sofre uma ação de chargeback, a nossa API modifica o estado da charge para chargedback.
E com intuito de aumentar a visibilidade sobre as suas transações, a partir de 27 de julho de 2026 o status chargedback também passará a ser retornado para clientes Gateway, exclusivamente para cobranças capturadas pela adquirência Stone.
Para mais informações acesse: Novo status chargeback