PayZu PixTutoriais
Enviar um Pix para uma chave
GET /pix/key consulta a chave no DICT. Mostre os dados do titular antes de confirmar o pagamento.
POST /withdraw com valor em reais, chave e tipo da chave. O IP da chamada precisa estar cadastrado.
Consulte pelo clientReference ou espere o webhook com o resultado.
send-pix-to-key.sh
# 1. Confira o titular da chavecurl --request GET \ --url 'https://pix.sandbox.payzu.dev/v1/pix/key?pixKey=fulano@exemplo.com' \ --header 'authorization: Bearer SEU_TOKEN' # 2. Envie o Pixcurl --request POST \ --url https://pix.sandbox.payzu.dev/v1/withdraw \ --header 'authorization: Bearer SEU_TOKEN' \ --header 'content-type: application/json' \ --data '{"amount": 150, "pixKey": "fulano@exemplo.com", "pixType": "email", "clientReference": "repasse-0042"}' # 3. Acompanhe pelo clientReferencecurl --request GET \ --url 'https://pix.sandbox.payzu.dev/v1/withdraw?clientReference=repasse-0042' \ --header 'authorization: Bearer SEU_TOKEN'
Resposta · 200 Saque criado
{ "id": "PAYZU20260817B3PL8SG5WQ000000", "status": "PENDING", "amount": 2, "type": "WITHDRAW", "qrCodeText": null, "qrCodeBase64": null, "qrCodeUrl": null, "generatedName": null, "generatedDocument": null, "generatedEmail": null, "payerName": null, "payerDocument": null, "payerInstitutionIspb": null, "payerInstitutionName": null, "payerAccountNumber": "000000", "serviceFeeCharged": 1, "withdrawPixKey": "teste@teste.com", "withdrawPixType": "email", "receiverName": null, "receiverDocument": null, "receiverInstitutionIspb": null, "receiverInstitutionName": null, "receiverAccountNumber": null, "endToEndId": null, "createdAt": "2026-08-11T21:51:29.748Z", "updatedAt": "2026-08-11T21:51:29.748Z", "paidAt": null, "clientReference": "withdraw_98765", "refundEndToEndId": null, "refundAmount": null, "refundStatus": null, "refundReason": null, "refundDescription": null, "refundedAt": null, "cancellationReason": null}
Referência: Enviar um Pix para uma chave