Pular para o conteúdo principal

Vender Cripto

Para vender, a empresa envia USDT ou USDC para um endereço fixo que a XGate dá a ela. Cada envio confirmado na rede vira uma venda, e o valor em reais é creditado no saldo BRL ou enviado por Pix para um beneficiário aprovado, conforme a configuração da empresa no painel.


Como funciona​

  • Não existe pedido de venda nem POST. A XGate dá à empresa um endereço fixo por ativo e rede. A empresa envia USDT ou USDC de qualquer carteira para esse endereço, e cada envio confirmado na rede vira uma venda, a mercado, sem preço mínimo e sem devolução on-chain. Dez envios são dez vendas.
  • O preço é fixado na liquidação, já com a margem comercial embutida. O valor em BRL creditado é netAmount = cryptoAmount × rate (arredondado para baixo, 2 casas).
  • Concilie pelo txHash do seu envio. O sourceAddress ajuda quando a rede o informa.
Atenção ao enviar

Envie apenas o ativo e a rede do endereço. Enviar outro token, ou o token certo pela rede errada, resulta em perda, sem devolução. Não existe USDC em TRON.


Endereços de venda​

Os endereços vêm em GET /crypto/options, no bloco sale:

{
"sale": {
"enabled": true,
"status": "READY",
"minAmount": { "USDT": "10.000000", "USDC": "10.000000" },
"depositAddresses": [
{ "asset": "USDT", "network": "TRON", "address": "TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf" },
{ "asset": "USDC", "network": "SOLANA", "address": "7mQe1…" }
]
}
}
CampoTipoDescrição
enabledbooleanVenda liberada para a empresa.
statusstringDISABLED · PROVISIONING · READY. A primeira consulta de uma empresa com venda liberada dispara a criação dos endereços: o status fica PROVISIONING por alguns minutos e passa a READY.
minAmountobjectVenda mínima por ativo (USDT, USDC). Envios abaixo do mínimo ficam em análise (review.reason = BELOW_MINIMUM).
depositAddresses[]arrayEndereço fixo de cada par: asset, network, address.

Para onde vai o BRL​

A forma de receber o BRL da venda é configurada uma vez, no painel da XGate (Compra/Venda › Configurações):

  • Saldo em BRL da empresa; ou
  • Pix para um beneficiário aprovado.

A API não altera essa escolha: ela mostra o resultado no campo settlement de cada venda. Se o Pix não puder ser feito (beneficiário não aprovado, saque recusado ou falho), o valor cai no saldo BRL e a venda termina SETTLED_TO_BALANCE, com o motivo em settlement.fallbackReason. A venda nunca fica presa.


Status da venda​

RECEIVED ──► SETTLING ──► SETTLED
└──► SETTLED_TO_BALANCE
StatusSignificado
RECEIVEDCripto recebida e confirmada, aguardando preço. Uma venda suspensa em análise da XGate aparece aqui, com review.reason.
SETTLINGPreço congelado, crédito em andamento.
SETTLEDLiquidada pela forma configurada. Final.
SETTLED_TO_BALANCEA forma era Pix, mas o valor caiu no saldo. settlement.fallbackReason explica o motivo. Final.

Acompanhamento​

Acompanhe cada venda por Consultar Venda ou pelos webhooks de venda (sale.*), na aba Webhooks › Vendas Cripto Webhook. A descrição de cada campo está em Objeto da venda.