PayZu PaymentsCobranças
Listar cobranças
Liste as cobranças de um período para conciliar as vendas ou achar uma cobrança cuja resposta se perdeu.
Liste as cobranças
- Período:
startDateeendDatefiltram pela data de criação e comparam instantes. Entram as cobranças criadas a partir destartDatee atéendDate, inclusive. - Paginação: avance
page, a partir de1(padrão1), atétotalPages.limitvai de1a100, com padrão10. - Pix: as cobranças Pix entram na mesma lista, com
paymentTypeigual apix.
bash
curl --request GET \
--url 'https://api.sandbox.payzu.dev/v1/charges?startDate=2026-06-01T00:00:00-03:00&endDate=2026-06-30T23:59:59.999-03:00&limit=10&page=1' \
--header "Authorization: Bearer $PAYZU_TOKEN" \
--cert "$PAYZU_CLIENT_CERT" --key "$PAYZU_CLIENT_KEY"json
{
"page": 1,
"total": 1,
"totalPages": 1,
"charges": [
{
"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: Listar as cobranças
Uma data sem hora vale 00:00 em UTC.
Com endDate=2026-06-30, quase todo o dia 30 fica de fora. Mande o instante completo, com o fuso.
Não há filtro por externalId.
Para achar um pedido, liste o período em que a cobrança foi criada, com endDate no instante atual quando ela pode ser de hoje, e compare externalId nos itens de charges.
Para ler uma cobrança pelo id, veja Consultar uma cobrança. Os erros de autenticação e de validação e os demais códigos estão no Catálogo de erros.