Saltar al contenido principal

Vender Cripto

Para vender, la empresa envía USDT o USDC a una dirección fija proporcionada por XGate. Cada transferencia confirmada en la red se convierte en una venta, y el valor en reales se acredita en el saldo BRL o se envía vía Pix a un beneficiario aprobado, según la configuración de la empresa en el panel.


Cómo funciona​

  • No existe orden de venta ni POST. XGate proporciona a la empresa una dirección fija por activo y red. La empresa envía USDT o USDC desde cualquier billetera a esa dirección, y cada transferencia confirmada en la red se convierte en una venta, a mercado, sin precio mínimo ni devolución on-chain. Diez envíos son diez ventas.
  • El precio se fija en la liquidación, ya con el margen comercial incluido. El valor en BRL acreditado es netAmount = cryptoAmount × rate (redondeado hacia abajo, 2 decimales).[cite: 17]
  • Concilie mediante el txHash de su transferencia. La sourceAddress ayuda cuando la red la informa.
Atención al enviar

Envíe únicamente el activo y la red de la dirección. Enviar otro token, o el token correcto por la red equivocada, resulta en pérdida definitiva sin devolución. No existe USDC en TRON.


Direcciones de venta​

Las direcciones se consultan en GET /crypto/options, dentro del bloque 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…" }
]
}
}
CampoTipoDescripción
enabledbooleanVenta habilitada para la empresa.
statusstringDISABLED · PROVISIONING · READY. La primera consulta de una empresa habilitada genera las direcciones: el estado queda PROVISIONING por unos minutos y pasa a READY.
minAmountobjectVenta mínima por activo (USDT, USDC). Los envíos por debajo del mínimo quedan en análisis (review.reason = BELOW_MINIMUM).
depositAddresses[]arrayDirección fija de cada par: asset, network, address.

Hacia dónde va el BRL​

La modalidad para recibir el BRL de la venta se configura una única vez en el panel de XGate (Compra/Venta › Ajustes):

  • Saldo en BRL de la empresa; o
  • Transferencia Pix a un beneficiario aprobado.

La API no modifica esta preferencia: simplemente refleja el resultado en el campo settlement de cada venta. Si no es posible procesar el Pix (beneficiario no aprobado, retiro rechazado o fallido), el monto se acredita en el saldo BRL y la venta finaliza con el estado SETTLED_TO_BALANCE, detallando el motivo en settlement.fallbackReason. La venta nunca queda bloqueada.


Estados de la venta​

RECEIVED ──► SETTLING ──► SETTLED
└──► SETTLED_TO_BALANCE
EstadoSignificado
RECEIVEDCriptomoneda recibida y confirmada, esperando cotización. Las ventas en revisión aparecen aquí con review.reason.
SETTLINGPrecio congelado, crédito en curso.
SETTLEDLiquidada según la modalidad configurada. Final.
SETTLED_TO_BALANCELa modalidad configurada era Pix, pero el valor cayó en saldo. settlement.fallbackReason explica el motivo. Final.

Seguimiento​

Haga el seguimiento de cada venta mediante Consultar Venta o a través de los webhooks de venta (sale.*), en la pestaña Webhooks › Webhooks de Venta Cripto. La descripción completa de cada campo está disponible en Objeto de la venta.