Ciclo de vida da assinatura - Pagou Developer Docs

Use o status da assinatura para decidir acesso do cliente e ações operacionais.

Status

Status	Significado	Ação recomendada
`incomplete`	primeira cobrança ou validação não terminou	aguarde recuperação ou reconcilie
`trialing`	período de teste ativo	libere acesso de teste até `trial_end`
`active`	cobrança em dia	mantenha o acesso ativo
`past_due`	renovação falhou e há política de retentativa	avise o cliente e aguarde retentativa ou cancelamento
`cancel_scheduled`	cancelamento agendado para o fim do período	mantenha acesso até `current_period_end`
`canceled`	assinatura encerrada	interrompa acesso futuro e cobrança

Renovações

A Pagou renova assinaturas active e trialing quando o período de cobrança termina. Renovações bem-sucedidas emitem subscription.started após um teste ou subscription.renewed nos ciclos seguintes.

Pagamentos com falha

failure_policy controla o que acontece depois de uma renovação com falha:

retry_then_cancel: passa pelas retentativas antes do cancelamento.
immediate_cancel: cancela quando a renovação não puder ser cobrada.

Use retry_offsets_days apenas quando precisar definir intervalos explícitos de retentativa.

Cancelamento

POST /v2/subscriptions/{id}/cancel agenda o cancelamento para o fim do período atual. A assinatura fica cancel_scheduled imediatamente e depois muda para canceled.

Leia a seguir