VTOL - Documento Inicial de Instalación
1. Introducción
1.1 Acerca de este documento
El presente documento tiene como objetivo explicar a nivel macro los componentes de VTOL e informar la documentación correspondiente del componente VTOL para su instalación.
1.2 Diagrama macro
Diagrama de componentes
2. Componentes de VTOL
2.1 VTOL Server
Objetivo
VTOL Server es un gateway de transacciones en línea, especializado en la industria del retail y sus operaciones financieras. Posee varios módulos, el cual cada uno desempeña una funcionalidad.
El módulo Crédito Débito de VTOL es un validador de transacciones de autorizaciones.
VTOL Server está conformado por dos componentes:
- VTOL Admin: se encarga del frontend de la aplicación otorgando la consola VTOL Admin al usuario
- VTOL Engine: se encarga de la gestión del backend de la aplicación, recibiendo peticiones SOAP o REST desde aplicaciones que necesitan consumir los servicios ofrecidos por éste. Los servicios ofrecidos son mensajería, administración, reportes, etc.
Ambos componentes se ejecutan como proceso o como servicio.
Instalación y entorno
Existe la posibilidad de poseer VTOL Server en un servidor propio de la empresa (On-premise) como en la nube (Cloud).
VTOL Server corre sobre sistemas operativos Windows y Linux y los motores de base de datos soportados son MS SQL Server y Oracle.
2.1.1 VTOL On-premise
Cuando se instala VTOL en los servidores de una empresa, se deben tener las siguientes consideraciones:
- Precisa que la base de datos esté instalada idealmente en otro servidor al que está instalado VTOL
- El servidor que posea la base de datos de VTOL no tenga acceso a Internet o deberá estar en una LAN fuera del acceso remoto
- Argentina: VTOL CD AR - Guía de implementación 3.8.0.X
- Chile: VTOL CD CL - Guía de implementación 3.8.0.X
- México: VTOL CD MX - Guía de implementación 3.8.0.0
Este documento explica en detalle cómo instalar VTOL Server desde cero, cómo migrar o actualizar a una versión, cómo configurar la base de datos, cómo iniciar o detener la aplicación, información importante de PCI, consideraciones para instalar la aplicación, configuración inicial de la aplicación, etc.
2.1.2 VTOL Cloud
Cuando se hace uso de VTOL en la nube, un comerciante no debe efectuar ninguna instalación, simplemente accede a los datos de su compañía en VTOL mediante la consola de VTOL Admin.
- VTOL CD AR - Guía de implementación 3.8.0.X - Multiempresa
Este documento explica en detalle cómo instalar VTOL Server desde cero, cómo migrar o actualizar a una versión, cómo configurar la base de datos, cómo iniciar o detener la aplicación, información importante de PCI, consideraciones para instalar la aplicación, configuración inicial de la aplicación, etc.
2.2 Librería de integración
Objetivo
La librería de integración es un módulo cliente que se comunica vía TCP/IP con el servidor de transacciones VTOL. Gracias a este elemento, se establece un protocolo de comunicación para la interacción POS - VTOL, el cual se denomina "Protocolo VTOL".
Instalación y entorno
La integración se efectúa con la aplicación de punto de venta. En base al lenguaje de programación que sea el aplicativo de punto de venta se deberá integrar la librería de integración adecuada para dicho entorno:
- JAVA
- .NET
- VTOL CLIENT JAVA - Manual librería 1.1.10
Este documento explica la integración para entornos JAVA, como así también el protocolo VTOL en detalle, las políticas de implementación, las modalidades de la librería y ejemplos prácticos.
- VTOL CLIENT NET - Manual librería 2.0.x.x
Este documento explica la integración para entornos .NET, como así también el protocolo VTOL en detalle, las políticas de implementación, las modalidades de la librería y ejemplos prácticos.
2.3 EMV KIT
Objetivo
EMV Kit es una utilidad que simplifica la integración y la comunicación con el medio de pago de tarjetas abstrayendo a la aplicación de punto de venta de procesos como el manejo de pinpad, el reconocimiento de tarjetas, la comunicación e integración con VTOL Server, resolver problemas de contingencia, etc.
Instalación y entorno
Su instalación y ejecución se efectúa en cada punto de venta y no precisa de una base de datos para operar.
Puede ejecutarse como proceso o como servicio en una computadora.
- Argentina: VTOL EMVKIT AR 1.7.X
- Chile: VTOL EMVKIT CL 1.2.X
Este documento explica el funcionamiento del componente, su instalación y los mensajes soportados en la integración.
2.4 VTOL Customer
Objetivo
VTOL Customer ofrece el portal VTOL Customer del tipo web para que los comerciantes que posean VTOL puedan consultar todas las transacciones efectuadas, generar reportes, visualizar indicadores, descargar archivos de conciliación, monitorear el estado de conexión con los canales y comunicarse con el área de atención al cliente de VTOL.
Instalación y entorno
Su instalación se efectúa en un servidor y utiliza la base de datos de VTOL Server.
- VTOL Customer - Manual de instalación 3.8.0.0
Este documento explica la forma de instalar el componente, su configuración y la forma de acceder.
2.5 VTOL Payment Bridge
Objetivo
VTOL Payment Bridge ofrece el formulario de pago de VTOL Payment Bridge que es un componente web que permite a un sitio de e-commerce capturar los datos de la tarjeta y del tarjetahabiente, para luego autorizar, a través de VTOL Server, los pagos de compras realizadas en Internet.
Instalación y entorno
Su instalación se efectúa en un servidor y precisa de una base de datos propia, el motor de base de datos es MS SQL Server.
El balanceador de carga debe estar entre VTOL Payment Bridge y VTOL Engine.
- VTOL Payment Bridge - Manual de Instalación 3.8.0.X
Se explica la instalación del componente, la ejecución de los scripts de base de datos y cómo iniciar la aplicación.
2.6 VTOL Integration Service
Objetivo
VTOL Integration Service es una API REST ofrecida por VTOL para que un cliente REST pueda consumir datos pertinentes a las transacciones, conciliaciones, etc generadas por una compañía. Un e-commerce podrá acceder gracias a VTOL Integration Service a la funcionalidad de Link de Pago, una aplicación o un sistema de conciliación a las transacciones de conciliación y una aplicación, punto de venta o ERP podrá acceder a la configuración de opciones de pago de VTOL.
La forma de acceder podrá ser público como a través de una VPN.
Instalación y entorno
Su instalación se efectúa en un servidor y utiliza la base de datos de VTOL Server.
- VTOL Integration Service - Manual de instalación 1.0
Se informa en este documento los requisitos del sistema, cómo instalar VTOL Integration Service, cómo configurar la aplicación y cómo iniciar o detenerla.
2.7 VTOL Antifraude
Objetivo
VTOL Antifraude es un servicio API REST ofrecido por VTOL que permite la validación de operaciones crédito débito con el fin de validar por ciertas reglas la posibilidad de fraude en la operación. Las reglas de listas negras y acumuladores son definidas en la consola web de VTOL y son ejecutadas en cada petición, si se encuentra habilitado el antifraude en VTOL.
Instalación y entorno
Su instalación se efectúa en un servidor y utiliza una base de datos propia Mongo DB.
- VTOL Antifraude Service - Manual de instalación 1.0
Se especifica en este manual los requisitos del sistema, la forma de instalar el componente, cómo se configura, la generación de certificados y la forma de iniciar o detener la aplicación.
2.8 VTOL Direct
Objetivo
VTOL Direct es una aplicación de punto de venta que le permite a los retailers efectuar transacciones con tarjetas de débito y crédito gracias al uso de un pinpad. Además, el sistema puede comunicarse con impresoras para así entregar comprobantes de autorizaciones.
Instalación y entorno
Su instalación se efectúa en cada punto de venta y no precisa de una base de datos para operar.
- VTOL Direct - Manual de instalación 1.0
Este documento explica en detalle los requisitos de la aplicación, cómo instalar VTOL Direct, cómo iniciar o detener la aplicación y cómo efectuar la configuración inicial de la aplicación.
3. Integración de VTOL con otros productos
Cuando se realice una instalación de VTOL en un cliente, en donde se estarán integrados los productos de Napse PROMO y BRIDGE, para interactuar con VTOL, tener en cuenta que se debe instalar VTOL Integration Service
Para este tipo de integraciones, donde VTOL interactúa con PROMO o BRIDGE, estos sistemas obtienen los datos de opciones de pago configurados en VTOL a través del componente VTOL Integration Service. Por eso se debe instalar.