Pular para o conteúdo principal

Criar saque

POST https://api.cobrex.com/payout
Content-Type: application/json

A assinatura inclui o corpo JSON completo — ver Autenticação.


Opção 1: Conta do comerciante (x-mid)​

Os fundos são debitados da conta ligada ao comerciante.

Cabeçalhos​

CabeçalhoValor
x-midMerchant ID
x-timestampSegundos
x-signatureHMAC(URL\ntimestamp\ncorpo)

Corpo​

CampoDescrição
amountMontante do saque (número; limites de precisão em /public/assets).
assetTicker (USDT, …).
networkRede (SOL, TRON, …).
internal_idO seu id único da operação.
clientId estável do cliente.
addressEndereço do destinatário na rede alvo.
fees_on0 — taxa no comerciante, 1 — no utilizador (docs Cobrex).
callbackURL do webhook.

Exemplo​

{
"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"
}

Resposta​

Objeto de saque — referência de campos.


Opção 2: Conta de utilizador explícita (x-uid)​

Use quando o saque não passa pela ligação comerciante mas sim de uma conta específica.

Cabeçalhos​

CabeçalhoValor
x-uidUser ID
x-timestampSegundos
x-signatureHMAC(URL\ntimestamp\ncorpo)

Campo extra no corpo​

CampoDescrição
accountId da conta a-… (de GET /accounts).

Os restantes campos — iguais à opção 1.

Exemplo​

{
"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"
}