Referencias
Objeto depósito
Cada campo del depósito, tal como viene en la API y en los webhooks.
El depósito tiene la misma forma en todas partes: en Obtener depósito, en los listados y dentro de data.deposit en cada webhook. En un webhook refleja el depósito en el momento del evento.
1{2 "id": "ba7524c6-79b7-438a-8ecd-76ce3093a626",3 "status": "settled",4 "customer": {5 "id": "3d8ed2f2-72d4-4c27-b606-a53b5a4db086",6 "external_id": "TARJETA-000123"7 },8 "address": "0xeb1322f1c80462602a728ca005f1026709a738ba",9 "chain_id": 421614,10 "token": "USDT",11 "token_address": "0xdc190461c20de36ffb305b0190985b4023d7d183",12 "decimals": 6,13 "amount": "100",14 "amount_units": "100000000",15 "from": "0xd116a420bb016e712c0d979718821c5fa16c13f6",16 "tx_hash": "0xece621149543e194b19897b0d8947023a7c925e12db2b9ba33c59b940c58c14d",17 "log_index": 20,18 "block_number": 318874750,19 "breakdown": {20 "final": true,21 "gas_paid_by": "merchant",22 "platform_fee": "1",23 "merchant_fee": "2",24 "gas_fee": "0.00885",25 "net": "96.99115"26 },27 "sweep_tx_hash": "0x31f0595da9da4a477935ef7e7f1a62598f62bb5f7fd858f9e031fe88f65b7bfb",28 "detected_at": "2026-10-13T15:04:12.310Z",29 "confirmed_at": "2026-10-13T15:04:13.287Z",30 "settled_at": "2026-10-13T15:04:23.402Z"31}Campos#
| Campo | Tipo | Descripción |
|---|---|---|
Campoid | Tipouuid | DescripciónId del depósito. Estable durante toda su vida. |
Campostatus | Tipoenum | Descripcióndetected, confirmed, settled, below_minimum o reverted. Ver Estados de un depósito. |
Campocustomer.id | Tipouuid | DescripciónId del cliente en la pasarela. |
Campocustomer.external_id | Tipostring | DescripciónTu identificador del usuario. |
Campoaddress | Tipostring | DescripciónDirección de depósito del cliente, en minúsculas. |
Campochain_id | Tipointeger | DescripciónRed: 421614 (Arbitrum Sepolia) o 42161 (Arbitrum One). |
Campotoken | Tipostring | DescripciónSímbolo: USDT o USDC. |
Campotoken_address | Tipostring | DescripciónContrato del token, en minúsculas. |
Campodecimals | Tipointeger | DescripciónDecimales del token. |
Campoamount | Tipostring | DescripciónMonto depositado, en texto decimal. |
Campoamount_units | Tipostring | DescripciónEl mismo monto en la unidad mínima del token. |
Campofrom | Tipostring | DescripciónDirección que envió la transferencia, en minúsculas. Si viene de un exchange, es la del exchange. |
Campotx_hash | Tipostring | DescripciónTransacción del depósito. |
Campolog_index | Tipointeger | DescripciónPosición de la transferencia dentro de la transacción. Con tx_hash identifica el depósito en la blockchain. |
Campoblock_number | Tipointeger | DescripciónBloque en el que entró la transferencia. |
Campobreakdown | Tipoobject o null | DescripciónReparto del depósito. null mientras está detected o si se revirtió. |
Camposweep_tx_hash | Tipostring o null | DescripciónTransacción del barrido que llevó el dinero a la tesorería. null hasta que se barre. |
Campodetected_at | Tipodate-time | DescripciónCuándo lo vio el servidor. |
Campoconfirmed_at | Tipodate-time o null | DescripciónCuándo se confirmó (también se llena en below_minimum). |
Camposettled_at | Tipodate-time o null | DescripciónCuándo se registró el barrido. |
breakdown#
| Campo | Tipo | Descripción |
|---|---|---|
Campofinal | Tipoboolean | Descripciónfalse: reparto cotizado al confirmar. true: reparto definitivo, tomado del evento del contrato tras el barrido. |
Campogas_paid_by | Tipoenum | Descripciónplatform, merchant o customer: el gas_mode de la empresa cuando se confirmó el depósito. |
Campoplatform_fee | Tipostring | DescripciónComisión de la plataforma. |
Campomerchant_fee | Tipostring | DescripciónComisión de la empresa a su usuario. Va a la billetera de comisiones. |
Campogas_fee | Tipostring | DescripciónGas descontado. "0" si lo paga la plataforma. Con final: false es el máximo; el definitivo nunca es mayor. |
Camponet | Tipostring | DescripciónLo que llega a la tesorería: amount − platform_fee − merchant_fee − gas_fee. |
1{2 "final": false,3 "gas_paid_by": "merchant",4 "platform_fee": "1",5 "merchant_fee": "2",6 "gas_fee": "0.008923",7 "net": "96.991077"8}- Todos los montos de
breakdownestán en el token del depósito y en texto decimal. - Si varios depósitos se barrieron juntos, las comisiones y el gas del barrido se atribuyen a cada uno en proporción, sin perder ni una unidad: la suma de los
netcoincide con el neto del barrido. - En
/admin/depositsel objeto trae ademásmerchant: { id, name }. - En los eventos guardados, el orden de las claves del JSON puede variar. No dependas del orden.
settled_at puede ser anterior a confirmed_at cuando el admin de la empresa barrió por su cuenta antes de que el servidor confirmara el depósito.