Saltar al contenido principal

Objeto de pago

Campos que verá en respuestas de la API y/o webhooks al cambiar el estado.

Referencia de campos​

CampoTipoDescripción
payment_idstringId único del pago en Cobrex (p-…).
user_idstringId de usuario Cobrex (u-…).
merchantobjectDatos breves del comerciante.
merchant.merchant_idstringId de comerciante (m-…).
merchant.namestringNombre.
merchant.urlstringURL del comerciante.
merchant.fees_onnumberComportamiento de comisiones por defecto (véase contrato/panel).
assetobjectVía de abono.
asset.namestringNombre legible (p. ej. «Tether USDT TRC-20»).
asset.assetstringTicker (USDT, BTC, …).
asset.networkstringRed (TRON, BTC, …).
txsarrayTransacciones on-chain relacionadas.
txs[].hashstringHash de la transacción.
txs[].senderstringDirección del emisor.
txs[].confirmationsnumberConfirmaciones de red.
clientstringSu id externo de cliente / pedido.
addressstringDirección de depósito en Cobrex.
amountstringImporte del pago (cadena decimal).
detailsobjectComisiones y equivalentes.
details.creditedstringImporte abonado al saldo.
details.feestringComisión de servicio.
details.network_feestringComisión de red.
details.total_feesstringComisiones totales.
details.usdtstringEquivalente en USDT (según Cobrex).
statusobjectEstado del procesamiento.
status.finalbooleanSi el ciclo de vida ha terminado.
status.codestringCódigo grueso: PENDING, SUCCESS, FAIL.
status.substatusstringDetalle, p. ej. PAID.
created_atstring (ISO 8601)Creación.
updated_atstring (ISO 8601)Última actualización.
paid_atstring | nullHora del pago exitoso.
canceled_atstring | nullHora 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.