Pagos Masivos
Transferencias de Saldo a Escala
El módulo Pagos Masivos es una funcionalidad de alta eficiencia orientada a comercios que requieren ejecutar múltiples transferencias de saldo de manera simultánea hacia usuarios Payphone Personal o Payphone Business.
Su objetivo es optimizar la dispersión de fondos en escenarios operativos recurrentes como:
- Pago de nómina
- Liquidaciones a proveedores
- Bonificaciones e incentivos
- Reembolsos masivos
Esta herramienta elimina la ejecución manual de transacciones individuales, reduciendo riesgo operativo y tiempos de procesamiento.
Acceso y Requisitos del Sistema
Para utilizar el módulo, el comercio debe cumplir con las siguientes condiciones:
🔐 Perfil Autorizado
- Funcionalidad exclusiva para usuarios con rol Administrador dentro del comercio.
🏢 Permiso del Comercio
- El menú solo se habilita si el comercio tiene activado el permiso de Pagos Masivos por parte de Payphone.
🔗 Integración Técnica (Opcional)
- Si el comercio requiere automatización vía API, puede consultar la documentación oficial en Payphone Docs, donde se detallan endpoints, estructuras de datos y consideraciones de seguridad.
Gestión del Listado de Lotes
La pantalla principal del módulo centraliza el histórico de todos los lotes procesados, ya sea mediante:
- Carga manual de archivo CSV
- Integración automática vía API
Cada lote representa un conjunto de transferencias enviadas en una misma operación.
Componentes de la Tabla de Lotes
- Lote: identificador único asignado automáticamente al conjunto de transferencias.
- Fecha: momento exacto en que el lote fue ingresado al sistema.
- Estado: condición general del lote (no corresponde al estado individual de cada transacción).
- Total en archivo / Almacenado: comparativa entre:
- Registros enviados en el archivo
- Registros efectivamente procesados por el sistema
- Resultados: Resumen cuantitativo clasificado en:
- aprobadas
- canceladas
- pendientes de acreditación
- Acciones: ícono de visualización (👁) que permite acceder al detalle individual de cada movimiento dentro del lote.

Detalle y Auditoría de Transferencias
Al ingresar a un lote específico, el sistema muestra el comportamiento individual de cada transferencia.
Información Mostrada
- Fecha: fecha de ejecución de la transferencia.
- Identificador:
- RUC (para cuentas Business)
- Número telefónico (para cuentas Personal)
- Monto y Referencia: valor transferido y descripción registrada en el archivo.
- Estado de Transferencia:
- Éxito
- Error

Gestión de Errores
En caso de falla, el ícono de bug (🐞) permite visualizar el motivo técnico, por ejemplo:
- Usuario inexistente
- Número de teléfono inválido
- Saldo insuficiente
- Formato inválido
Esta vista permite auditoría operativa y trazabilidad completa del lote.

Pagos Masivos Manuales
(Carga CSV)
Este flujo permite ejecutar pagos sin requerir desarrollo técnico.
Paso 1: Preparación del Archivo
El sistema permite descargar una plantilla oficial para garantizar consistencia estructural.
Campos Requeridos:
- Identificador: teléfono (Personal) o RUC (Business)
- TipoCliente: B = Business / C = Personal
- Monto: valor decimal (ej. 10.50)
- Moneda: código ISO (ej. USD)
- Referencia: motivo o descripción del pago
Consideraciones técnicas:
- Formato CSV delimitado correctamente
- Sin caracteres especiales no soportados
- Validar estructura antes de cargar

Paso 2: Carga y Procesamiento

- Haga clic en Pagos Masivos.
- Seleccione su archivo mediante Seleccionar archivo.
- Ingrese una Referencia del lote (control administrativo interno).
- Presione Pagar.
El sistema validará la estructura antes de procesar el lote.
Paso 3: Protocolo de Seguridad
Para autorizar la salida de fondos, el sistema solicitará autenticación:
- "INGRESAR LA CONTRASEÑA PARA COMPLETAR LA TRANSFERENCIA"


Una vez validada la credencial:
- El sistema mostrará el estado “PAGOS MASIVOS - en proceso”
- Se redireccionará al listado principal para monitoreo
La acreditación puede ser inmediata o tomar algunos minutos según volumen y validaciones internas.
Escenarios Reales de Uso
- 🏢 Pagos a Proveedores
- Dispersión mensual de facturación a red de proveedores registrados como Payphone Business.
- 🎁 Incentivos y Bonificaciones
- Entrega masiva de bonos o recompensas a usuarios Payphone Personal.
- 🔄 Devoluciones
- Reembolso centralizado de saldos a múltiples clientes.
Beneficios Operativos
- Reducción de carga administrativa
- Minimización de errores manuales
- Control y auditoría por lote
- Seguridad mediante autenticación obligatoria
- Escalabilidad para altos volúmenes