POST /payments/transfers/crypto#
Realiza um saque (retirada) em criptomoeda. O valor Ć© informado em BRL, as taxas sĆ£o descontadas e o equivalente lĆquido em crypto Ć© enviado para a carteira informada.
AutenticaĆ§Ć£o#
| Tipo | Header | Valor |
|---|
| API Key | x-api-key | <sua_api_key> |
Request#
Method: POST
URL: /payments/transfers/crypto| Header | Tipo | ObrigatĆ³rio | DescriĆ§Ć£o |
|---|
x-api-key | string | Sim | Chave de API do usuƔrio |
Content-Type | string | Sim | application/json |
Body (JSON)#
| Campo | Tipo | ObrigatĆ³rio | DescriĆ§Ć£o |
|---|
amount | number | Sim | Valor em BRL a ser sacado (ex: 100.00) |
wallet | string | Sim | EndereƧo da carteira de destino na rede configurada |
currency | string | NĆ£o | CĆ³digo da moeda (ex: USDT_BSC). Se omitido, usa o configurado para o usuĆ”rio |
Exemplo de Request#
{
"amount": 150.00,
"wallet": "0xABCDEF1234567890abcdef1234567890ABCDEF12"
}
cURL#
Responses#
{
"success": true,
"message": "Saque crypto enviado com sucesso",
"data": {
"transaction_id": "clx1234abcd",
"amount_brl": 150.00,
"amount_fees": 9.50,
"net_amount_brl": 140.50,
"crypto_amount": 2.34567890,
"currency": "USDT_BSC",
"wallet": "0xABCDEF1234567890abcdef1234567890ABCDEF12",
"status": "pending"
}
}
| Campo | Tipo | DescriĆ§Ć£o |
|---|
transaction_id | string | ID interno da transaĆ§Ć£o |
amount_brl | number | Valor solicitado em BRL |
amount_fees | number | Total de taxas descontadas em BRL |
net_amount_brl | number | Valor lĆquido apĆ³s taxas em BRL |
crypto_amount | number | Quantidade de crypto enviada para a carteira |
currency | string | CĆ³digo da moeda utilizada |
wallet | string | EndereƧo de destino |
status | string | Status da transaĆ§Ć£o (pending, completed) |
400 Bad Request#
{
"success": false,
"message": "Valor abaixo do mĆnimo permitido"
}
| Mensagem | Causa |
|---|
"Valor invĆ”lido" | amount ausente ou nĆ£o numĆ©rico |
"Carteira de destino Ć© obrigatĆ³ria" | wallet ausente |
"Valor abaixo do mĆnimo permitido" | amount < minimal_value_out_crypto |
"Valor acima do mƔximo permitido" | amount > maximal_value_out_crypto |
"Limite diƔrio atingido" | Soma dos saques do dia excede daily_limit_out_crypto |
"Saldo insuficiente" | Saldo do usuƔrio menor que o valor solicitado |
"Nenhuma configuraĆ§Ć£o encontrada" | Sem credencial ativa |
"NĆ£o foi possĆvel obter cotaĆ§Ć£o" | Erro ao buscar cotaĆ§Ć£o |
401 Unauthorized#
{
"success": false,
"message": "API key invĆ”lida ou nĆ£o encontrada"
}
500 Internal Server Error#
{
"success": false,
"message": "Erro ao processar saque crypto",
"error": "detalhes do erro"
}
Modificado emĀ 2026-06-14 07:39:38
