Use o status da assinatura para decidir acesso do cliente e ações operacionais.Documentation Index
Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
Use this file to discover all available pages before exploring further.
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 assinaturasactive 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.
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.