PayZu PaymentsRecorrência no cartão
Desativar uma recorrência
Desative um contrato recorrente para que os próximos ciclos não gerem cobrança.
Desative a recorrência
bash
curl -X PUT https://api.sandbox.payzu.dev/v1/charges/recurrences/5f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d/deactivate \
--cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY" \
-H "Authorization: Bearer SEU_TOKEN"json
{
"recurrentPaymentId": "5f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
"interval": "MONTHLY",
"status": "INACTIVE",
"amount": 10000,
"nextRecurrency": "2026-07-12T00:00:00.000Z",
"endDate": "2027-06-12T00:00:00.000Z"
}Referência: Desativar uma recorrência
Enquanto o contrato estiver INACTIVE, a data em nextRecurrency não gera cobrança. Para estornar um ciclo já cobrado, use Estornar uma cobrança.
Não existe troca de cartão no contrato.
Para cobrar em outro cartão, desative este contrato e crie uma recorrência nova com POST /charges, que cobra um novo ciclo 0 na hora.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZ500 | 404 | Recorrência não encontrada |
PZ503 | 422 | Recorrência já encerrada |
PZ505 | 422 | Cobrança inicial da recorrência não encontrada |
PZ900 | 422 | O provedor de pagamento recusou a operação |
PZ901 | 503 | Não foi possível estabelecer comunicação com o provedor de pagamento. Tente novamente em instantes. |
Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.