Crear retiro
POST https://api.cobrex.com/payout
Content-Type: application/json
La firma incluye el cuerpo JSON completo — véase Autenticación.
Opción 1: Cuenta del comerciante (x-mid)
Los fondos se debitan de la cuenta vinculada al comerciante.
Cabeceras
| Cabecera | Valor |
|---|---|
x-mid | Merchant ID |
x-timestamp | Segundos |
x-signature | HMAC(URL\ntimestamp\ncuerpo) |
Cuerpo
| Campo | Descripción |
|---|---|
amount | Importe del retiro (número; límites de precisión en /public/assets). |
asset | Ticker (USDT, …). |
network | Red (SOL, TRON, …). |
internal_id | Su id único de operación. |
client | Id estable de cliente. |
address | Dirección del beneficiario en la red destino. |
fees_on | 0 — comisión del comerciante, 1 — del usuario (según docs Cobrex). |
callback | URL de webhook. |
Ejemplo
{
"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"
}
Respuesta
Objeto de retiro — referencia de campos.
Opción 2: Cuenta de usuario explícita (x-uid)
Use cuando el retiro no va por la vinculación comerciante sino desde una cuenta concreta.
Cabeceras
| Cabecera | Valor |
|---|---|
x-uid | User ID |
x-timestamp | Segundos |
x-signature | HMAC(URL\ntimestamp\ncuerpo) |
Campo extra en el cuerpo
| Campo | Descripción |
|---|---|
account | Id de cuenta a-… (de GET /accounts). |
El resto de campos — igual que en la opción 1.
Ejemplo
{
"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"
}