Objeto de pago
Campos que verá en respuestas de la API y/o webhooks al cambiar el estado.
Referencia de campos
| Campo | Tipo | Descripción |
|---|---|---|
payment_id | string | Id único del pago en Cobrex (p-…). |
user_id | string | Id de usuario Cobrex (u-…). |
merchant | object | Datos breves del comerciante. |
merchant.merchant_id | string | Id de comerciante (m-…). |
merchant.name | string | Nombre. |
merchant.url | string | URL del comerciante. |
merchant.fees_on | number | Comportamiento de comisiones por defecto (véase contrato/panel). |
asset | object | Vía de abono. |
asset.name | string | Nombre legible (p. ej. «Tether USDT TRC-20»). |
asset.asset | string | Ticker (USDT, BTC, …). |
asset.network | string | Red (TRON, BTC, …). |
txs | array | Transacciones on-chain relacionadas. |
txs[].hash | string | Hash de la transacción. |
txs[].sender | string | Dirección del emisor. |
txs[].confirmations | number | Confirmaciones de red. |
client | string | Su id externo de cliente / pedido. |
address | string | Dirección de depósito en Cobrex. |
amount | string | Importe del pago (cadena decimal). |
details | object | Comisiones y equivalentes. |
details.credited | string | Importe abonado al saldo. |
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 (según Cobrex). |
status | object | Estado del procesamiento. |
status.final | boolean | Si el ciclo de vida ha terminado. |
status.code | string | Código grueso: PENDING, SUCCESS, FAIL. |
status.substatus | string | Detalle, p. ej. PAID. |
created_at | string (ISO 8601) | Creación. |
updated_at | string (ISO 8601) | Última actualización. |
paid_at | string | null | Hora del pago exitoso. |
canceled_at | string | null | Hora de cancelación, si aplica. |
Ejemplo completo
{
"payment_id": "p-1a9a67a1-46ce-11f1-8b35-7cc255316480",
"user_id": "u-96bada25-a20f-49d6-99e9-5893d0769af2",
"merchant": {
"merchant_id": "m-ca33fcbe-317f-47fb-bf3a-520827816658",
"name": "Cobrex",
"url": "https://cobrex.com",
"fees_on": 0
},
"asset": {
"name": "Tether USDT TRC-20",
"asset": "USDT",
"network": "TRON"
},
"txs": [
{
"hash": "b9ccd188fa62c4cad987088b25085ee3783fbae8d0884a1d2b416878b99d51ac",
"sender": "TU4vEruvZwLLkSfV9bNw12EJTPvNr7Pvab",
"confirmations": 18
}
],
"client": "743858",
"address": "TV9jGGXR4SCPGnRMP77pvurBWE5SMjjjvA",
"amount": "75.000000000000000000",
"details": {
"credited": "74.925000000000000000",
"fee": "0.075000000000000000",
"network_fee": "0.000000000000000000",
"total_fees": "0.075000000000000000",
"usdt": "75.000000000000000000"
},
"status": {
"final": true,
"code": "SUCCESS",
"substatus": "PAID"
},
"created_at": "2026-05-03T08:57:24.000Z",
"updated_at": "2026-05-03T08:58:19.000Z",
"paid_at": "2026-05-03T08:58:19.000Z",
"canceled_at": null
}
Siguiente: monedero estático, consultar pago.