PayZu PaymentsRecorrência no cartão
Consultar uma recorrência
Leia o estado do contrato pelo recurrentPaymentId e encontre as cobranças de cada ciclo.
Consulte o contrato
bash
curl https://api.sandbox.payzu.dev/v1/charges/recurrences/5f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d \
--cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY" \
-H "Authorization: Bearer SEU_TOKEN"json
{
"recurrentPaymentId": "5f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
"interval": "MONTHLY",
"status": "ACTIVE",
"amount": 10000,
"nextRecurrency": "2026-07-12T00:00:00.000Z",
"endDate": "2027-06-12T00:00:00.000Z"
}Referência: Consultar uma recorrência
| Campo | O que traz |
|---|---|
interval | MONTHLY, ANNUAL ou DAILY. |
status | ACTIVE, INACTIVE ou ENDED. |
nextRecurrency | Data do próximo ciclo. Pode vir nulo. |
Liste os ciclos
As cobranças do contrato ficam em GET /charges, filtrado por recurrentPaymentId.
| Campo | O que traz |
|---|---|
recurrenceCycle | O ciclo a que a cobrança pertence. A primeira é o ciclo 0. |
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZ500 | 404 | Recorrência não encontrada |
Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.