Payout object
Field reference
| Field | Type | Description |
|---|---|---|
payout_id | string | Unique payout id in Cobrex (o-…). |
internal_id | string | Your internal operation id (dedup / reporting). |
user_id | string | Cobrex user id (u-…). |
merchant | object | Merchant info. |
merchant.merchant_id | string | Merchant id (m-…). |
merchant.name | string | Name. |
merchant.url | string | URL. |
merchant.fees_on | number | Default fee-side setting. |
asset | object | Payout rail. |
asset.name | string | Full name (e.g. “Tether SOL”). |
asset.asset | string | Ticker (USDT, …). |
asset.network | string | Network (SOL, …). |
txs | array | On-chain txs. |
txs[].hash | string | Chain hash. |
txs[].sender | string | Sender address (Cobrex / intermediate). |
txs[].confirmations | number | Confirmations. |
address | string | Recipient address. |
client | string | Your customer id. |
amount | string | Payout amount (decimal string). |
hash | string | Primary tx hash (may mirror txs). |
details | object | Financial breakdown. |
details.sent | string | Amount sent to recipient. |
details.withdrawn | string | Debited from balance. |
details.fees_on | number | Fee side (0 merchant, 1 user / per contract). |
details.fee | string | Service fee. |
details.network_fee | string | Network fee. |
details.total_fees | string | Total fees. |
details.usdt | string | USDT equivalent. |
status | object | Status. |
status.final | boolean | Finalized. |
status.code | string | PENDING, SUCCESS, FAIL. |
status.substatus | string | Detail, e.g. CREATED. |
created_at | string (ISO 8601) | Created. |
paid_at | string | null | Sent / completed (per Cobrex). |
canceled_at | string | null | Canceled, if any. |
Full example
{
"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
}