Flujo off-ramp
El servicio off-ramp de Linka permite a usuarios institucionales y empresas convertir activos digitales en moneda local y recibir fondos directamente en cuentas bancarias de America Latina.
Resumen del proceso
1. Registro de cuenta bancaria
Antes de iniciar un off-ramp, la cuenta bancaria de destino debe registrarse y verificarse.
2. Solicitud de transaccion
El usuario indica el monto de stablecoins que desea vender y selecciona una cuenta bancaria guardada.
3. Transferencia de activos
El usuario transfiere los activos a una direccion de orquestacion controlada por Linka.
4. Desembolso en fiat
Cuando la transaccion on-chain se confirma, Linka ejecuta una transferencia bancaria local hacia la cuenta del usuario.
Guia de implementacion
Paso 1: Registrar cuenta receptora
Validamos que la cuenta bancaria pertenezca al usuario verificado.
POST /v1/recipients
{
"user_id": "usr_98765",
"type": "bank_account",
"country": "CL",
"details": {
"bank_code": "001",
"account_number": "123456789",
"rut": "12.345.678-9"
}
}
Paso 2: Crear sesion off-ramp
POST /v1/offramp/sessions
{
"amount": "500.00",
"currency": "USDC",
"recipient_id": "rec_abc123"
}
Paso 3: Recibir fondos
La respuesta incluye una deposit_address. Monitorea esa direccion para confirmar el pago del usuario.
Velocidad y corredores
Los motores de liquidez de Linka permiten desembolsar moneda local casi inmediatamente despues de la finalidad on-chain.
| Pais | Riel | Liquidacion |
|---|---|---|
| Mexico | SPEI | Tiempo real 24/7 |
| Chile | TEF | Menos de 15 minutos |
| Colombia | ACH/PSE | Mismo dia |
| Brasil | PIX | Tiempo real 24/7 |
Errores comunes
- RUT, CLABE o datos bancarios no coinciden: si los datos no corresponden al usuario verificado, la transferencia queda en revision manual.
- Liquidez baja: para operaciones grandes, recomendamos usar la mesa OTC.
Webhooks
offramp.onchain_confirmed: los USDC/USDT llegaron a la wallet de Linka.offramp.disbursement_initiated: se envio la transferencia bancaria local.offramp.completed: el usuario recibio la moneda local.