Visão geral de assinaturas

​

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

​

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
• Ciclo de vida da assinatura
• Webhooks de assinatura
• Referência API de assinaturas

​

Exemplos executáveis