PayZu CâmbioOperações
Criar o saque
O saque envia o USDT à carteira e só é criado se o valor líquido ainda for o da simulação.
Crie o saque
Repita a carteira e o valor e informe em statedNetAmount o net da simulação, com um Idempotency-Key.
bash
curl -X POST https://api.exchange.payzu.com.br/v1/withdrawals \
-H "Authorization: Bearer SUA_CHAVE_DE_API" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 9c2e7b41-3d8a-4f6e-b0a2-5e7d1c9f4b33" \
-d '{
"walletId": "5f0c2a7e9b1d4c38",
"amount": "10000000000",
"statedNetAmount": "9900000000"
}'json
{
"code": "RW-2",
"status": "pending",
"network": "TRC20",
"address": "TSeuEnderecoTRC20xxxxxxxxxxxxxxxxx",
"walletLabel": "Tesouraria",
"amount": "9900000000",
"fee": "100000000",
"createdAt": "2026-11-10T12:05:00.000Z",
"submittedAt": null,
"confirmedAt": null,
"txId": null,
"explorerUrl": null
}Referência: Criar saque
| Campo | O que informa |
|---|---|
code | O código para consultar o saque. |
amount | O valor que chega à carteira. |
fee | A taxa. |
txId e explorerUrl | Preenchidos depois da confirmação; podem ficar null. |
Se a taxa mudou desde a simulação, o saque não é criado.
A resposta é 409 com stated_net_stale. Simule de novo e crie o saque com um Idempotency-Key novo.
Erros do saque
| Código | HTTP | Em details |
|---|---|---|
below_minimum | 400 | minimum |
dust | 400 | fee |
invalid_amount | 400 | - |
account_blocked | 403 | - |
not_found | 404 | - |
over_available | 409 | available |
request_id_reused | 409 | - |
stated_net_stale | 409 | net |
Os demais códigos estão no Catálogo de erros.