Flujo on-ramp

El flujo on-ramp de Linka permite a empresas convertir monedas locales de America Latina en stablecoins como USDC o USDT en tiempo real. Esta operacion esta optimizada para velocidad, confiabilidad y conciliacion automatica.

1. Solicitar una cotizacion

El primer paso es obtener un tipo de cambio garantizado. Las cotizaciones suelen ser validas por 15 minutos.

POST /v1/quotes
{
  "pair": "MXN_USDC",
  "amount": "10000.00",
  "side": "buy"
}

2. Iniciar la sesion

Cuando el usuario confirma la cotizacion, se inicializa una sesion. Esto reserva liquidez y prepara la infraestructura bancaria local para recibir la transferencia.

POST /v1/onramp/sessions
{
  "quote_id": "qte_12345",
  "user_id": "usr_98765",
  "destination_wallet": "wal_abc123"
}

3. Transferencia bancaria

Linka opera con un modelo tipo push. El usuario envia fondos desde su banco hacia la cuenta indicada por Linka o por el partner local.

Rieles locales soportados

• Mexico: SPEI 24/7.
• Chile: TEF / Khipu.
• Colombia: ACH / PSE.
• Brasil: PIX 24/7.

[!IMPORTANT] Cada sesion incluye un reference_code unico. El usuario debe incluirlo en el campo de descripcion o referencia de la transferencia bancaria. Asi Linka puede conciliar el deposito automaticamente.

4. Conciliacion automatica

Linka monitorea los movimientos bancarios locales mediante integraciones API.

1. Deteccion: identificamos el deposito entrante.
2. Matching: asociamos la transferencia con la sesion activa mediante el codigo de referencia.
3. Ejecucion: aplicamos el tipo de cambio bloqueado e iniciamos la emision on-chain.

5. Entrega de stablecoins

Las stablecoins se envian directamente a la destination_wallet. En redes como Polygon o Stellar, la entrega suele completarse en menos de 60 segundos.

Checklist de integracion

• Mostrar la cotizacion al usuario.
• Mostrar claramente el reference_code.
• Manejar el webhook onramp.payment_detected.
• Manejar el webhook onramp.completed.

Manejo de errores