Baixar o comprovante
Entregue ao cliente ou arquive o PDF de cada transação processada.
type | Resposta |
|---|---|
Ausente ou pdf | O arquivo, com Content-Type: application/pdf. |
base64 | Um JSON com o campo base64, já com o prefixo data:application/pdf;base64,. |
Pix recebido
O id é o da transação retornado por POST /pix.
# PDF, o padrão
curl "https://pix.sandbox.payzu.dev/v1/proof/PAYZU20260814T6NX1CV9MK000000?type=pdf" \
-H "Authorization: Bearer SEU_TOKEN" \
--output comprovante.pdf
# JSON com o PDF em base64
curl "https://pix.sandbox.payzu.dev/v1/proof/PAYZU20260814T6NX1CV9MK000000?type=base64" \
-H "Authorization: Bearer SEU_TOKEN"{
"base64": "data:application/pdf;base64,JVBERi0xLjQKJ..."
}Referência: Baixar o comprovante de uma transação
Pix enviado
O id é o do saque retornado por POST /withdraw. GET /proof/{id} também atende saques e retorna o mesmo comprovante.
curl "https://pix.sandbox.payzu.dev/v1/withdraw/proof/PAYZU20260817B3PL8SG5WQ000000?type=base64" \
-H "Authorization: Bearer SEU_TOKEN"{
"base64": "data:application/pdf;base64,JVBERi0xLjQKJ..."
}Referência: Baixar o comprovante de um saque
O comprovante só sai para transação processada.
Transação PENDING responde 422 com PZC320; transação CANCELED sem os dados da contraparte responde 422 com PZC321. Sair de PENDING é necessário, mas não basta: o saque CANCELED sem os dados da contraparte continua sem comprovante.
Guarde o PDF do pagamento original se precisar dele.
Depois de uma devolução total (REFUNDED), o comprovante passa a trazer o endToEndId da devolução.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZG404 | 404 | Transação não encontrada |
PZC320 | 422 | Transação ainda não processada. |
PZC321 | 422 | Comprovante indisponível: transação cancelada sem documento. |
Os códigos de autenticação e de validação estão no Catálogo de erros.