Cobranza centralizada para IFI, con acceso web y APIs seguras

Este dummy muestra una version moderna, limpia y sobria del sistema. Se prioriza un flujo corto para cajero, bloqueo transaccional para evitar doble cobro, trazabilidad total y aislamiento entre instituciones financieras.

Consulta por cedula Pago exacto obligatorio Reverso auditado Token e IP por IFI
IFI autenticada Banco Horizonte
Canal activo Web caja + API conciliacion
Estado del servicio Operativo y auditado

Resumen operativo

La plataforma comparte el estado global de las deudas, pero mantiene separados por IFI los usuarios, credenciales, logs, reportes internos y conciliaciones.

IFI conectadas 24
Consultas auditadas hoy 18,492
Cobros confirmados 3,148
Intentos duplicados bloqueados 11

Consulta de cliente y registro de cobro

El cajero digita la cedula, el sistema valida la IFI por token e IP, consulta la deuda global y solo habilita el cobro por el valor exacto exigible.

Busqueda operativa

Campos minimos para caja, conciliacion y trazabilidad por usuario.

Consulta lista. Este demo simula bloqueo transaccional, validacion por IFI y respuesta unificada del estado de deuda.

Politicas criticas

Pago exacto El monto recibido debe coincidir exactamente con el total exigible del cliente.
Estado global Cuando una IFI confirma el cobro, la deuda desaparece para el resto de instituciones.
Trazabilidad Toda consulta y todo pago quedan auditados con IFI, usuario, IP, canal y respuesta.
Notificaciones Si el cliente tiene email, se dispara correo de pago o reverso.
Cliente con deuda vigente

Cuzco Torres Luis Medardo

Cedula 0101714392 · Correo registrado: l.cuzco@email.com · Estado de contacto: habilitado

Numero de deuda DB-2026-000702
IFI que consulta Banco Horizonte
Fecha de consulta 17-04-2026 09:20
Politica de cobro Solo total exacto
Documento Concepto Fecha Total Saldo Estado
FE015024 Consumo febrero 2026 27-02-2026 $ 4.35 $ 4.35 Pendiente
FE016652 Consumo marzo 2026 + tasa ambiental 31-03-2026 $ 5.65 $ 5.65 Pendiente

Cobro de caja

El demo impide montos parciales o superiores y deja visible la respuesta esperada para operadores y para integraciones.

Total exigible $ 10.00
Listo para cobrar. Si el monto coincide, el sistema confirmara el pago, marcara la deuda como cancelada globalmente y enviara correo al cliente.

Seguridad, aislamiento y control transaccional

La solucion separa el contexto operativo de cada IFI, pero comparte el estado de la deuda para evitar inconsistencias y doble recaudo.

Aislamiento por IFI

Usuarios y roles independientes Cada IFI administra sus cajeros, supervisores, perfiles y sesiones.
Credenciales ligadas a la IFI El token o API key pertenece a una sola IFI y puede rotarse sin afectar a las demas.
Logs segmentados Cada IFI solo accede a su propia trazabilidad, consultas, cobros, reversos y conciliacion.
Whitelist opcional por IP La integracion puede restringirse por sucursal, VPN o segmento autorizado.

Controles contra doble cobro

1. Consulta
La IFI consulta la deuda y recibe el total exigible con sello de tiempo.
2. Lock transaccional
Al registrar pago, la deuda se bloquea para evitar dos confirmaciones simultaneas.
3. Confirmacion atomica
Se registra pago, se actualiza estado global y se escribe auditoria en una misma transaccion.
4. Idempotencia
Si la API reintenta con la misma llave, el sistema devuelve el resultado original sin duplicar el cobro.

APIs para automatizacion

Las IFI pueden integrar consulta, cobro y reverso desde sus sistemas. El token siempre queda asociado a la IFI que ejecuta la transaccion.

Contratos principales

POST /api/v1/debts/query Recibe cedula y retorna deuda vigente o mensaje de sin deuda.
POST /api/v1/payments/register Registra cobro con monto exacto, referencia externa e idempotency key.
POST /api/v1/payments/reverse Revierte pago con control de permisos, motivo y auditoria.
GET /api/v1/payments/:externalReference Consulta estado de una transaccion conciliada.

Ejemplo de request de cobro

{
  "financialInstitutionCode": "BH001",
  "nationalId": "0101714392",
  "debtNumber": "DB-2026-000702",
  "amount": 10.00,
  "paymentMethod": "cash",
  "externalReference": "IFI-BH-20260417-000128",
  "idempotencyKey": "c9ab0b92-17c1-4985-a84f-542d7b51c001",
  "cashierCode": "KVQ-014",
  "depositReference": "DEP-998712"
}

Respuesta funcional cuando otra IFI consulta un cliente ya pagado

{
  "hasDebt": false,
  "message": "Cliente no tiene deudas pendientes al dia de hoy",
  "nationalId": "0101714392",
  "checkedAt": "2026-04-17T09:24:10Z",
  "financialInstitutionCode": "CSN002"
}

Auditoria, reversos y reportes

Cada acceso, consulta, cobro, error o reverso debe dejar evidencia rastreable por IFI, usuario, canal, IP y referencia transaccional.

Bitacora operativa

Fecha IFI Usuario Evento Resultado
17-04-2026 09:20 Banco Horizonte KVQ-014 Consulta por cedula 0101714392 Auditado
17-04-2026 09:21 Banco Horizonte KVQ-014 Validacion IP 181.39.24.10 Permitido
17-04-2026 09:21 Banco Horizonte KVQ-014 Preparacion de cobro exacto En curso

Reportes elegibles

Reporte por cliente Historial de consultas, cobros, reversos y notificaciones.
Reporte por usuario Actividad del cajero, monto recaudado y acciones auditadas.
Reporte por IFI Consolidado de operaciones y conciliacion interna de la institucion.
Reporte de incidencias IP rechazadas, tokens invalidos, reintentos y reversos.

Referencia visual del sistema heredado

Estas capturas se mantienen dentro del demo para mostrar el punto de partida. La propuesta nueva conserva la esencia operativa, pero mejora claridad, seguridad y presentacion.

Pantalla original de cobros
Vista heredada de cobro con detalle de conceptos, cajero, forma de pago y total a recaudar.
Busqueda original de abonado
Vista heredada de busqueda de abonado. Inspiracion funcional para el flujo de consulta por cedula.
Demo HTML standalone para presentacion funcional de `Cobranza Linked`.