Referencias
Objeto retiro
Todos los campos de un retiro, tal como llegan en la API y en los webhooks.
Los montos son texto decimal en unidades del token (nunca números con coma flotante), igual que en los depósitos.
| Campo | Tipo | Qué es |
|---|---|---|
Campoid | Tipouuid | Qué esId del retiro en la pasarela. |
Campoexternal_id | Tipostring | Qué esTu clave de idempotencia (o la cabecera Idempotency-Key). |
Campocustomer_ref | Tipostring · null | Qué esLo que enviaste en customer_id. |
Campostatus | Tipoenum | Qué espending, sent, completed o failed. |
Campochain_id | Tipointeger | Qué esRed: 42161 (Arbitrum One) o 421614 (Arbitrum Sepolia). |
Campotoken / token_address / decimals | Tipostring / string / integer | Qué esToken pagado. |
Campoto | Tipostring | Qué esBilletera del usuario. |
Camporequested | Tipostring | Qué esLo que pidió el usuario (sus fichas). |
Campoamount | Tipostring | Qué esLo que recibe el usuario. |
Campoplatform_fee | Tipostring | Qué esComisión de la plataforma. |
Campogas_fee | Tipostring | Qué esGas descontado (0 si lo paga la plataforma). |
Campodebit | Tipostring | Qué esLo que sale de tu caja: amount + platform_fee + gas_fee. |
Campogas_paid_by | Tipoenum | Qué esmerchant, customer o platform, al momento de crear el retiro. |
Campotx_hash | Tipostring · null | Qué esTransacción del pago. Llega con sent. |
Campoerror | Tipoobject · null | Qué esSolo en failed: { code, message }. |
Campometadata | Tipoobject | Qué esTus datos libres. |
Campocreated_at / sent_at / completed_at / failed_at | Tipodate-time · null | Qué esMomentos de cada estado. |
1{2 "id": "6b1f0c3e-1d7a-4a39-9a7e-2f5c8d0b4e11",3 "external_id": "retiro-000981",4 "customer_ref": "jugador-77",5 "status": "completed",6 "chain_id": 421614,7 "token": "USDT",8 "token_address": "0xdc190461C20DE36fFB305b0190985B4023D7D183",9 "decimals": 6,10 "to": "0xF389A660Fa404c39E8f346C46E569fF41b8d3d68",11 "requested": "500",12 "amount": "500",13 "platform_fee": "5",14 "gas_fee": "0.008419",15 "debit": "505.008419",16 "gas_paid_by": "merchant",17 "tx_hash": "0x9d2c41b07e3f5a6c8e1b0d4f7a2c9e6b3d8f1a0c5e7b2d4f6a8c0e1b3d5f7a9c",18 "error": null,19 "metadata": {20 "fichas": 50021 },22 "created_at": "2026-10-14T13:20:05.114Z",23 "sent_at": "2026-10-14T13:20:06.302Z",24 "completed_at": "2026-10-14T13:20:08.947Z",25 "failed_at": null26}