Image RemovedImage Added

VTOL EMVKIT - Manual de

...

mensajería POS - EMVKIT

...

Painel
borderColor #E4E3E3 bgColor #ffffff titleColor #ffffff borderWidth 1px titleBGColor #704581 title REVISIONES
Expandir title Expandir revisiones Fecha Versión Descripción 15/07/2014 1.00 Creación de documento 05/08/2014 1.01 Se agregan códigos de error. Se modifica información sobre el mensaje a "AdditionalData". 27/08/2014 1.02 Agregado Mensaje directo a VTOL 28/10/2014 1.03 Agregado AID a la respuesta 02/12/2014 1.04 Agregado CardType a la respuesta (campo 161) 15/04/2015 1.05 Ajustes para documento genérico 4/5/2015 1.06 Aclaraciones sobre obtención de bines en respuesta previo a la autorización 11/05/2015 1.07 Se agregan información referida a QPS y Puntos Bancomer. 18/06/2015 1.08 Se agregan datos adicionales en la respuesta obtenidos del rsvtol.ini, se agrega anexo A del campo 58 de Bancomer. 01/07/2015 1.09 Adaptación del documento EMVKit 08/07/2015 1.10 Documentación Cashback 30/07/2015 1.11 Documentación sobre firma digital 06/08/2015 1.12 Se elimina comentario sobre DVA original. 10/09/2015 1.13 Se habilita el campo 23 en el requerimiento del POS para autorizaciones offline. 28/09/2015 1.14 Se agrega funcionalidad de comisión para mensajes "CardPayment" y "CashAdvance" 05/10/2015 1.15 Aclaraciones CashAdvance y CardPaymernt 15/12/2015 1.16 Se agrega funcionalidad de "queryPan" 31/08/2016 1.17 Se agrega marca en Sale y Refund para indicar si nos encontgramos en modo mobile. 18/10/2016 1.18 Nuevos campos TVR y TSI para Banorte 18/10/2016 1.19 Nuevo mensaje de carga de bines a petición del usuario. 30/11/2016 1.20 Ajustamos comentarios de códigos de respuesta 09/01/2017 1.21 Se mejora documentación del campo 202. 03/02/2017 1.22 Agrego campo 223 a la respuesta de un Sale 05/07/2018 1.23 Se agrega campo 0 company en la mensajería 08/08/2018 1.24 Ajustes flujo mensajería PTService y PTPromotionQuery 30/11/2018 1.25 Actualizo Imagen 03/12/2018 1.26 Actualizamos PTService y PTPromotionQuery 26/12/2018 1.27 Se revisan nombres de los campos para servicio REST 19/02/2019 1.28 Consulta de puntos Bancomer (pointsLookup) 25/02/2019 1.29 Se elimina Anexo A, ya que se debe tomar la configuración de la documentación de Bancomer. 05/03/2019 1.30 Se agrega queryBin 31/05/2019 1.31 Se ajusta definición de campos en respuesta de Sale 02/12/2019 1.32 Actualizamos información de la firma, campos 125, 206 y 207 01/08/2020 1.33 Actualización Modo de Ingreso Contactless 28/09/2020 1.34 Agregamos campo 224 en respuesta de SALE para contactless.

...

Painel
borderColor #E4E3E3 titleColor #ffffff borderWidth 1 titleBGColor #704581 title CONTENIDO
Expandir title Expandir contenido Índice

Âncora
_Confirmación_de_solicitudes _Confirmación

...

El presente documento describe la mensajería que se utiliza entre el POS y la aplicación EMV/KIT.

_de_solicitudes

Âncora
_Solicitud_de_proveedores _Solicitud_de_proveedores

Âncora
_Toc473896822 _Toc473896822

Âncora
_Toc26185172 _Toc26185172

1. Introducción

El presente documento describe la mensajería que se utiliza entre el POS y la aplicación EMV/KIT.

1.1 Qué es EMVKIT?

EMVKIT 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 del PINPAD
• el reconocimiento de tarjetas (crédito/débito y otras, como vales, tarjeta regalo, etc)
• la comunicación e integración con Gateway de transacciones VTOL
• detectar y resolver problemas de contingencia
• etc

1.2 Arquitectura de la Librería

Image Added
Arquitectura general de EMVKIT

Como se observa en la imagen, EMVKIT se encarga de comunicarse con el PINPAD, desligando al aplicativo de punto de venta de dicha responsabilidad con el objetivo de simplificar la integración y con el Gateway de transacciones VTOL para procesar la autorización.
Esta librería se ejecutará de manera stand alone –autónoma– en el punto de venta, pudiendo iniciarse como servicio, transmitiendo una comunicación server TCP IP capaz de interpretar el protocolo VTOL. El mismo protocolo es utilizado para comunicarse con VTOL Server.
La integración entre la aplicación de punto de venta y EMVKIT será a través de la utilización de la librería cliente de VTOL, la que llamaremos librería cliente o librería liviana.
La aplicación de punto de venta solo debe incorporar esta librería liviana que le permitirá, mediante llamadas JAVA o .NET, construir los mensajes para comunicarse con EMVKIT.

1.3 Alcance

EMVKIT tiene el siguiente alcance:

1. Capturar el Track I y el Track II de la tarjeta por medio del PINPAD
2. Capturar información del CHIP por medio del PINPAD
3. Soporte de una variedad de PINPADS
4. Identificar la tarjeta o proveedor
5. Facilitar los datos de tarjeta encriptados, los cuales solo podrán ser desencriptados por VTOL Server o por el HOST autorizador según corresponda
6. Facilitar el PAN enmascarado según normas PCI (solo visibles los primeros 6 y últimos 4 dígitos)
7. Capturar el CVC por medio del PINPAD
8. Capturar la fecha de vencimiento por medio del PINPAD en caso de que el ingreso sea manual
9. Capturar el PIN por medio del PINPAD
10. Capturar el tipo de cuenta por medio del PINPAD
11. Evaluar bines de excepción
12. Soportar modo de ingreso CHIP, BANDA y MANUAL
13. Suministrar la configuración de VTOL Server a la aplicación de punto de venta (prefijos, tarjetas, cuotas, intereses, etc)
14. Manejar contingencia entre PINPAD, caja y VTOL
15. Comunicación entre aplicativo punto de venta y VTOL Server
16. Resolver las reglas de negocio propias de cada PINPAD según el adquirente
17. Funcionalidad de venta con cashback
18. Funcionalidad de venta con puntos Bancomer (para soluciones con adquirente Bancomer)
19. Soporte de operaciones de venta como devoluciones, anulación de venta
20. Gestionar la mensajería con VTOL Server

Es responsabilidad de la aplicación de punto de ventas:

1. La confirmación del monto
2. El cálculo de promociones, la validación de plan de pago, la determinación de cuotas.
3. Impresión del voucher y duplicado

En resumen, EMV/KIT se encargará de la comunicación con el Pinpad PINPAD y Vtol, autorizando pagos en línea y actualizando información en el PinpadPINPAD. El Pos enviará POSenviará requerimientos solicitando que se realicen pagos, los cuales será responsabilidad de EMV/KIT realizar todas las validaciones necesarias y comunicarse con todos los componentes para responder al Pos si POSsi el pago se pudo realizar o no, y el motivo de error.

...

...