VTOL - Documento Inicial de Integración
1. Introducción
1.1 Acerca de este documento
El presente documento tiene como objetivo ofrecerle a nuestros clientes una guía inicial de integración.
Se explicará en éste espacio los diferentes tipos de integraciones que pueden existir entre un punto de venta y VTOL Server y la manera a integrarse con VTOL.
1.2 Qué es una Integración?
Una integración es el proceso que ofrece como resultado la comunicación de un punto de venta con el producto VTOL.
Los puntos de venta pueden ser:
- físicos (como terminales en comercios)
- virtuales (como comercios electrónicos o ventas telefónicas).
Para obtener una integración, es preciso realizar un esfuerzo de desarrollo en el punto de venta que posea el retailer.
1.3 Arquitectura de Integraciones
La siguiente gráfica muestra las integraciones mediante la interacción de:
- Los componentes propios del retailer (en celeste)
- Los componentes VTOL de Napse (en verde)
- Los componentes autorizadores externos (en rojo)
Arquitectura macro de las diversas integraciones
2. Integraciones
En esta sección se explicará cada tipo de integración según la operatoria y se hará referencia a qué documentación referirse.
Ambiente de Tarjeta Presente
- Si el origen del procesamiento se efectuará desde un punto de venta físico, dirigirse al apartado 2.1 POS Físico
Ambiente de Tarjeta No Presente
- Si el origen del procesamiento se efectuará mediante venta telefónica (IVR o Call Center), dirigirse al apartado 2.2 IVR o Call Center
- Si el origen del procesamiento se efectuará desde un e-commerce, dirigirse al apartado 2.3 E-Commerce
2.1 POS Físico
La comunicación entre puntos de venta físicos y VTOL Server se realizará mediante el componente EMV Kit. Este componente desarrollado en Java abstrae al aplicativo de punto de venta de procesos significativos como el manejo del pinpad o la comunicación e integración con VTOL Server.
Gracias a este componente, el aplicativo de punto de venta evita tener que ser PCI Compliance.
Existirá un EMV Kit según el país: Argentina o Chile; cada uno de ellos, se comunicará con el VTOL Server del mismo país (Argentina o Chile).
En la documentación de EMV Kit se mencionan los campos de requerimiento que el punto de venta le tendrá que enviar al componente EMV Kit y los campos de respuesta que el POS recibirá del EMV Kit, siempre explicado para cada operación.
El documento variará dependiendo del país.
- VTOL - Librería integración EMV Kit AR (Argentina)
Este documento explica en detalle el componente EMV Kit de Argentina y especifica la instalación e integración con VTOL Server Argentina
- VTOL - Librería integración EMV Kit CL (Chile)
Este documento explica en detalle el componente EMV Kit de Chile y especifica la instalación e integración con VTOL Server Chile
- VTOL - Librería integración EMV Kit (Excepto Argentina y Chile)
Este documento explica en detalle el componente EMV Kit y la integración con VTOL Server (Todos los países, excepto AR y CL)
Para poder comunicarse con el componente EMV Kit, el punto de venta deberá integrarse con la Librería Liviana. Este componente del tipo cliente permite establecer un protocolo de comunicación TCP/IP, denominado "Protocolo VTOL", para la interacción con VTOL.
La versión por instalar de la Librería Liviana variará según el entorno de desarrollo o el lenguaje de programación en que esté realizado el aplicativo de punto de venta, las versiones disponibles son Java y .NET.
El documento variará dependiendo del entorno de desarrollo del POS.
- VTOL CLIENT JAVA - Manual librería
Este documento es exclusivo para los entornos Java
- VTOL CLIENT NET - Manual librería
Este documento es exclusivo para los entornos .NET
Integración con un punto de venta físico
2.2 IVR o Call Center
Un IVR (Interactive Voice Response) o un call center se integra a VTOL Server mediante la Librería Liviana. Este componente del tipo cliente permite establecer un protocolo de comunicación TCP/IP, denominado "Protocolo VTOL", para la interacción con VTOL.
La versión por instalar de la Librería Liviana variará según el entorno de desarrollo o el lenguaje de programación en que esté realizado el IVR o el aplicativo de call center, las versiones disponibles son Java y .NET.
El documento variará dependiendo del entorno de desarrollo del POS.
- VTOL CLIENT JAVA - Manual librería
Este documento es exclusivo para los entornos Java
- VTOL CLIENT NET - Manual librería
Este documento es exclusivo para los entornos .NET
La implementación que se tendrá que realizar con el componente Librería Liviana será del tipo VirtualVTOLClient, ya que se permitirá operar con nodos virtuales donde VTOL será quien gestione automáticamente la asignación de las cajas.
En la documentación de la mensajería de VTOL se mencionan los campos de requerimiento que el IVR o call center le tendrá que enviar a VTOL y los campos de respuesta que el IVR o call center recibirá de VTOL, siempre explicado para cada operación.
El documento por consultar variará según el módulo de VTOL con el que se quiera integrar.
- VTOLCR-DB-Manual mensajería POS - VTOL AR
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Crédito Débito Argentina
- VTOLCR-DB-Manual mensajería POS - VTOL CL.pdf
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Crédito Débito Chile
VTOL CD MX - Manual mensajería POS - VTOL MX
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Crédito Débito México
VTOL CD DO - Manual mensajería POS - VTOL DO
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Crédito Débito República Dominicana
VTOL CD CA - Manual mensajería POS - VTOL CA
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Crédito Débito Centroamérica
VTOL CD PA - Manual mensajería POS - VTOL PA
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Crédito Débito Panamá
VTOL CD PE - Manual mensajería POS - VTOL PE (English)
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Crédito Débito Perú
- VTOL Monedero - Manual mensajería POS – VTOL.pdf
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Monedero
- VTOL TAE - Manual mensajería POS - VTOL
Este es el documento en el que se detalla la mensajería entre el POS y VTOL Tiempo Aire Electrónico
Integración con un IVR o con un Call center
Nota: Es requisito fundamental que el sistema IVR o el sistema del call center cumpla con la normativa PCI DSS.
2.3 E-commerce
Para integrarse a VTOL desde un eCommerce o tienda electrónica desde un sitio web, existen dos formas:
- Utilizando el componente web VTOL Payment Bridge. Gracias al mismo, el comercio no necesita ser PCI Compliance.
- Si el comercio posee su propio formulario de captura de datos de tarjeta (para lo cual debe estar certificado bajo las normas PCI DSS) enviará los datos directamente a VTOL Server.
El documento por consultar variará según el módulo de VTOL con el que se quiera integrar.
Este documento explica la integración con el componente VPB. Para implementar esta API, no es necesario que el comercio esté certificado bajo las normas PCI.
Este documento explica la integración directa con VTOL Server. Para implementar esta mensajería, el comercio debe estar certificado bajo las normas PCI.
Integración con VPB
Integración directa con VTOL Server
3. Entornos de prueba
Para que nuestros clientes puedan cumplir de forma satisfactoria con la integración, Napse ofrece los siguientes entornos de prueba y herramientas:
- Una instancia de VTOL totalmente configurada en los servidores de Napse para que se pueda comunicar mediante una IP y puerto.
- Emuladores de Pinpad (Visa, Posnet, Ingénico) para no pausar la integración hasta que se cuente con los dispositivos.
- Emuladores de Centros Autorizadores (Visa, Posnet, AMEX, Link, etc) para autorizar las transacciones.
- Números de tarjetas de pruebas (tracks, claves, PAN) para efectuar ingresos manuales.
Por favor, ponerse en contacto con Napse para gestionar estas herramientas.