Saltar al contenido principal

Gestión de Abonos y Notificaciones

El sistema de Abonos es el componente administrativo encargado de gestionar el flujo de efectivo hacia el ecosistema. A través de este módulo, se transforma el capital real en saldo operativo dentro del Wallet Virtual, permitiendo la ejecución de transacciones a través del API Connector.

1. Flujo Operativo de Abonos​

Abono a Cliente (Carga de Saldo)​

Se utiliza cuando un cliente adquiere saldo para operar sus propias recargas.

  • Proceso: El equipo interno registra el monto en la interfaz del Portal.
  • Impacto: El saldo del cliente se incrementa de forma inmediata en la base de datos PostgreSQL.
  • Notificación: El sistema dispara un correo electrónico automático al Cliente confirmando que su abono ha sido aplicado con éxito.

2. Diagrama de Notificaciones​

El flujo de comunicación está diseñado para mantener la transparencia y trazabilidad en cada movimiento:

3. El Wallet Virtual y la API​

El Wallet Virtual actúa como un sistema de prepago que interactúa directamente con el API Connector:

  1. Validación de Saldo: Antes de procesar cualquier recarga, la API verifica que el cliente tenga saldo suficiente en su Wallet.

  2. Descuento en Tiempo Real: Al confirmarse una recarga exitosa, el sistema debita automáticamente el monto del Wallet.

  3. Control de Errores: Si el saldo es insuficiente, la API rechazará la transacción con un código de error 400, evitando sobregiros en la cuenta del cliente.

4. Auditoría y Trazabilidad​

Para fines de seguridad y futura Conciliación, cada abono guarda los siguientes metadatos:

  • Timestamp: Fecha y hora exacta del registro.

  • Referencia: Comprobante o número de folio del depósito bancario.

  • Estado del Correo: Confirmación de que la notificación fue enviada exitosamente.