Create payout
POST https://api.cobrex.com/payout
Content-Type: application/json
Signing includes the full JSON body — see Authentication.
Option 1: Merchant account (x-mid)
Funds are debited from the account linked to the merchant.
Headers
| Header | Value |
|---|---|
x-mid | Merchant ID |
x-timestamp | Seconds |
x-signature | HMAC(URL\ntimestamp\nbody) |
Body
| Field | Description |
|---|---|
amount | Payout amount (number; precision limits in /public/assets). |
asset | Ticker (USDT, …). |
network | Network (SOL, TRON, …). |
internal_id | Your unique operation id. |
client | Stable customer id. |
address | Recipient address on the target network. |
fees_on | 0 — fee on merchant, 1 — on user (per Cobrex docs). |
callback | Webhook URL. |
Example
{
"amount": 2,
"asset": "USDT",
"network": "SOL",
"internal_id": "22c21d78-0155-49d9-9e39-cd1d99b5f846",
"client": "743859",
"address": "QWUF8QGDf1Msd3cYhLkDnkjtFZwK6BTqaamus2dDMi7",
"fees_on": 1,
"callback": "https://api.cobrex.com/webhook"
}
Response
Payout object — field reference.
Option 2: Explicit user account (x-uid)
Use when the payout is not via merchant linkage but from a specific account.
Headers
| Header | Value |
|---|---|
x-uid | User ID |
x-timestamp | Seconds |
x-signature | HMAC(URL\ntimestamp\nbody) |
Extra body field
| Field | Description |
|---|---|
account | Account id a-… (from GET /accounts). |
Other fields — same as option 1.
Example
{
"account": "a-0f26ab1b-bacb-4039-857a-4d6dbf43f996",
"amount": 2,
"asset": "USDT",
"network": "SOL",
"internal_id": "22c21d78-0155-49d9-9e39-cd1d99b5f846",
"client": "743859",
"address": "QWUF8QGDf1Msd3cYhLkDnkjtFZwK6BTqaamus2dDMi7",
"fees_on": 1,
"callback": "https://api.cobrex.com/webhook"
}