> ## 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.

# Ciclo de vida da assinatura

> Mapeie status de assinatura para cobrança, acesso, retentativas e cancelamento.

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

* [Webhooks de assinatura](/pt/subscriptions/webhooks)
* [API: Atualizar assinatura](/pt/api-reference/subscriptions/update)
* [API: Cancelar assinatura](/pt/api-reference/subscriptions/cancel)