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 |
|---|---|---|
id | uuid | Id del retiro en la pasarela. |
external_id | string | Tu clave de idempotencia (o la cabecera Idempotency-Key). |
customer_ref | string · null | Lo que enviaste en customer_id. |
status | enum | pending, sent, completed o failed. |
chain_id | integer | Red: 42161 (Arbitrum One) o 421614 (Arbitrum Sepolia). |
token / token_address / decimals | string / string / integer | Token pagado. |
to | string | Billetera del usuario. |
requested | string | Lo que pidió el usuario (sus fichas). |
amount | string | Lo que recibe el usuario. |
platform_fee | string | Comisión de la plataforma. |
gas_fee | string | Gas descontado (0 si lo paga la plataforma). |
debit | string | Lo que sale de tu caja: amount + platform_fee + gas_fee. |
gas_paid_by | enum | merchant, customer o platform, al momento de crear el retiro. |
tx_hash | string · null | Transacción del pago. Llega con sent. |
error | object · null | Solo en failed: { code, message }. |
metadata | object | Tus datos libres. |
created_at / sent_at / completed_at / failed_at | date-time · null | Momentos 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}