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.

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.

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.

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.

Integración con un IVR o con un Call center

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.

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.