Objeto de retiro
Referencia de campos
| Campo | Tipo | Descripción |
|---|---|---|
payout_id | string | Id único del retiro en Cobrex (o-…). |
internal_id | string | Su id interno de operación (deduplicación / reporting). |
user_id | string | Id de usuario Cobrex (u-…). |
merchant | object | Datos del comerciante. |
merchant.merchant_id | string | Id de comerciante (m-…). |
merchant.name | string | Nombre. |
merchant.url | string | URL. |
merchant.fees_on | number | Ajuste de comisiones por defecto. |
asset | object | Vía del retiro. |
asset.name | string | Nombre completo (p. ej. «Tether SOL»). |
asset.asset | string | Ticker (USDT, …). |
asset.network | string | Red (SOL, …). |
txs | array | Transacciones on-chain. |
txs[].hash | string | Hash en cadena. |
txs[].sender | string | Dirección del emisor (Cobrex / intermedia). |
txs[].confirmations | number | Confirmaciones. |
address | string | Dirección del beneficiario. |
client | string | Su id de cliente. |
amount | string | Importe del retiro (cadena decimal). |
hash | string | Hash principal (puede repetir txs). |
details | object | Desglose financiero. |
details.sent | string | Importe enviado al beneficiario. |
details.withdrawn | string | Debitado del saldo. |
details.fees_on | number | Lado de la comisión (0 comerciante, 1 usuario / según contrato). |
details.fee | string | Comisión de servicio. |
details.network_fee | string | Comisión de red. |
details.total_fees | string | Comisiones totales. |
details.usdt | string | Equivalente en USDT. |
status | object | Estado. |
status.final | boolean | Finalizado. |
status.code | string | PENDING, SUCCESS, FAIL. |
status.substatus | string | Detalle, p. ej. CREATED. |
created_at | string (ISO 8601) | Creación. |
paid_at | string | null | Envío / finalización (según Cobrex). |
canceled_at | string | null | Cancelación, si hubo. |
Ejemplo completo
{
"payout_id": "o-2b72159c-8495-472f-a7f9-7d49721864bb",
"internal_id": "22c21d78-0155-49d9-9e39-cd1d99b5f846",
"user_id": "u-7027b0e7-a192-47c6-9082-de8e4049d85a",
"merchant": {
"merchant_id": "m-e2dbcd50-6b5c-4d2a-97dd-153beb2a1abe",
"name": "test",
"url": "https://test.com",
"fees_on": 0
},
"asset": {
"name": "Tether SOL",
"asset": "USDT",
"network": "SOL"
},
"txs": [
{
"hash": "w23BtR9eX2MyCJniJ6uq15tSGJV3yooxAFiY5QGjDVjYPi4nPBzg3SzwJMXicLKHh3sypr3h7t9eJWKN13aj4av",
"sender": "QWUF8QGDf1Msd3cYhLkDnkjtFZwK6BTqaamus2dDMi7",
"confirmations": 2
}
],
"address": "QWUF8QGDf1Msd3cYhLkDnkjtFZwK6BTqaamus2dDMi7",
"client": "743859",
"amount": "2.000000000000000000",
"hash": "w23BtR9eX2MyCJniJ6uq15tSGJV3yooxAFiY5QGjDVjYPi4nPBzg3SzwJMXicLKHh3sypr3h7t9eJWKN13aj4av",
"details": {
"sent": "1.700000000000000000",
"withdrawn": "2.000000000000000000",
"fees_on": 1,
"fee": "0.000000000000000000",
"network_fee": "0.300000000000000000",
"total_fees": "0.300000000000000000",
"usdt": "2.000000000000000000"
},
"status": {
"final": false,
"code": "PENDING",
"substatus": "CREATED"
},
"created_at": "2026-05-03T08:09:13.000Z",
"paid_at": null,
"canceled_at": null
}