Recorrências
Assinaturas no cartão: a primeira cobrança sai na hora e os ciclos seguintes rodam sozinhos, e aqui você ajusta o valor, pausa ou reativa a cobrança automática.
Uma recorrência é uma assinatura: a primeira cobrança é criada na hora e os ciclos seguintes são cobrados automaticamente no cartão, sem nova chamada à API. A recorrência nasce no POST /charges com o nó recurrence; os endpoints abaixo consultam e gerenciam a assinatura já criada.
Recorrência é sempre à vista: o campo installments precisa ser 1. Valores maiores são rejeitados.
Status da recorrência
| Status | Significado |
|---|---|
ACTIVE | Ativa, gerando os ciclos no intervalo configurado. |
INACTIVE | Desativada (manualmente ou pelo emissor). Não gera novos ciclos. |
ENDED | Encerrada por ter atingido a endDate. |
Listar os ciclos de uma assinatura
Para listar a cobrança inicial e todos os ciclos já gerados, use o GET /charges com o filtro recurrentPaymentId:
curl "https://api.payzu.io/v1/charges?recurrentPaymentId={recurrentPaymentId}" \
-H "Authorization: Bearer $TOKEN" \
--cert cliente.crt \
--key cliente.key \
--cacert ca.pemCada ciclo vira uma cobrança vinculada à recorrência, numerada por recurrenceCycle (0 = inicial, 1..n = ciclos).
O guia completo de criação, ciclos e postbacks está em Pagamentos Recorrentes.