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çalho | Valor |
|---|---|
x-mid | Merchant ID |
x-timestamp | Segundos |
x-signature | HMAC(URL\ntimestamp\ncorpo) |
Corpo
| Campo | Descrição |
|---|---|
amount | Montante do saque (número; limites de precisão em /public/assets). |
asset | Ticker (USDT, …). |
network | Rede (SOL, TRON, …). |
internal_id | O seu id único da operação. |
client | Id estável do cliente. |
address | Endereço do destinatário na rede alvo. |
fees_on | 0 — taxa no comerciante, 1 — no utilizador (docs Cobrex). |
callback | URL 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çalho | Valor |
|---|---|
x-uid | User ID |
x-timestamp | Segundos |
x-signature | HMAC(URL\ntimestamp\ncorpo) |
Campo extra no corpo
| Campo | Descrição |
|---|---|
account | Id 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"
}