PayZu PixPagar com Pix
Consultar um envio
Confira o status de um Pix enviado ou recupere o resultado de um callback que não chegou.
Consulte o saque
Busque por id, clientReference, endToEndId ou virtualAccount; se informar mais de um, todos valem ao mesmo tempo. A rota atende o saque por chave e o pagamento de QR Code.
bash
curl "https://pix.sandbox.payzu.dev/v1/withdraw?id=PAYZU20260817B3PL8SG5WQ000000" \
-H "Authorization: Bearer SEU_TOKEN"json
{
"id": "PAYZU20260817B3PL8SG5WQ000000",
"status": "COMPLETED",
"amount": 20,
"type": "WITHDRAW",
"qrCodeText": null,
"qrCodeBase64": null,
"qrCodeUrl": null,
"generatedName": null,
"generatedDocument": null,
"generatedEmail": null,
"serviceFeeCharged": 1,
"payerName": "PayZu Pagamentos Ltda",
"payerDocument": "12.345.678/0001-00",
"payerInstitutionIspb": "23066240",
"payerInstitutionName": "PAYZU IP LTDA.",
"payerAccountNumber": "000000",
"withdrawPixKey": "teste@teste.com",
"withdrawPixType": "email",
"receiverName": "Maria Santos",
"receiverDocument": "12345678901",
"receiverInstitutionIspb": "87654321",
"receiverInstitutionName": "Banco Y",
"receiverAccountNumber": null,
"endToEndId": "E2306624020251217134500X98765432",
"createdAt": "2026-08-11T21:51:29.748Z",
"updatedAt": "2026-08-11T21:52:15.123Z",
"paidAt": "2026-08-11T21:52:15.123Z",
"clientReference": "withdraw_98765",
"refundEndToEndId": null,
"refundAmount": null,
"refundStatus": null,
"refundReason": null,
"refundDescription": null,
"refundedAt": null,
"cancellationReason": null
}Referência: Consultar o status de um saque
Não use a consulta como polling.
Acompanhe o saque pelo callbackUrl ou por um webhook e consulte só para conferir um caso específico. O que cada status final traz está em Confirme o envio.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZG404 | 404 | Transação não encontrada |
Os códigos de autenticação e de validação estão no Catálogo de erros.