Saltar al contenido principal

Objeto de retiro

Referencia de campos​

CampoTipoDescripción
payout_idstringId único del retiro en Cobrex (o-…).
internal_idstringSu id interno de operación (deduplicación / reporting).
user_idstringId de usuario Cobrex (u-…).
merchantobjectDatos del comerciante.
merchant.merchant_idstringId de comerciante (m-…).
merchant.namestringNombre.
merchant.urlstringURL.
merchant.fees_onnumberAjuste de comisiones por defecto.
assetobjectVía del retiro.
asset.namestringNombre completo (p. ej. «Tether SOL»).
asset.assetstringTicker (USDT, …).
asset.networkstringRed (SOL, …).
txsarrayTransacciones on-chain.
txs[].hashstringHash en cadena.
txs[].senderstringDirección del emisor (Cobrex / intermedia).
txs[].confirmationsnumberConfirmaciones.
addressstringDirección del beneficiario.
clientstringSu id de cliente.
amountstringImporte del retiro (cadena decimal).
hashstringHash principal (puede repetir txs).
detailsobjectDesglose financiero.
details.sentstringImporte enviado al beneficiario.
details.withdrawnstringDebitado del saldo.
details.fees_onnumberLado de la comisión (0 comerciante, 1 usuario / según contrato).
details.feestringComisión de servicio.
details.network_feestringComisión de red.
details.total_feesstringComisiones totales.
details.usdtstringEquivalente en USDT.
statusobjectEstado.
status.finalbooleanFinalizado.
status.codestringPENDING, SUCCESS, FAIL.
status.substatusstringDetalle, p. ej. CREATED.
created_atstring (ISO 8601)Creación.
paid_atstring | nullEnvío / finalización (según Cobrex).
canceled_atstring | nullCancelació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
}