PayZu Conta HubCobrar com Pix
Consultar um depósito
Consulte o depósito pelo depositId do aviso para ver quem pagou e quanto ainda pode voltar ao pagador.
Consulte pelo depositId
bash
curl --url 'https://api.sandbox.payzu.dev/api/v1/transactions/deposit/cmu4a1b2c000001s6xyz98765' \
--header 'Authorization: Bearer SEU_TOKEN'json
{
"id": "cmu4a1b2c000001s6xyz98765",
"blockedAmount": 0,
"blockedAt": null,
"releasedAt": null,
"method": "PIX",
"amount": 5000,
"serviceFee": 50,
"netAmount": 4950,
"endToEndId": "E99999999202610051433a1b2c3d4e5f",
"receiverPixKey": "b3c7e9a2-4f1d-4c8a-9e2b-7d5f6a8c1e03",
"payer": {
"name": "João Pereira",
"document": "***.456.789-**",
"bank": { "name": "Banco Exemplo S.A.", "ispb": "99999999" }
},
"paidAt": "2026-10-05T16:10:02.551Z",
"createdAt": "2026-10-05T16:10:03.120Z",
"refundedAmount": 0,
"refundInProgressAmount": 0,
"refundableAmount": 5000,
"openInfractionProtocol": null,
"refunds": []
}Referência: Consultar um depósito
payer: quem pagou.receiverPixKey: a chave da sua conta que recebeu o Pix.refundableAmount: o máximo que ainda pode voltar ao pagador. Fica0enquantoblockedAmountmostrar valor retido por controle de depósito, e sempre na TED.endToEndId: o mesmo da entrada no extrato, como em Saldo e extrato. Na TED, commethodigual aTED, vemnull, porque ela não tem end-to-end.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
DEPOSIT_NOT_FOUND | 404 | Depósito não encontrado. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.