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

# Visão geral de assinaturas

> Crie cobranças recorrentes com clientes, tokens do Payment Element, renovações, retentativas e webhooks de assinatura.

Use assinaturas quando precisar cobrar o mesmo cliente em uma cadência recorrente.

## Como funciona

1. Crie o cliente com `POST /v2/customers`.
2. Colete o cartão com Payment Element em `mode: "subscription"`.
3. Envie o token `pgct_` de uso único para o seu back-end.
4. Crie a assinatura com `POST /v2/subscriptions`.
5. Escute webhooks de assinatura para renovações, falhas, atualizações e cancelamento.

## Superfícies principais

| Superfície             | Use para                                                               |
| ---------------------- | ---------------------------------------------------------------------- |
| `/v2/customers`        | cliente usado pela assinatura                                          |
| Payment Element        | coleta segura do cartão e tokenização `pgct_`                          |
| `/v2/subscriptions`    | criar, listar, consultar, atualizar e cancelar assinaturas             |
| Webhooks de assinatura | eventos de ciclo de vida como criação, renovação, falha e cancelamento |

## Regras operacionais

* Crie assinaturas apenas pelo seu back-end.
* Armazene o `id` da assinatura, o `id` do cliente e o `id` da última transação.
* Use webhooks como fonte normal de verdade para mudanças de ciclo de vida.
* Reconcilie com `GET /v2/subscriptions/{id}` quando uma renovação ou cancelamento ficar incerto.
* Crie uma nova assinatura para alterar campos imutáveis como valor, moeda, intervalo ou cartão.

## Leia a seguir

* [Criar assinatura](/pt/subscriptions/create)
* [Ciclo de vida da assinatura](/pt/subscriptions/lifecycle)
* [Webhooks de assinatura](/pt/subscriptions/webhooks)
* [Referência API de assinaturas](/pt/api-reference/subscriptions/reference)