Como integrar KYC en 15 minutos con la API de Inflow

La verificacion de identidad (KYC) es un requisito fundamental para cualquier empresa fintech que opere en Chile. La CMF exige procesos de debida diligencia robustos, y la API de Inflow permite cumplir con esos requisitos en minutos, no en semanas.

Por que importa la verificacion de identidad

Antes de otorgar credito, abrir una cuenta o procesar pagos de alto valor, necesitas confirmar que la persona es quien dice ser. En Chile, esto implica validar el RUT contra el registro civil, verificar el nombre completo y cruzar contra listas de control como el Servicio de Impuestos Internos.

El proceso manual es lento, propenso a errores y no escala. Con una API REST puedes automatizarlo completamente y tener resultados en menos de 200ms.

Autenticacion con OAuth2

La API de Inflow usa OAuth2 con credenciales de cliente. Primero obtienes un token de acceso y luego lo usas en todas las solicitudes:

const response = await fetch('https://api.inflow.cl/v2/auth/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    client_id: process.env.INFLOW_CLIENT_ID,
    client_secret: process.env.INFLOW_CLIENT_SECRET,
    grant_type: 'client_credentials'
  })
});

const { access_token } = await response.json();

El token tiene una validez de 3600 segundos. Implementa un cache sencillo para no pedir un token nuevo en cada request.

Consulta de identidad

Con el token listo, puedes consultar identidad usando nombre completo y opcionalmente el RUT:

const identity = await fetch('https://api.inflow.cl/v2/identity/search', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${access_token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    nombre: 'Juan Pablo Gonzalez Rojas',
    rut: '12345678-9'
  })
});

const data = await identity.json();

La respuesta incluye el estado de verificacion, datos de identidad validados y una puntuacion de confianza del 0 al 100.

Interpretacion de resultados

La API retorna un objeto estructurado con tres campos clave: verified (boolean), confidence_score (0-100) y identity_data con los campos validados. Un score sobre 85 indica identidad confirmada. Entre 60 y 85 requiere revision adicional. Bajo 60 es un rechazo recomendado.

Manejo de errores y rate limiting

La API respeta HTTP status codes estandar. El codigo 429 indica que alcanzaste el limite de requests. Implementa backoff exponencial con un maximo de 3 reintentos antes de fallar gracefully y notificar al equipo de operaciones.

Para entornos de produccion con alto volumen, contacta al equipo de Inflow para coordinar limites personalizados y un SLA apropiado para tu caso de uso.