PayZu PaymentsRecorrência no cartão
Alterar o valor
Mude o valor dos próximos ciclos de um contrato recorrente pelo recurrentPaymentId que veio na criação.
Altere o valor
Envie o novo amount, em centavos inteiros, a partir de 100.
bash
curl -X PUT https://api.sandbox.payzu.dev/v1/charges/recurrences/5f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d/amount \
--cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "amount": 12000 }'json
{
"recurrentPaymentId": "5f1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
"interval": "MONTHLY",
"status": "ACTIVE",
"amount": 12000,
"nextRecurrency": "2026-07-12T00:00:00.000Z",
"endDate": "2027-06-12T00:00:00.000Z"
}Referência: Alterar o valor de uma recorrência
O novo valor passa a valer nas cobranças a partir de nextRecurrency.
As cobranças já feitas mantêm o valor que tinham.
Para parar ou retomar as cobranças, veja Desativar uma recorrência e Reativar uma recorrência.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZ500 | 404 | Recorrência não encontrada |
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.