Saltar al contenido principal

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​

CabeceraValor
x-midMerchant ID
x-timestampSegundos
x-signatureHMAC(URL\ntimestamp\ncuerpo)

Cuerpo​

CampoDescripción
amountImporte del retiro (número; límites de precisión en /public/assets).
assetTicker (USDT, …).
networkRed (SOL, TRON, …).
internal_idSu id único de operación.
clientId estable de cliente.
addressDirección del beneficiario en la red destino.
fees_on0 — comisión del comerciante, 1 — del usuario (según docs Cobrex).
callbackURL 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​

CabeceraValor
x-uidUser ID
x-timestampSegundos
x-signatureHMAC(URL\ntimestamp\ncuerpo)

Campo extra en el cuerpo​

CampoDescripción
accountId 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"
}