Skip to main content
Billeteras, exchanges y redes de stablecoins necesitan dos movimientos:
  • On-ramp: el usuario deposita moneda local y recibe cripto.
  • Off-ramp: el usuario vende cripto y recibe moneda local en su banco.
La API cubre ambos escenarios con payins, exchange y payouts combinados.

​
Flujo on-ramp

​
Flujo off-ramp

​
Paso a paso

1

On-ramp: cobra en moneda local

Crea la orden con POST /payment_orders o Direct Payment. El monto se acredita en la wallet de la moneda destino.
2

Convierte

GET /crypto_prices y luego POST /transactions con transactions_type: "exchange" dentro de la ventana valid_until. Convierte entre fiat y cripto, o entre criptos.
Fiat → Fiat no está soportado; eso se resuelve con un payout bancario. Al menos una de currency_sent / currency_received debe ser cripto.
3

Off-ramp: paga a la cuenta del usuario

Con la cripto ya convertida a saldo fiat, crea el payout con POST /transactions y transactions_type: "withdrawal" hacia su banco local.
4

Retiro cripto a wallet externa

Si el usuario prefiere retirar cripto: GET /networks para elegir la red, respeta withdraw_min y withdraw_max, suma withdraw_fee al amount y crea transactions_type: "crypto_payout".

​
Buenas prácticas

Pide el precio justo antes de cada conversión: la tasa vence en valid_until (típicamente ~2 minutos).
Muestra al usuario el monto final antes de confirmar. Las sorpresas de FX destruyen la confianza.
Configura webhooks para enterarte del estado final sin tener que hacer polling.

​
Endpoints clave

Precios cripto

GET /crypto_prices

Crear exchange

POST /transactions con transactions_type: "exchange"

Crear payout bancario

POST /transactions con transactions_type: "withdrawal"

Crear payout cripto

POST /transactions con transactions_type: "crypto_payout"