Carência
Quando a renovação não é paga, a assinatura segue active durante a carência, e o cliente ainda pode pagar a fatura do ciclo.
O prazo
A carência termina no billing.expires_at da fatura do ciclo, que é o billing.due_at dela mais os dias de grace_days da conta. O grace_days vai de 0 a 30 e fica em 7 enquanto você não altera.
| Pix | Cartão | |
|---|---|---|
| Começa | No vencimento da fatura sem pagamento. | Na primeira recusa da cobrança do ciclo. |
grace.started_at | O billing.due_at da fatura. | A data da recusa. |
billing.renewal_failures | Não muda. | Soma 1 a cada recusa seguida da cobrança do ciclo. |
- Evento: quando a carência começa, sai
subscription.grace_started. - Fim:
grace.ends_attraz obilling.expires_atda fatura do ciclo. - Pagamento: a fatura segue
pending. O cliente paga pelaurldela, ou você faz uma nova tentativa com Pagar uma fatura.
Na assinatura no cartão, a cobrança sem desfecho segura a fatura do ciclo por até 48 horas.
Enquanto a tentativa do ciclo está processing, a carência não começa. Se o billing.expires_at passa com ela ainda sem desfecho, a fatura segue pending e a assinatura active por até 48 horas da tentativa, e uma nova tentativa de pagamento é recusada. A aprovação nesse prazo renova a assinatura, e a recusa ou o fim das 48 horas expira a fatura e cancela a assinatura.
O fim da carência
| Desfecho | Fatura do ciclo | Assinatura | Eventos |
|---|---|---|---|
Paga até billing.expires_at | paid | Segue active, com grace nulo e billing.renewal_failures em 0. | invoice.paid e subscription.renewed |
Sem pagamento até billing.expires_at | expired | canceled, com cancellation.reason igual a renewal_failure. | invoice.expired e subscription.canceled |
- Outra fatura vencida: se outra fatura de ciclo da assinatura segue vencida e em aberto, a carência continua, com
grace.ends_atnobilling.expires_atdela. - Ciclo seguinte pago: se um ciclo posterior já foi pago, a fatura vencida passa a
expirede a assinatura segueactive. - Faturas em aberto: no cancelamento, as outras faturas
pendingda assinatura sem pagamento confirmado passam acanceled, seminvoice.canceled. - Assinatura cancelada: segue mostrando o
gracee obilling.renewal_failuresdo fim da carência. A reativação zera os dois. - Pagamento depois do fim: na assinatura no Pix, o pagamento confirmado da fatura vencida leva a fatura a
paide a assinatura de volta aactive, comsubscription.reactivated. Na assinatura no cartão, a fatura vai apaide a assinatura seguecanceled.