PayZu Conta HubCobrar com Pix
Consultar uma cobrança
Consulte a cobrança pelo id, que é o mesmo paymentId dos webhooks, para conciliar ou quando um aviso não chegar.
Consulte pelo id
bash
curl --url 'https://api.sandbox.payzu.dev/api/v1/transactions/payment/P20261005113205K7Q2M9XB4TC127431' \
--header 'Authorization: Bearer SEU_TOKEN'json
{
"id": "P20261005113205K7Q2M9XB4TC127431",
"method": "PIX",
"status": "PAID",
"amount": 1500,
"description": "Pedido 4821",
"serviceFee": 105,
"netAmount": 1395,
"refundedAmount": 0,
"refundFee": 0,
"refundInProgressAmount": 0,
"refundableAmount": 1500,
"openInfractionProtocol": null,
"externalRef": "pedido-4821",
"callbackUrl": null,
"createdAt": "2026-10-05T14:32:05.123Z",
"paidAt": "2026-10-05T14:33:10.004Z",
"refundedAt": null,
"pix": {
"qrCodeText": "00020126580014br.gov.bcb.pix0136b3c7e9a2-4f1d-4c8a-9e2b-7d5f6a8c1e03520400005303986540515.005802BR5912LOJA EXEMPLO6009SAO PAULO62070503***63041EC4",
"endToEndId": "E99999999202610051433a1b2c3d4e5f"
},
"customer": {
"name": "Maria Souza",
"document": "52998224725",
"email": "maria.souza@exemplo.com",
"phone": "+5511999998888"
},
"payer": {
"name": "Maria Souza",
"document": "***.982.247-**",
"bank": { "name": "Banco Exemplo S.A.", "ispb": "99999999" }
},
"refunds": []
}Referência: Consultar uma cobrança e Listar as cobranças
payer: quem pagou, preenchido depois do pagamento.pix.endToEndId: o end-to-end do Pix. Guarde-o com o pagador para a conciliação.refundableAmount: o máximo que ainda pode ser devolvido.refunds: as tentativas de devolução da cobrança.
Para achar uma cobrança pelo seu identificador, use Listar as cobranças com externalRef.
Na dúvida entre o aviso e a consulta, vale o status da consulta.
A cobrança passa a REFUNDED quando as devoluções concluídas, somadas ao que um MED procedente devolveu ao pagador, chegam ao valor dela, ou quando o banco parceiro devolve o recebimento por conta própria. Nesse segundo caso chega PAYMENT_REFUNDED, e o valor cheio sai da conta.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PAYMENT_INVALID_CURSOR | 400 | Cursor de paginação inválido — recomece da primeira página. |
PAYMENT_NOT_FOUND | 404 | Pagamento não encontrado. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.