Skip to main content

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​

HeaderValue
x-midMerchant ID
x-timestampSeconds
x-signatureHMAC(URL\ntimestamp\nbody)

Body​

FieldDescription
amountPayout amount (number; precision limits in /public/assets).
assetTicker (USDT, …).
networkNetwork (SOL, TRON, …).
internal_idYour unique operation id.
clientStable customer id.
addressRecipient address on the target network.
fees_on0 — fee on merchant, 1 — on user (per Cobrex docs).
callbackWebhook 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​

HeaderValue
x-uidUser ID
x-timestampSeconds
x-signatureHMAC(URL\ntimestamp\nbody)

Extra body field​

FieldDescription
accountAccount 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"
}