PayZu Conta HubTutoriais
Fazer um saque para uma chave Pix
client_id e client_secret em Basic, com grant_type client_credentials.
O valor chega inteiro ao destino e a tarifa é somada por cima. Em retentativas, repita a mesma Idempotency-Key.
A confirmação vem pelo webhook WITHDRAW_COMPLETED. Se precisar, consulte pelo id.
withdraw-to-pix-key.sh
# 1. Token da contacurl --request POST \ --url https://api.sandbox.payzu.dev/api/v1/oauth/token \ --user 'CLIENT_ID:CLIENT_SECRET' \ --header 'content-type: application/json' \ --data '{"grant_type": "client_credentials"}' # 2. Saque de R$ 100,00 (valores em centavos)curl --request POST \ --url https://api.sandbox.payzu.dev/api/v1/transactions/withdraw \ --header 'authorization: Bearer SEU_TOKEN' \ --header 'Idempotency-Key: 5f0c1d2e-8a7b-4c3d-9e1f-2a3b4c5d6e7f' \ --header 'content-type: application/json' \ --data '{"amount": 10000, "pixKey": "fulano@exemplo.com", "pixKeyType": "EMAIL", "comment": "Repasse semanal"}' # 3. Consulte o saquecurl --request GET \ --url https://api.sandbox.payzu.dev/api/v1/transactions/withdraw/WITHDRAW_ID \ --header 'authorization: Bearer SEU_TOKEN'
Resposta · 201 Saque criado
{ "id": "P20261005114011R4D8TN2WQZC127431", "status": "PROCESSING", "amount": 10000, "serviceFee": 250, "totalDebited": 10250, "pixKey": "fulano@exemplo.com", "bank": { "name": "Banco Exemplo S.A.", "ispb": "99999999" }, "comment": "Repasse semanal", "endToEndId": null, "failureReason": null, "callbackUrl": null, "createdAt": "2026-10-05T14:40:11.002Z", "confirmedAt": null}
Referência: Enviar um Pix para uma chave