PayZu PaymentsCobranças
Consultar uma cobrança
Leia o estado atual de uma cobrança pelo id retornado na criação, um UUID.
Consulte a cobrança
bash
curl --request GET \
--url 'https://api.sandbox.payzu.dev/v1/charges/e3b7a1f2-8c4d-4a09-9f1e-2b6c8d5a7e90' \
--header "Authorization: Bearer $PAYZU_TOKEN" \
--cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY"json
{
"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",
"customer": {
"name": "Maria Souza",
"identity": "11144477735",
"identityType": "CPF",
"email": "maria.souza@example.com",
"birthdate": "1990-04-15",
"phone": "5511999998888",
"address": {
"street": "Avenida Paulista",
"number": "1000",
"zipCode": "01310100",
"city": "São Paulo",
"state": "SP",
"country": "BR",
"district": "Bela Vista",
"complement": "Conjunto 101"
}
},
"cart": [
{ "name": "Plano Pro", "quantity": 1, "sku": "PRO", "unitPrice": 10000 }
],
"creditCardPayment": {
"installments": 1,
"authenticate": false,
"currency": "BRL",
"acquirerTransactionId": "1049329871283a5d2b8e",
"authorizationCode": "128734",
"reasonCode": 0,
"status": 2,
"reversedAmount": null,
"reversedDate": null,
"card": {
"number": "411111******1111",
"holder": "MARIA SOUZA",
"expiration": "12/2030",
"brand": "Visa"
},
"chargebacks": []
},
"pixPayment": null
}Referência: Consultar uma cobrança
| Campo | O que mostra |
|---|---|
creditCardPayment.status | O estado atual. Decida por ele, com os valores de Status da transação. |
reversedAmount e reversedDate | Preenchidos depois de um estorno ou de um chargeback acatado. |
creditCardPayment.chargebacks | Os chargebacks da cobrança. |
A consulta não traz reasonMessage, returnCode, returnMessage nem externalAuthentication.
Esses campos só vêm na resposta do POST /charges, então guarde-os na criação.
Não consulte em laço curto no lugar do aviso.
A consulta serve para conferência. Informe postbackUrl na criação: a PayZu envia o aviso charge.update com a cobrança a cada mudança depois da criação. Veja Webhooks.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZ100 | 404 | Cobrança não encontrada |
Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.