Use assinaturas quando precisar cobrar o mesmo cliente em uma cadência recorrente.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.
Como funciona
- Crie o cliente com
POST /v2/customers. - Colete o cartão com Payment Element em
mode: "subscription". - Envie o token
pgct_de uso único para o seu back-end. - Crie a assinatura com
POST /v2/subscriptions. - 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
idda assinatura, oiddo cliente e oidda ú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.