PayZu GatewayRecorrência

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.

PixCartão
ComeçaNo vencimento da fatura sem pagamento.Na primeira recusa da cobrança do ciclo.
grace.started_atO billing.due_at da fatura.A data da recusa.
billing.renewal_failuresNã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_at traz o billing.expires_at da fatura do ciclo.
  • Pagamento: a fatura segue pending. O cliente paga pela url dela, 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

DesfechoFatura do cicloAssinaturaEventos
Paga até billing.expires_atpaidSegue active, com grace nulo e billing.renewal_failures em 0.invoice.paid e subscription.renewed
Sem pagamento até billing.expires_atexpiredcanceled, 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_at no billing.expires_at dela.
  • Ciclo seguinte pago: se um ciclo posterior já foi pago, a fatura vencida passa a expired e a assinatura segue active.
  • Faturas em aberto: no cancelamento, as outras faturas pending da assinatura sem pagamento confirmado passam a canceled, sem invoice.canceled.
  • Assinatura cancelada: segue mostrando o grace e o billing.renewal_failures do 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 paid e a assinatura de volta a active, com subscription.reactivated. Na assinatura no cartão, a fatura vai a paid e a assinatura segue canceled.