PayZu PixConta e relatórios

Baixar o comprovante


Nesta páginaPix recebidoPix enviadoErros desta operação

Entregue ao cliente ou arquive o PDF de cada transação processada.

typeResposta
Ausente ou pdfO arquivo, com Content-Type: application/pdf.
base64Um 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.

bash
# 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"

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.

bash
curl "https://pix.sandbox.payzu.dev/v1/withdraw/proof/PAYZU20260817B3PL8SG5WQ000000?type=base64" \
  -H "Authorization: Bearer SEU_TOKEN"

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ódigoHTTPMensagem
PZG404404Transação não encontrada
PZC320422Transação ainda não processada.
PZC321422Comprovante indisponível: transação cancelada sem documento.

Os códigos de autenticação e de validação estão no Catálogo de erros.