Cobranças
Consultar Cobrança
Consulta uma cobrança específica e devolve a situação atual dela junto com todos os detalhes.
Autorização
BearerAuth MutualTLS AutorizaçãoBearer <token>
Token JWT obtido em POST /token
Em: header
Parâmetros de path
chargeId*string
Id da cobrança
Corpo da resposta
application/json
curl --request GET \ --url 'https://api.payzu.io/v1/charges/9b1e7c34-5a2d-4f8b-8c1a-2e3f4a5b6c7d' \ --header 'Authorization: Bearer $PAYZU_TOKEN' \ --cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY"// A API PayZu Cartao exige certificado mTLS do cliente em todas as rotas.const url = 'https://api.payzu.io/v1/charges/9b1e7c34-5a2d-4f8b-8c1a-2e3f4a5b6c7d';const response = await fetch(url, { method: 'GET', headers: { Authorization: `Bearer ${process.env.PAYZU_TOKEN}`, },});const data = await response.json();console.log(data);import osimport requestsresponse = requests.get( 'https://api.payzu.io/v1/charges/9b1e7c34-5a2d-4f8b-8c1a-2e3f4a5b6c7d', headers={ 'Authorization': f'Bearer {os.environ["PAYZU_TOKEN"]}', }, cert=(os.environ['PAYZU_CLIENT_CERT'], os.environ['PAYZU_CLIENT_KEY']),)print(response.json())200
{
"id": "e3b7a1f2-8c4d-4a09-9f1e-2b6c8d5a7e90",
"externalId": "pedido-1234",
"postbackUrl": "https://seusite.com.br/webhooks/payzu",
"amount": 10000,
"paymentType": "creditcard",
"createdAt": "2026-06-12T14:35:22.000Z",
"updatedAt": "2026-06-12T14:35:24.000Z",
"id": 501,
"name": "Maria Souza",
"identity": "11144477735",
"identityType": "CPF",
"email": "maria.souza@example.com",
"birthdate": "1990-04-15",
"phone": "11999998888",
},
],
"installments": 1,
"authenticate": false,
"currency": "BRL",
"acquirerTransactionId": "1049329871283a5d2b8e",
"authorizationCode": "128734",
"reasonCode": 0,
"reasonMessage": "Successful",
"status": 2,
"returnCode": "6",
"returnMessage": "Operação realizada com sucesso",
"externalAuthentication": {},
"reversedAmount": null,
"reversedDate": null,
"chargeId": "e3b7a1f2-8c4d-4a09-9f1e-2b6c8d5a7e90",
"chargebacks": []
}
}