PayZu Conta HubTutoriais

Fazer um saque para uma chave Pix

  1. client_id e client_secret em Basic, com grant_type client_credentials.

  2. O valor chega inteiro ao destino e a tarifa é somada por cima. Em retentativas, repita a mesma Idempotency-Key.

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