Zumpago
ISPCube posee integración con la pasarela de pagos automáticos «Zumpago».
En este documento detallaremos su proceso de configuración para que puedas procesar los pagos de tus clientes.
Lo primero que vas a tener que hacer es ingresar al formulario de configuración del medio de pago. Para ello, ingresa a Pagos | Configuración y, una vez que estés dentro del apartado, busca dentro del sector pasarelas de pago, «Zumpago» .
Una vez localizada haz click sobre el ícono «Editar» para acceder a su formulario de configuración.
Recordatorio: ISPCube es un sistema multiempresa, podrás configurar hasta cinco empresas distintas.
Esto tiene impacto en la configuración de los medios de pago, ya que será factible configurar una cuenta distinta para cada empresa.Ejemplo: el ISP posee dos empresas configuradas en el sistema, al momento de configurar el medio Zumpago, visualizará dos tabs, Zumpago 1 y Zumpago 2. En cada uno de esos tabs, se encontrará el formulario de configuración del medio de pago. También podrá optar por configurar una sola cuenta Zumpago y asignarla a todas sus empresas, desestimando el segundo tab.
¡Importante!
Al completar y guardar la información del formulario, no te olvides de activar el switch «Activar Zumpago 1» (inciso 20) para poder comenzar a utilizarlo.
Nota: esta imagen se relaciona a un escenario en el que existen configuradas dos empresas dentro de ISPCube, por ello se visualiza Zumpago 1 y Zumpago 2.
A continuación definiremos los elementos que conforman este formulario:
1) Zumpago 1. Pestaña que contiene el formulario de configuración de «Zumpago 1».
Recuerda que vas a tener disponibles tantos tabs como empresas tengas configuradas en ISPCube.
2) Zumpago 2. Pestaña que contiene el formulario de configuración de «Zumpago 2». Recuerda que vas a tener disponibles tantos tabs como empresas tengas configuradas en ISPCube.
3) Comisión. Comisión pactada con la entidad por la prestación del servicio. Completando este valor, podrás ver reflejado en el tablero de finanzas la comisión cobrada por la entidad. Este campo es de carácter opcional.
4) Código del comercio. Código o identificador de comercio asignado por Zumpago. Este dato lo brinda el medio de pago.
5) Llave para encriptar el código. LLave para encriptar el código asignada por Zumpago. Este dato lo brinda el medio de pago.
6) Llave para encriptar el XML. LLave para encriptar el XML asignada por Zumpago. Este dato lo brinda el medio de pago.
7) Asociar medios de pago. Este campo permite activar o desactivar los canales de pago que estarán disponibles para los clientes al momento de realizar un pago.
Nota. Los canales que pueden gestionarse desde aquí son los que el ISP haya acordado previamente con Zumpago. Si se solicitaron todos los canales que ofrece Zumpago, se pueden marcar todos en este selector.
En caso de que posteriormente se desee dejar de utilizar alguno, basta con desmarcarlo: no es necesario contactar nuevamente a Zumpago. Con eso, el canal dejará de estar disponible para los clientes.
8) Modo testeo. Permite setear credenciales de prueba para realizar pruebas internas. Esta opción debe estar configurada en NO al momento de pasar a producción. Este campo se habilita cuando se activa el botón de pago en el portal de clientes y/o en la app móvil.
9) Generar a todos los clientes. Creará un código de Datafast independientemente de la entidad asignada al cliente puntual.
10) Empresa/s asociada/s. Define cuál de tus empresas asociar a la cuenta Zumpago que estás configurando. Vas a poder asociar múltiples empresas a una misma cuenta, pero no será posible configurar distintas cuentas del mismo medio a una misma empresa.
11) Alias. Podrás ingresar un alias para la cuenta de Zumpago que estás configurando, para identificar la misma dentro del sistema. Este campo es de carácter opcional.
12) Generar botón de pago en el portal cliente. Si activas este switch, podrás incluir el botón de pago de Zumpago en el portal de clientes. Al activarlo verás un nuevo campo (punto 14) donde deberás seleccionar el monto a cobrar con el botón de pago: Deuda total / Importe factura / Libre.
13) Generar botón de pago en la app móvil. Si activas este switch, podrás incluir el botón de pago «Zumpago» en la app de clientes. Al activarlo verás un nuevo campo (punto 14) donde deberás seleccionar el monto a cobrar con el botón de pago: Deuda total / Importe factura / Libre.
14) Recaudo con botón de pago. Esta herramienta se habilita si activaste el botón de pago en el portal y/o la app móvil. Permite seleccionar el monto a recaudar con el botón de pago: Deuda total / Importe factura / Libre.
– Deuda Total: Permite al cliente abonar el monto total de su deuda.
– Importe Factura: Permite al cliente abonar el importe de su última factura mensual.
– Libre: Esta opción permite al cliente elegir el saldo a abonar, ya sea la deuda vencida, el importe de la última factura, el total o ingresar un monto manual. Todas estas opciones se configuran en un campo adicional, que se habilita al seleccionar «Libre»:
15) Habilitar Webhooks. Deberás habilitar este switch para que los pagos recibidos impacten en el sistema. Al hacerlo se generará una URL que deberás cargar en la plataforma de Zumpago. Ver punto 16.
16) URL Webhooks. Este campo muestra la URL que debes copiar y configurar en el dashboard de Zumpago. Es la dirección a la que Zumpago enviará las notificaciones sobre el estado de los pagos. Cuando un pago se confirma exitosamente, esta URL permite que el sistema registre automáticamente la transacción en la base de datos del cliente.
17) URL para notificaciones. Es la dirección a la que el cliente será redirigido después de completar el pago. En esta URL se le informará el estado del pago, permitiéndole confirmar si fue procesado correctamente.
18) Nombre para mostrar. Podrás asignarle un nombre al medio de pago, para incluir en tus plantillas. La variable asociada será «%entity_display_name%». Este campo es de carácter opcional.
19) Configurar. Guarda los parámetros configurados.
20) Activar. Activa el medio de pago para comenzar a utilizarlo. Caso contrario, quedará configurado el formulario pero no tendrá impacto en el sistema.
Una vez configurada y habilitada la entidad, figurará «Zumpago» en el menú lateral del módulo «Pagos»:
.
Este medio no requiere generación de archivo:
Este medio no precisa que realices ninguna acción para ejecutar los recaudos. Si aún no lo hiciste, recuerda que puedes agregar el botón de pago que ofrece Zumpago en el portal de clientes y en la app móvil.
.
Carga manual archivo de recaudos:
Zumpago ofrece un archivo de conciliación que podrás solicitar por correo electrónico. Este archivo puede utilizarse como control adicional para validar que todos los pagos hayan sido procesados correctamente, y también como respaldo en caso de que algún pago no se haya registrado mediante los Webhooks. Los pagos ya cargados aparecerán como procesados, y solo se insertarán aquellos que aún no se hayan registrado.
¡Importante! La ejecución automática de recaudos y la carga manual del archivo son métodos compatibles, por lo que no se duplicarán los pagos, incluso si se utilizan ambos de forma simultánea.
.
A continuación desarrollaremos los elementos que componen la carga manual de recaudos de Zumpago:
- Cargar recaudos
- Panel lateral
.
.
1. Cargar recaudos
Dentro de la solapa de recaudos se podrá cargar el archivo proporcionado por Zumpago:
- a. Cargar archivo de recaudos. Este botón permite cargar el archivo, el mismo debe tener un formato .txt:
.
Una vez subido el archivo, los recaudos exitosos quedarán registradas en el listado de «Finanzas > Caja» y en esta pestaña podrás visualizar un resumen del proceso. Si algún pago no pudo ser asociado a un cliente, lo podrás gestionar desde «Pagos > Pagos sin asociar».
.
2. Panel lateral
En esta columna podrás ver y, si es necesario, editar los datos configurados de la entidad:
- a. Botón desplegar. Muestra/oculta un resumen de los datos configurados de la entidad.
- b. Editar configuración. Permite acceder a la configuración de la entidad para editar su información.