VTOL EMVKIT - Manual de
...
mensajería POS - EMVKIT
...
Painel | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
...
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
Âncora | ||||
---|---|---|---|---|
|
...
El presente documento describe la mensajería que se utiliza entre el POS y la aplicación EMV/KIT.
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
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
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:
- Capturar el Track I y el Track II de la tarjeta por medio del PINPAD
- Capturar información del CHIP por medio del PINPAD
- Soporte de una variedad de PINPADS
- Identificar la tarjeta o proveedor
- Facilitar los datos de tarjeta encriptados, los cuales solo podrán ser desencriptados por VTOL Server o por el HOST autorizador según corresponda
- Facilitar el PAN enmascarado según normas PCI (solo visibles los primeros 6 y últimos 4 dígitos)
- Capturar el CVC por medio del PINPAD
- Capturar la fecha de vencimiento por medio del PINPAD en caso de que el ingreso sea manual
- Capturar el PIN por medio del PINPAD
- Capturar el tipo de cuenta por medio del PINPAD
- Evaluar bines de excepción
- Soportar modo de ingreso CHIP, BANDA y MANUAL
- Suministrar la configuración de VTOL Server a la aplicación de punto de venta (prefijos, tarjetas, cuotas, intereses, etc)
- Manejar contingencia entre PINPAD, caja y VTOL
- Comunicación entre aplicativo punto de venta y VTOL Server
- Resolver las reglas de negocio propias de cada PINPAD según el adquirente
- Funcionalidad de venta con cashback
- Funcionalidad de venta con puntos Bancomer (para soluciones con adquirente Bancomer)
- Soporte de operaciones de venta como devoluciones, anulación de venta
- Gestionar la mensajería con VTOL Server
Es responsabilidad de la aplicación de punto de ventas:
- La confirmación del monto
- El cálculo de promociones, la validación de plan de pago, la determinación de cuotas.
- 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.
...
# | Nombre | Req | Formato | Comentarios | ||
---|---|---|---|---|---|---|
6 | cardNumber | M | N16 | Número de tarjeta. Este valor es informado a la terminal pero no debe ser grabado en ningún lado para mantener las normas PCI, en caso de ser necesario el dato deberá enmascararse. | ||
10 | posInputMode | M | A | Es el modo de ingreso de la tarjeta: | ||
58 | loyaltyData | O | A | Únicamente para Bancomer: | ||
66 | track1 | M | A | Track1 de la tarjeta, es utilizado para obtener el "cardHolderName". Este campo no existe cuando el pago fue realizado en modo manual. | ||
125 | posAuthenticationMethod | O | A | Únicamente para Banamex y Bancomer: | ||
161 | cardType | O | A | Tipo de tarjeta, opcional si VTOL lo responde:
| ||
190 | comission | O | N12 | Campo Presente en caso de ser solicitada la configuración mediante el campo 218 en "cashAdvance", deberá enviarse luego un "additionalData". | ||
201 | additionalResponseCode | M | N2 | Código de respuesta generado por VTOL, actualmente VTOL lo reporta en el campo 27. | ||
202 | resetKeysOptional | O | A | Este campo indicará si el centro autorizador ha solicitado la carga de llaves opcionales. Valores:
| ||
204 | cardHolderName | O | A | Se reporta en el nombre del tarjeta habiente en caso de que exista. | ||
205 | aid | O | A | Card Application Identifier: | ||
206 | electronicSign | O | A | El valor "true" para este campo indica que se firmó electrónicamente el pago. | ||
207 | withoutSign | O | A | Para Bancomer: | ||
209 | acceptLoyaltyPoints | O | A | Uso solo para Bancomer. | ||
210 | providerName | O | A | El campo se encuentra presente si EMV/KIT se encuentra configurado para obtener configuración del "rsvtol.ini". | ||
211 | debit | O | A | El campo se encuentra presente si EMV/KIT se encuentra configurado para obtener configuración del "rsvtol.ini". | ||
212 | paymentPlanList | O | A | El campo se encuentra presente si EMV/KIT se encuentra configurado para obtener configuración del "rsvtol.ini". Ejemplo del campo con 1 solo plan de pago: “0|1” donde 0 es el plan y 1 la cantidad de cuotas. Ejemplo del campo con 2 planes de pagos: “0|1&1|12”, el primer plan de pago es plan 0 y cuotas 1; el segundo plan de pagos es plan 1 y cuotas 12. | ||
213 | cashBackAllowed | O | A | El campo se encuentra presente si EMV/KIT se encuentra configurado para obtener configuración del "rsvtol.ini". | ||
214 | applicationLabel | O | A(16) | Campo a ser impreso en el pagaré del tarjeta habiente. Se toma de la información obtenida del pinpad y podrá contener todos blancos. | ||
215 | preferredName | O | A(16) | Campo a ser impreso en el pagaré del tarjeta habiente. Se toma de la información obtenida del pinpad y podrá contener todos blancos. | ||
216 | criptograma | O | A(16) | Se infoma el criptograma a imprimir en el comprobante. | ||
217 | digitalSign | O | A (Hexadecimal) | Únicamente para Visanet/Paradox: | ||
221 | TVR | O | A | Únicamente para Banorte: Terminal Verification Results (Tag 95). | ||
222 | TSI | O | A | Únicamente para Banorte: Transactions Status Informations (Tag 9B). | ||
223 | expiryDate |
|
| Únicamente para Banorte: | ||
224 | Form Factor Ind | O | A | Únicamente para Banamex |
...