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
txHashde su transferencia. LasourceAddressayuda cuando la red la informa.
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…" }
]
}
}
| Campo | Tipo | Descripción |
|---|---|---|
enabled | boolean | Venta habilitada para la empresa. |
status | string | DISABLED · PROVISIONING · READY. La primera consulta de una empresa habilitada genera las direcciones: el estado queda PROVISIONING por unos minutos y pasa a READY. |
minAmount | object | Venta mínima por activo (USDT, USDC). Los envíos por debajo del mínimo quedan en análisis (review.reason = BELOW_MINIMUM). |
depositAddresses[] | array | Direcció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
| Estado | Significado |
|---|---|
RECEIVED | Criptomoneda recibida y confirmada, esperando cotización. Las ventas en revisión aparecen aquí con review.reason. |
SETTLING | Precio congelado, crédito en curso. |
SETTLED | Liquidada según la modalidad configurada. Final. |
SETTLED_TO_BALANCE | La 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.