Recorrências
Alterar valor da Recorrência
Muda quanto o cliente vai pagar nos próximos ciclos da assinatura, sem mexer no que já foi cobrado.
Autorização
BearerAuth MutualTLS AutorizaçãoBearer <token>
Token JWT obtido em POST /token
Em: header
Parâmetros de path
recurrentPaymentId*string
Id da recorrência
Corpo da requisição
application/json
Definições TypeScript
Use o tipo request body no TypeScript.
amount*number
Novo valor de cada ciclo, em centavos
Corpo da resposta
application/json
curl --request PUT \ --url 'https://api.payzu.io/v1/charges/recurrences/3f5a1b2c-9d8e-4c7b-a6f5-1e2d3c4b5a69/amount' \ --header 'Authorization: Bearer $PAYZU_TOKEN' \ --cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY" \ --header 'Content-Type: application/json' \ --data '{ "amount": 12000}'// A API PayZu Cartao exige certificado mTLS do cliente em todas as rotas.const url = 'https://api.payzu.io/v1/charges/recurrences/3f5a1b2c-9d8e-4c7b-a6f5-1e2d3c4b5a69/amount';const response = await fetch(url, { method: 'PUT', headers: { Authorization: `Bearer ${process.env.PAYZU_TOKEN}`, 'Content-Type': 'application/json', }, body: JSON.stringify({ amount: 12000 }),});const data = await response.json();console.log(data);import osimport requestsresponse = requests.put( 'https://api.payzu.io/v1/charges/recurrences/3f5a1b2c-9d8e-4c7b-a6f5-1e2d3c4b5a69/amount', headers={ 'Authorization': f'Bearer {os.environ["PAYZU_TOKEN"]}', 'Content-Type': 'application/json', }, json={ 'amount': 12000 }, cert=(os.environ['PAYZU_CLIENT_CERT'], os.environ['PAYZU_CLIENT_KEY']),)print(response.json())200
{
"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"
}