Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.



Image RemovedImage Added




VTOL EMVKIT - Manual de

...

mensajería POS - EMVKIT

...





Painel
borderColor#E4E3E3
bgColor#ffffff
titleColor#ffffff
borderWidth1px
titleBGColor#704581
titleREVISIONES


Expandir
titleExpandir 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
borderWidth1
titleBGColor#704581
titleCONTENIDO


Expandir
titleExpandir contenido

Índice


Âncora
_Confirmación_de_solicitudes
_Confirmación_de_solicitudes
Âncora
_Solicitud_de_proveedores
_Solicitud_de_proveedores
Âncora
_Toc473896822
_Toc473896822

...

Âncora
_Toc26185172
_Toc26185172
1. Introducción

...

#

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.

El campo también se encuentra presente cuando se genera una solicitud de "additionalData".

10

posInputMode

M

A

Es el modo de ingreso de la tarjeta:
Chip = Tarjeta insertada PIN Pad
MSR Chip = Tarjeta deslizada PIN Pad
MSR ChipNR = Ingreso Manual PIN Pad
MSR ChipError = Fallback PIN Pad
Contactless = Tarjeta aproximada x Contactless
MSR Contactless = Tarjeta aproximada x Contactless (solo Amex)

58

loyaltyData

O

A

Únicamente para Bancomer:
Se obtiene la respuesta del campo 58 puntos Bancomer otorgada por el autorizador. El formato de esta respuesta se encuentra especificada en la documentación de 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:
Indica cómo fue identificado el tarjeta habiente, los valores cambian dependiendo el autorizador:

Para Banamex:
0 = Desconocido (default)
1 = Firma
2 = PIN
3 = Terminal no atendida
4 = Orden correo telefónico
5 = Transacción QPS (Quick Payment Service), pagaré sin firma.

Para Bancomer:
0 = Desconocido (default)
9= Transacción QPS (Quick Payment Service), pagaré sin firma.

Estos valores reflejan lo indicado por el AUTORIZADOR, de este valor debe depender la impresión del Voucher.

161

cardType

O

A

Tipo de tarjeta, opcional si VTOL lo responde:

  • Credito = Tarjeta tipo Crédito.
  • Debito = Tarjeta tipo Débito.
  • Sin Clasificar = Tipo de tarjeta no identificado por VTOL.

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".
Comisión. 12 dígitos como máximo. Se envía sin separador decimal. Los dos últimos dígitos representan los decimales. Ej: 1000 equivale a 10.00

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:

  • "true" carga "opcional" solicitada. Se deberá enviar mensaje "resetKeys" de acuerdo a la estrategia informada en la especificación del pinpad.
  • "false" o inexistente si la carga no fue solicitada.

204

cardHolderName

O

A

Se reporta en el nombre del tarjeta habiente en caso de que exista.

205

aid

O

A

Card Application Identifier:
Se reporta en el valor del AID en caso de existir el token B3.

206

electronicSign

O

A

El valor "true" para este campo indica que se firmó electrónicamente el pago.

207

withoutSign

O

A

Para Bancomer:
El valor "true" para este campo indica que se leyó del pinpad que no se requiere firma del tarjeta habiente
Para Banamex:
El valor "true" indica que el POS solicitó la autorización mediante QPS.
NOTA: Tener en cuenta la respuesta el campo 125, que es la respuesta del AUTORIZADOR.

209

acceptLoyaltyPoints

O

A

Uso solo para Bancomer.
El campo se encuentra presente si EMV/KIT se encuentra configurado para obtener configuración del "rsvtol.ini".
Si el valor se encuentra en "true", indicará que el prefijo de la tarjeta tiene habilitada la opción de pagos con puntos.

210

providerName

O

A

El campo se encuentra presente si EMV/KIT se encuentra configurado para obtener configuración del "rsvtol.ini".
En este campo se informa el nombre del banco configurado de la tarjeta.

211

debit

O

A

El campo se encuentra presente si EMV/KIT se encuentra configurado para obtener configuración del "rsvtol.ini".
Si el valor se encuentra en "true", indicará que la tarjeta se encuentra configurada como débito.

212

paymentPlanList

O

A

El campo se encuentra presente si EMV/KIT se encuentra configurado para obtener configuración del "rsvtol.ini".
Este campo contiene una lista de todos los planes y cuotas actualmente habilitados para la tarjeta ingresada.
Se utiliza el carácter "&" para separar planes de pagos y el carácter "|” para separar los atributos plan y cuotas.

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".
Si el valor se encuentra en "true", indicará que la tarjeta permite transacción de CashBack.

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:
Se devuelve como un ascii en hexadecimal la firma digital obtenida del pinpad.

221

TVR

O

A

Únicamente para Banorte:

Terminal Verification Results (Tag 95).
Devuelto únicamente en transacciones con CHIP para imprimir en el ticket.

222

TSI

O

A

Únicamente para Banorte:

Transactions Status Informations (Tag 9B).
Devuelto únicamente en transacciones con CHIP para imprimir en el ticket

223

expiryDate

 

 



Únicamente para Banorte:
Fecha de expiración de la tarjeta informada por el pinpad

224

Form Factor Ind

O

A

Únicamente para Banamex
Valor para imprimir en el ticket para transacciones contactLess de Banamex.

...