Convierte bolívares o pesos a USDT

Qué vas a hacer

Pides una cotización, la aceptas dentro de 60 segundos y el monto de origen sale de tu saldo VES o COP. Los USDT se acreditan en tu saldo USDT cuando la conversión se completa. La tasa ya incluye el precio: no hay una comisión de conversión aparte.

• USDT habilitado en tu cuenta (y COP, para convertir pesos).
• Un saldo VES o COP para convertir.
• Un endpoint de webhook suscrito a conversion.created, conversion.completed y conversion.canceled.

Pasos: en el portal

1. 01
   Abre la tarjeta correcta

   Bolívares: Portal → USDT, "Convert VES → USDT". Pesos: Portal → COP, "Convert COP → USDT".

2. 02
   Obtén una cotización

   Elige gastar un monto o recibir un monto de USDT, escríbelo y haz clic en Get quote.

3. 03
   Confirma a tiempo

   Revisa la tasa y ambos montos, y haz clic en Confirm conversion antes de que termine la cuenta regresiva de 60 segundos (o Refresh quote).

Pasos: con la API

1. 01
   Revisa tu configuración

   GET /v1/conversions/settings muestra si las conversiones están habilitadas, tu spread por moneda, tu mínimo en USDT, cualquier tope diario y la conversión automática.

2. 02
   Pide una cotización

   POST /v1/conversions/quotes con sourceCurrency (VES por defecto, o COP) y exactamente un monto: sourceAmount o targetAmountUsdt.

3. 03
   Acéptala

   POST /v1/conversions con quoteId (y un encabezado Idempotency-Key) dentro de 60 segundos. La cotización se puede usar una vez.

4. 04
   Espera a que se complete

   En Test se completa en la misma solicitud. En Live puede quedar PENDING mientras VEXPay entrega los USDT, normalmente el mismo día hábil (una aceptada fuera de horario o en fin de semana se completa el siguiente día hábil): reacciona a conversion.completed, no bloquees esperando la solicitud. Mientras esté pendiente puedes cancelarla con POST /v1/conversions/:id/cancel y recuperar el monto de origen completo.

curl --request POST "${API_URL}/v1/conversions/quotes" \
  --header "content-type: application/json" \
  --header "x-api-key: ${VEXPAY_API_KEY}" \
  --data '{ "sourceCurrency": "VES", "targetAmountUsdt": 100 }'

curl --request POST "${API_URL}/v1/conversions" \
  --header "content-type: application/json" \
  --header "x-api-key: ${VEXPAY_API_KEY}" \
  --header "Idempotency-Key: conv-2026-11-01" \
  --data '{ "quoteId": "QUOTE_ID", "reference": "treasury-nov" }'

Convierte una parte de cada pago en pesos

Define un porcentaje entero de 0 (apagado) a 100 en Portal → COP → "Auto-convert COP payments", o con PATCH /v1/conversions/settings y {"autoConvert":{"COP":{"percent":50}}}. Aplica a los pagos en pesos completados después del cambio, y envía conversion.created con origin: "auto" después del payment.completed. Una parte por debajo de tu mínimo se omite y queda en COP.

Comprueba que funcionó

• GET /v1/conversions/:id muestra COMPLETED con targetAmountUsdt.
• GET /v1/crypto/balance muestra los USDT. Si convertiste dinero que seguía retenido, los USDT quedan retenidos hasta que termine esa retención original.

Si algo sale mal

Relacionado: Convertir VES o COP a USDT · Cobra en bolívares, recibe USDT · Receta: Bs entran, USDT salen