PayZu PixTutoriais

Enviar um Pix para uma chave

  1. GET /pix/key consulta a chave no DICT. Mostre os dados do titular antes de confirmar o pagamento.

  2. POST /withdraw com valor em reais, chave e tipo da chave. O IP da chamada precisa estar cadastrado.

  3. 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