Visão geral de assinaturas - Pagou Developer Docs

Use assinaturas quando precisar cobrar o mesmo cliente em uma cadência recorrente. Há dois meios de pagamento:

	Cartão	Pix Automático
Como o cliente paga	cartão coletado com Payment Element	autoriza uma vez pelo QR code no app do banco
Quem inicia cada cobrança	a Pagou	o banco do pagador
`payment_method`	`credit_card` (padrão)	`pix_automatic`
Guia	Criar assinatura	Assinaturas com Pix Automático

Como funciona com cartão

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.

Crie o cliente com POST /v2/customers, informando CPF ou CNPJ.
Crie a assinatura com POST /v2/subscriptions e payment_method: "pix_automatic".
Mostre o QR code retornado ao pagador, que autoriza o débito recorrente no app do banco.
Escute webhooks de assinatura para a autorização, cada débito, falhas e cancelamento.

Superfície	Use para
`/v2/customers`	cliente usado pela assinatura
Payment Element	coleta segura do cartão e tokenização `pgct_`, nas assinaturas com cartão
`/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

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.
Troque o plano de uma assinatura com cartão com PATCH /v2/subscriptions/{id}; crie uma nova assinatura apenas para mudar a moeda ou o cartão. Assinaturas com Pix Automático não trocam de plano.

Veja código pronto e testável para o fluxo com cartão em Exemplos de Assinaturas — executável em sete linguagens no sandbox.