Payment object

Fields you will see in API responses and/or webhooks when status changes.

Field reference

Field	Type	Description
payment_id	string	Unique payment id in Cobrex (p-…).
user_id	string	Cobrex user id (u-…).
merchant	object	Short merchant info.
merchant.merchant_id	string	Merchant id (m-…).
merchant.name	string	Name.
merchant.url	string	Merchant URL.
merchant.fees_on	number	Default fee-side behavior (see contract/dashboard).
asset	object	Credit rail.
asset.name	string	Human-readable name (e.g. “Tether USDT TRC-20”).
asset.asset	string	Ticker (USDT, BTC, …).
asset.network	string	Network (TRON, BTC, …).
txs	array	Related on-chain transactions.
txs[].hash	string	Transaction hash.
txs[].sender	string	Sender address.
txs[].confirmations	number	Network confirmations.
client	string	Your external customer / order id.
address	string	Deposit address at Cobrex.
amount	string	Payment amount (decimal string).
details	object	Fees and equivalents.
details.credited	string	Amount credited to balance.
details.fee	string	Service fee.
details.network_fee	string	Network fee.
details.total_fees	string	Total fees.
details.usdt	string	USDT equivalent (as Cobrex reports).
status	object	Processing status.
status.final	boolean	Whether the lifecycle is finished.
status.code	string	Coarse code: PENDING, SUCCESS, FAIL.
status.substatus	string	Detail, e.g. PAID.
created_at	string (ISO 8601)	Created at.
updated_at	string (ISO 8601)	Last update.
paid_at	string | null	Successful payment time.
canceled_at	string | null	Cancellation time, if any.

Full example

{
  "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
}

Next: static wallet, get payment.