Vana - Préstamos confiables: integración API y servicios de datos OpenFinance

API de solicitud de crédito

Espejo programático de la solicitud crediticia in-app: perfil del solicitante, monto requerido (L 700–L 7,000), selección de plazo (90–360 días), código de producto, respuesta de decisión y timestamp de aprobación.

Caso de uso: replicar el flujo de "respuesta en minutos" de Vana en un canal asociado (por ejemplo, onboarding asistido por agente) manteniendo un registro unificado del préstamo.

API de pagos y comprobantes

Captura eventos de depósito en efectivo y de transferencia electrónica más referencias a fotos de comprobantes para que el ledger del prestamista cuadre con los movimientos bancarios. Devuelve estados settled, pending y reversed.

Caso de uso: alimentar la contabilidad (declaraciones SAR) y disparar la lógica de elegibilidad para el siguiente préstamo que Vana habilita tras un pago a tiempo.

Sincronización KYC y perfil

Exporta el perfil de identidad verificado y el resultado de tamizaje AML/PEP usado durante el onboarding (consistente con las obligaciones URMOPRELAFT) para poblar bóvedas KYC downstream sin volver a preguntar al cliente.

Caso de uso: un buró de crédito o un prestamista socio que quiere reutilizar el KYC verificado de Vana para venta cruzada de productos.

API de límite crediticio e historial de productos

Rastrea cómo el límite del prestatario avanza hacia los L 7,000 a lo largo de los ciclos, incluidas las comisiones de desembolso (L 65–L 2,106 + IVA) y la TAE máxima de 32.4%, para que los equipos de analítica calculen valor de vida y rendimiento ajustado al riesgo.

Caso de uso: dashboards de cohortes mensuales, modelos de LTV y disparo de ofertas de refinanciamiento.

Señales con datos alternativos

Vana declara públicamente que usa datos no tradicionales y ML para evaluar a usuarios sin relación bancaria formal. Este módulo expone una copia autorizada y consentida de las señales de dispositivo, comportamiento y origen de canal que alimentan el scoring — nunca PII en bruto sin consentimiento.

Caso de uso: mejora de riesgo entre carteras, detección de redes de fraude y features de underwriting reutilizables.

Webhook y bus de eventos

Push en tiempo real para application_submitted, decision_returned, disbursement_completed, repayment_received, limit_increased, account_blocked. Reintentos configurables, payloads firmados, claves de idempotencia y manejo de cola DLQ.

Caso de uso: empujar eventos frescos a un pipeline de streaming (Kafka / PubSub) o a un canal de operaciones en Slack/Teams.

1. Bucle completo prestamista-CRM

Contexto de negocio: una cooperativa de crédito asociada quiere rastrear a los prestatarios de Vana que también son sus clientes, sin duplicar el onboarding.

Datos y APIs: sincronización KYC + solicitudes de crédito + ledger de pagos, unidos por hash del documento de identidad.

Mapeo OpenFinance: alineado con el patrón LatAm de "portabilidad de datos con consentimiento" impulsado por Open Finance Brasil y el marco obligatorio colombiano de junio de 2025 — aplicado de forma conservadora para Honduras mientras la regulación local se formaliza.

2. Contabilidad y reportes alineados al SAR

Contexto de negocio: el equipo financiero necesita un ledger limpio de desembolsos, comisiones (L 65–L 2,106), IVA y reversos para el cierre mensual y la presentación al SAR.

Datos y APIs: disbursement_events + repayment + metadatos de comprobante enviados al ERP (Odoo, SAP B1, NetSuite) vía webhooks firmados.

Mapeo OpenFinance: coincide con la categoría "transactions / statements" de las especificaciones OpenBanking (Open Finance Brasil §IV, UK CMA9), adaptado a la posición de prestamista no bancario hondureño.

3. Intercambio de scoring con datos alternativos

Contexto de negocio: un consorcio fintech regional quiere compartir features de underwriting consentidas (antigüedad del dispositivo, cadencia de pago, mix de canales) para reducir el default en segmentos de historial fino.

Datos y APIs: exportación de señales alternativas + historial de límite crediticio, expuestos como vectores de features sobre una API versionada.

Mapeo OpenFinance: una adyacencia de "credit / risk data" en Open Finance, consistente con la forma en que las hojas de ruta latinoamericanas tratan los datos de crédito una vez asentados los datos de pagos.

4. Crédito embebido en apps socias

Contexto de negocio: una app retail o de remesas quiere ofrecer crédito "pay later" usando el underwriting de Vana en segundo plano.

Datos y APIs: loan_application_create + webhook decision_returned + disbursement_status, encapsulados detrás de la UI del socio.

Mapeo OpenFinance: equivalente a flujos BaaS / embedded finance, con Vana como prestamista regulado de registro bajo SAR / URMOPRELAFT.

5. Analítica transfronteriza de cartera

Contexto de negocio: un holding opera prestamistas en Honduras, Guatemala, Perú y República Dominicana y quiere una vista unificada de cartera.

Datos y APIs: exportaciones etiquetadas por país de solicitudes, pagos y movimientos de límite, normalizados a un esquema único.

Mapeo OpenFinance: no es transfronterizo regulado, pero usa las mismas abstracciones OpenData para enchufarse luego a APIs Open Finance formales conforme estos mercados maduren.

Auth: intercambio de token (pseudocódigo)

POST /api/v1/vana/auth/token
Content-Type: application/json

{
  "client_id": "studio-partner-01",
  "client_secret": "<OPAQUE>",
  "scope": "loans.read repayments.read kyc.read",
  "country": "HN"
}

200 OK
{
  "access_token": "eyJhbGciOi...",
  "expires_in": 1800,
  "token_type": "Bearer",
  "consent_id": "csnt_2025_HN_4a91"
}

Exportación de solicitudes de crédito (pseudocódigo)

GET /api/v1/vana/loans?country=HN&from=2026-01-01&to=2026-04-28&status=approved
Authorization: Bearer <ACCESS_TOKEN>
X-Consent-Id: csnt_2025_HN_4a91

200 OK
{
  "page": 1, "page_size": 50, "total": 712,
  "items": [
    {
      "loan_id": "ln_HN_8821",
      "applied_at": "2026-04-12T14:33:11Z",
      "amount_requested": 7000.00,
      "amount_approved": 5000.00,
      "currency": "HNL",
      "term_days": 90,
      "product_code": "VN-HN-90D",
      "fees_total": 749.00,
      "vat": 112.35,
      "apr_max_pct": 32.4,
      "decision": "APPROVED",
      "limit_max_hnl": 7000.00
    }
  ]
}

Webhook de pagos (pseudocódigo)

POST <partner_url>/webhooks/vana
X-Vana-Signature: t=1714291800,v1=8c1a...
Idempotency-Key: evt_rp_91a4b2

{
  "event": "repayment_received",
  "loan_id": "ln_HN_8821",
  "paid_at": "2026-04-27T18:02:55-06:00",
  "amount_paid_hnl": 7938.00,
  "channel": "ELECTRONIC_TRANSFER",
  "receipt_ref": "rcpt_2026_HN_18f3",
  "status": "SETTLED",
  "next_loan_eligible": true
}

// Verify HMAC: signature == HMAC_SHA256(secret, "<timestamp>.<raw_body>")
// On 5xx the platform retries with exponential backoff up to 24h.

Manejo de errores e idempotencia

Todos los endpoints devuelven un envoltorio de error estable: {"code":"RATE_LIMITED","message":"...","retry_after":12}. Los reintentos en 429 / 5xx usan backoff exponencial con jitter. Cada llamada mutante acepta un Idempotency-Key para que los socios puedan reproducir desembolsos y pagos sin doble conteo.

Para exportaciones largas ofrecemos paginación (cursor + total) y un modo de job asíncrono (job_id, endpoint de polling) para que las extracciones históricas grandes no bloqueen la integración.

Sobre nuestro estudio

Somos un estudio técnico independiente especializado en integración de interfaces de App, integración API autorizada y adaptadores OpenData / OpenFinance / OpenBanking. Nuestro equipo tiene experiencia práctica en aplicaciones móviles y fintech en LatAm, UE y APAC.

• Análisis de protocolos de apps Android e iOS, con un sólido historial en stacks fintech latinoamericanos en español.
• Integraciones API autorizadas para préstamos, pagos, e-commerce, hospitalidad y clientes OTT.
• Entrega "compliance-first": mapeamos cada integración a las reglas locales (SAR / URMOPRELAFT para Honduras, más referentes Open Finance de Brasil y Colombia).
• Dos modelos de contratación — código fuente desde $300, pago tras conformidad, o API hospedada por consumo sin pago inicial.
• Entregables: especificación OpenAPI/Swagger, código fuente Python/Node.js ejecutable, pruebas automatizadas, guía de despliegue y memorando de cumplimiento.

Contacto

Envíanos tu app objetivo (Vana - Préstamos confiables en este caso), el alcance de datos que necesitas y cualquier credencial existente o acceso a sandbox. Responderemos con una cotización a precio fijo o con un plan por consumo.

Abrir página de contacto

Para Vana, los usuarios finales pueden escribir a soporte@vana.hn o entrar a vana.hn — el estudio es independiente y solo provee servicios de integración sobre datos autorizados.

Flujo de trabajo de contratación

1. Confirmación del alcance: qué datos de Vana (préstamos, pagos, KYC, datos alternativos), qué mercados (HN, GT, PE, DO) y qué sistemas destino.
2. Autorización y revisión legal: flujos de consentimiento, scopes, ventanas de retención y alineación con SAR/URMOPRELAFT.
3. Análisis de protocolos y diseño del adaptador (típicamente 3–6 días hábiles).
4. Construcción, validación interna y pruebas de carga (4–9 días hábiles).
5. Documentación, consumidor socio de muestra y pruebas automatizadas (1–2 días hábiles).
6. Entrega, ventana de soporte y hospedaje opcional por consumo.

Preguntas frecuentes

¿Qué necesitas para empezar?

¿Esto es un "scraper"?

¿Qué tan rápido es la entrega?

¿Cubren las operaciones de Vana en Guatemala, Perú y República Dominicana?

¿Qué ocurre si Honduras formaliza Open Finance?