Fecha	Revisión	Cambios – Motivo
06/01/2014	1.0	Creación del documento
17/08/2015	1.1	Definición de librería como servicio. Explicación de integración
23/10/2015	1.2	Agregado de Operación Procesar Mensaje Crédito Débito. Incorporación de identificador único de transacción en VTOL Server, campo: 166-trxReferenceNumber
09/11/2015	1.3	Agregado de campo 1102–Proveedor seleccionado en mensaje Procesar Operación con Tarjeta
13/05/2016	1.4	Agregado de campo 137–ConfVersion en GetConfiguration, 10–inputMode en Sale/VoidSale/Etc y 1010–currentSessionId en el mensaje Crear sesión
16/05/2016	1.5	Revisión del documento
06/06/2016	1.6	Agregado del valor FORCED_CLOSE en el campo 1008–closeSessionAction del mensaje Cerrar Sesión
14/07/2016	1.7	Agregados los tipos de transacciones ServicePayment y VoidServicePayment
18/08/2016	1.8	Agregado del anexo "Mecanismo de Autorización Telefónica"
15/09/2016	1.9	Agregado de campo 57 - Tipo de Cuenta en la respuesta al POS para el procesamiento de operación con tarjeta.
19/09/2016	1.10	Se modifica la condición del campo 1113 – cardIsDebit.
21/09/2016	1.11	Posibilidad de recibir desde el POS, el valor que indica la capacidad de captura de la terminal.
23/09/2016	1.12	Agregado del tipo de operación "Cancelar Lectura de Tarjeta"
06/10/2016	1.13	Se incorpora definición de timeout de EMVKIT. Se eliminan los campos: Store y Node de los mensajes: Leer Datos de la Tarjeta - Cancelar Lectura de Tarjeta - Procesar Operación con Tarjeta - Procesar Mensaje Crédito Debito - Obtener Configuración de POS - Cerrar Sesión
05/04/2017	1.14	Agregado de propiedad approveInSecondInstance en sección de Configuración de PINPAD
16/05/2017	1.15	Modificación del apartado Mecanismo de Autorización Telefónica
17/05/2017	1.16	Agregado del valor MSR Chip en campo inputMode
30/05/2017	1.17	Agregado del apartado "Circuito Operativo de la EMVKIT"
06/06/2017	1.18	Actualización de la tabla Prefijo en el apartado Formato Interface POS. Mayor detalle del campo MasterKey Position, incluyendo el valor 99
07/07/2017	1.19	Agregado del campo promocional en Configuración de POS para indicar que se aplica una promoción sobre un plan de pago
20/07/2017	1.20	Incorporación del campo opcional 1025 – transactionalControl en la operación "Crear Sesión" Incorporación de campo 24 - lastTrxId en operación "Leer Datos de la Tarjeta" Agregado del anexo "Control Transaccional"
27/07/2017	1.21	Modificación del apartado "Pre requisitos" Incorporación del apartado "Configuración de enlace con VTOL"
02/08/2017	1.22	Agregación de campo 22 – authorizationCode en el requerimiento de la operación "Leer Datos de la Tarjeta" Eliminación de campo 22 – authorizationCode en el requerimiento de la operación "Procesar Operación con Tarjeta"
06/10/2017	1.23	Actualización de la estructura y numeración del documento Agregación del campo dateTime como valor requerido en los requerimientos de "Procesar Operación con Tarjeta" y "Procesar Mensaje Crédito Débito" Actualización del anexo "Timeout de la EMVKIT"
14/11/2017	1.24	Incorporación del apartado "Instalación" Actualización del apartado "Configuración"
01/02/2018	1.25	Aclaración sobre requerimiento de software
23/04/2018	1.26	Revisión general del documento. Agregado de apartado Pagos Parciales.
13/06/2018	1.27	Agregado de procesamiento de tarjetas de empleados
12/07/2018	1.28	Agregado de campos 6 - cardNumber, 9 - track2, 66 - track1 y 145 - exceptionBinName en la respuesta de la operación "Procesar Operación con Tarjeta"
06/08/2018	1.29	Incorporación de la funcionalidad PEI en la mensajería
17/08/2018	1.30	Agregado de campo 1104 - prefixesList en la respuesta de la operación "Leer Datos de la Tarjeta"
14/01/2019	1.31	Incorporación de las funcionalidades de impresión de vouchers en la mensajería
25/01/2019	1.32	Incorporación de la mensajería PEI en las operatorias de "Leer datos de Tarjeta" y "Procesar Operación con Tarjeta" Incorporación de la mensajería QueryPEI con PinPad
15/02/2019	1.33	Incorporación de la funcionalidad Billeteras Electrónicas QR (Mercado Pago y Todo Pago)
03/04/2019	1.34	Agregado del campo 0 (compañía) en todos los tipos de transacciones.
17/05/2019	1.35	Incorporación de la funcionalidad Cuenta DNI y Promociones PEI.
20/05/2019	1.36	Incorporación de apartado de compatibilidad con VTOL Server.
02/08/2019	1.37	Incorporación de funcionalidad de Billeteras electrónicas con manejo de cuotas.
08/08/2019	1.38	Incorporación de funcionalidad Contactless con pinpad de First Data.
09/08/2019	1.39	Incorporación de apartado para integrar operaciones con tarjetas Contactless.
24/10/2019	1.40	Agregado del campo 1138 (emvData) en la operatoria "Procesar Operación con Tarjeta". Los datos de este campo retornan al POS para ser impresos en el ticket.
25/11/2019	1.41	Agregado de anexo 6.10 Vouchers con la especificación de los campos de los comprobantes según los Autorizadores
27/12/2019	1.42	Actualización del apartado Procedimiento de Instalación
06/01/2020	1.43	Incorporación de funcionalidad Contactless con pinpad de Prisma.
10/03/2020	1.44	Incorporación de mensaje de Sincronización de transacciones entre EMVKit y el POS.
29/04/2020	1.45	Incorporación de la carpeta doc a la instalación
30/07/2020	1.46	Incorporación de funcionalidad de Billeteras Mercado Pago con retiro de efectivo.
22/09/2020	1.47	Se actualiza el campo 54 (additionalAmount) como tipo de dato Importe, en la mensajería de Billeteras electrónicas.
26/11/2020	1.48	Agregado del campo Descripción en Configuración de POS para indicar la descripción sobre un plan de pago.
11/12/2020	1.49	Incorporación de funcionalidad QR Adquiriente.
16/12/2020	1.50	Incorporación del campo afApplicationCondition para validar la aplicación de reglas antifraudes por el módulo AF de VTOL.
05/03/2021	1.51	Se actualiza el nombre y la descripción del campo 406 en la respuesta de la mensajería de QR Adquiriente.
13/04/2021	1.52	Incorporación de mensaje para Consultar Bines de Excepción
05/05/2021	1.53	Incorporación de mensaje para Consultar tarjetas de Fidelidad
11/05/2021	1.54	Se quitan las referencias de la billetera Todo Pago, ya que dicha Billetera está incluida dentro de QR Adquiriente Prisma.

Âncora
_Toc508730814
_Toc508730814
Índice

...

En la imagen se observan ejemplos de tramas de requerimiento y de respuesta transmitidas por TCP IP entre la librería liviana y EMVKIT. Los tipos de operaciones son los siguientes y se explayan en el apartado 1.9 Tipos de Operación:

Creación de la sesión
Lectura de los datos de la tarjeta
Cancelación de la lectura de la tarjeta
Procesamiento de una operación con tarjeta
Procesamiento del mensaje Crédito Débito
Procesamiento de mensajes PEI
Obtención de la configuración del POS
Cierre de la sesión

...

En líneas generales, el orden de ejecución de cada llamada es similar al anteriormente mencionado.
Primero se inicia sesión, donde EMVKIT carga la configuración desde VTOL, sincroniza el estado de las transacciones, verifica el funcionamiento del PINPAD, etc. Posteriormente se entra en un ciclo de llamadas para obtener información de la tarjeta y luego procesarla (autorizarla). Esto se realiza tantas veces como tarjetas se utilicen para pagar la transacción. Finalmente se procede al cierre de sesión donde EMVKIT confirma las transacciones contra el servidor VTOL.
En el apartado 1.9 Tipos de Operación se explica en mayor detalle cada operación en particular y en el anexo 1.15 Circuito Operativo de EMVKIT se detalla el flujo de operación.

...

Carpeta / Archivo	Descripción
backup	Directorio que persistirá los últimos cinco backups de archivos de las versiones instaladas de la solución EMV Kit durante la tarea de instalación
doc	Contiene
emvkit	Contiene todos los archivos requeridos para el funcionamiento del EMV Kit
sdagent	Contiene los archivos del componente agente de Director (configuración, binarios y registros)
sdagentcmds	Contiene los archivos para iniciar/detener/consultar el agente de Director de la solución EMV Kit
tmp	Persiste los archivos de la versión a instalar de la solución EMV Kit durante la tarea de sincronización
util	Contiene las utilidades para la creación de los servicios en Linux
licenseAccepted.sts	Archivo de texto que menciona el nombre de usuario, el mail del usuario y la fecha que aceptó los términos y condiciones de uso
nssm.exe	Aplicación encargada de construir los servicios EmvKit y EmvKitDirectorService para Windows

...

Número	Nombre del campo	Tipo de dato	createSession	Descripción
1010	currentSessionId	Numérico	X	Identificador de la nueva sesión
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería

...

Número	Nombre del campo	Tipo de dato	cancel	Descripción
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería

...

Número	Nombre del campo	Tipo de dato	SalePEI	RefundPEI	QueryPEI	Descripción
0	company	Numérico	X	X	X	Identificador de la compañía donde se generó la transacción.
1	store	Alfanumérico	X	X	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	X	X	Identificación del nodo, en el sitio originador, donde se generó la transacción
25	dateTime	Numérico	X	X	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción
26	responseCode	Alfanumérico	X	X	X	Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24
27	isoCode	Numérico	X	X	X	Código de Respuesta ISO-8583 emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para PEI
28	responseMessage	Alfanumérico	X	X	X	Mensaje de la Respuesta ISO-8583 relacionado con el código del campo 27
35	errorDescription	Alfanumérico	X	X	X	Descripción de error. Sólo se encuentra presente si el valor del campo 26 es “Error”
153	idOperationPEI	Alfanumérico	X	X	X	Identificador de la operación PEI de pago o de devolución
154	idOperationOrigenPEI	Alfanumérico	-	X	O	Identificador de la operación PEI de origen con la cual se solicitó la devolución
170	idCommercePEI	Alfanumérico	X	X	X	Identificador PEI de compañía
171	idBranchPEI	Alfanumérico	X	X	X	Identificador PEI de local
172	idTerminalPEI	Alfanumérico	X	X	X	Identificador PEI de terminal
174	originalTrxStatus	Numérico	-	-	O	Informa el estado de la transacción original en una operación de consulta. Si el campo en la respuesta no se recibe es porque la consulta falló. Puede contener uno de los siguientes valores: 0: Aprobada 1: Rechazada 2: En proceso
278	bankingRefNum	Alfanumérico	X	-	X	Numero de referencia de la transacción de pago. Se utiliza para conciliar con los reportes de las entidades bancarias. Número generado por LINK. Largo máximo 12.
1010	currentSessionId	Numérico	X	X	X	Identificador de la sesión actual
1027	libResponseCode	Numérico	X	X	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	X	X	Mensaje descriptivo del código de respuesta de la librería

...

Número	Nombre del campo	Tipo de dato	QueryPEI	Descripción
0	company	Numérico	X	Identificador de la compañía donde se generó la transacción.
1	store	Alfanumérico	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	Identificación del nodo, en el sitio originador, donde se generó la transacción
25	dateTime	Numérico	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. Es importante persistir este valor para consultar el resultado de una operación en caso de algún inconveniente.
26	responseCode	Alfanumérico	X	Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE
27	isoCode	Numérico	X	Código de Respuesta ISO-8583 emitido por el centro autorizador. 2 dígitos como máximo
28	responseMessage	Numérico	X	Mensaje de la Respuesta con la descripción ISO-8583 del Centro Autorizador relacionado con el código del campo 27.
153	idOperationPEI	Alfanumérico	X	Identificador de la operación PEI de pago o devolución.
154	idOperationOrigenPEI	Alfanumérico	X	Identificador de la operación PEI de origen con la cual se solicitó la devolución.
170	idCommercePEI	Alfanumérico	X	Identificador PEI de compañía
171	idBranchPEI	Alfanumérico	X	Identificador PEI de local
172	idTerminalPEI	Alfanumérico	X	Identificador PEI de terminal
174	originalTrxStatus	Numérico	X	Informa el estado de la transacción original en una operación de consulta. Si el campo en la respuesta no se recibe es porque la consulta falló. Puede contener uno de los siguientes valores: 0: Aprobada 1: Rechazada 2: En proceso
278	bankingRefNum	Alfanumérico	X	Numero de referencia de la transacción de pago. Se utiliza para conciliar con los reportes de las entidades bancarias. Número generado por LINK. Largo máximo 12.
1010	currentSessionId	Numérico	X	Identificador de la sesión actual
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería

...

Número	Nombre del campo	Tipo de dato	PrintTrxVoucher	Descripción
1010	currentSessionId	Numérico	X	Identificador de la sesión
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería
1103	cardContextId	Numérico	X	Identifica el contexto de la tarjeta. Es un valor de referencia a la tarjeta leída a través del PINPAD. Es el valor devuelto por la última operación "Leer Datos Tarjeta"

...

Número	Nombre del campo	Tipo de dato	Print	Descripción
1010	currentSessionId	Numérico	X	Identificador de la sesión
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería
1103	cardContextId	Numérico	X	Identifica el contexto de la tarjeta. Es un valor de referencia a la tarjeta leída a través del PINPAD. Es el valor devuelto por la última operación "Leer Datos Tarjeta"

...

Mercado Pago: La plataforma de pagos online más importante de América Latina
Todo Pago: La plataforma de pagos de Prisma

Las operaciones soportadas en VTOL Server para Billeteras electrónicas son:

...

Una vez recibida la respuesta de operación Aprobada por parte de Mercado Pago, se puede realizar lo siguiente:
- Para una venta con productos y cashout. Permite anular:
  - Los productos y el cashout, todo junto. Esto se logra enviando un UnSyncCompletion=rollback
- Para una venta sólo con productos. Permita anular:
  - Todos los productos. Esto se logra enviando un UnSyncCompletion=rollback.
No es posible realizar anulaciones intermedias.

Procedimiento para Todo Pago

El proceso de pagos con billetera virtual de Todo Pago difiere respecto de Mercado Pago, ya que el cliente en su app mobile simplemente selecciona la tarjeta con la cual realizará el pago, y luego el resto de la operatoria la deberá realizar el cajero, es decir, el ingreso de las cuotas, promociones, etc. El proceso se realizará de la siguiente manera:

Se inicia con el envío de una orden de venta (transacción SaleWallet) por parte del POS a VTOL.
Recién en ese momento el comprador podrá efectuar la lectura del código QR impreso en la caja mediante su smartphone. Seleccionará la tarjeta con la cual realizará el pago. Y luego aceptará la tarjeta elegida en su app mobile.
VTOL recibirá la información de la tarjeta del cliente, por medio de Todo Pago, y le responderá al POS que se deben ingresar las cuotas según los planes de pago disponibles (sólo para aquellos comercios que permitan pagos en cuotas).
El POS ingresará las cuotas, y enviará la información a VTOL por medio de la transacción QuerySaleWallet.
El POS recibirá la respuesta de la transacción a través de VTOL, quien informará si la operación resultó autorizada por Todo Pago.
1. Puede darse el caso que VTOL responda "Consulte el pago por tiempo expirado". Este escenario puede surgir por algún problema de conexión y VTOL no pudo obtener el mensaje sobre el resultado de Todo Pago. Con este mensaje se le informa al POS que para conocer el resultado de la operación, deberá realizar una nueva consulta (transacción QuerySaleWallet). Las respuestas del QuerySaleWallet pueden ser las siguientes:
  1. VTOL responde "Aprobado". Indica que el pago fue autorizado por Todo Pago. El paso siguiente del POS es confirmar o cancelar la transacción, con un tercer mensaje.
  2. VTOL responde "Pago Rechazado". Indica que el pago no fue autorizado por Todo Pago. Por lo tanto la operación no puede continuar. El POS deberá iniciar una nueva transacción.
Por último, el POS deberá confirmar la operación, mediante el cierre de sesión (en estado Close).

Requerimiento

Informações

Referencias:

X = Obligatorio
O = Opcional
- = No requerido

...

Número

...

Nombre del campo

...

Tipo de dato

...

SaleWallet

...

Descripción

...

11

...

trxType

...

Alfanumérico

...

X

...

Tipo de Transacción:

SaleWallet = Compra con billetera electrónica
RefundWallet = Devolución de compra realizada con billetera electrónica
QuerySaleWallet = Consulta de transacción de compra realizada con billetera electrónica

...

12

...

amount

...

Importe

...

X

...

Monto de la transacción. 12 dígitos como máximo. Se envía sin coma. Los dos últimos dígitos representan los decimales. Ej: 1000 equivale a 10.00

Nota: El importe debe ser el número correspondiente a la moneda informada

...

13

...

currencyPosCode

...

Alfanumérico

...

X

...

Tipos de moneda:

$ = Pesos
U$S = Dólares

Nota: En el punto de venta se deberá informar la moneda de la cuenta vendedor de Mercado Pago (si el retailer posee una cuenta argentina en Mercado Pago entonces tendrá que informar la moneda $ -pesos argentinos-)

Nota: Para Todo Pago la moneda siempre es $ -pesos argentinos-

Importante: Tener en cuenta que operando con Mercado Pago siempre debe coincidir el país de la cuenta vendedor con el país de la cuenta comprador

...

Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD

...

25

...

dateTime

...

Numérico

...

X

...

Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS

...

Contiene el Importe del "Cashout". 12 dígitos como máximo. Valor entero. Los últimos 2 dígitos corresponden a los decimales.

Para devoluciones, se debe enviar el monto total del cashout.

Para devolver sólo el cashout, se debe enviar el campo 12 (amount) con valor 0.

Sólo disponible para billetera de Mercado Pago.

...

Identificador único de la transacción de billetera para la compañía. Es originado por el POS para realizar una compra con billetera.

Formato:
codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12)
Longitud total de 32

Opcional en QuerySaleWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra

...

Tipo de billetera por la cual se cursará la transacción en el POS. Opciones:

1: Mercado Pago
2: Todo Pago

...

Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura del campo posTicket

...

-

...

Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet

Opcional en QuerySaleWallet: Se informa este campo o el campo walletPosTrxId para localizar una transacción de compra

...

Título de la venta. Longitud máxima 100.

Si el POS no lo envía, VTOL tomará un valor por defecto el siguiente label: "Pago con Mercado Pago en" + "CompanyName".

...

Descripción de la venta. Longitud máxima 100.

Si el POS no lo envía, VTOL tomará un valor por defecto el siguiente label: "Pago realizado con QR. Por un monto de $amount. Y retiro de efectivo de $additionalAmount.".

Nota
Los valores de compañía, tienda y caja serán obtenidos de la sesión.

Ejemplo

...

Request to VTOL (SaleWallet):

Request: {270:PG1lc3NhZ2U+CiAgICAgICA8aXRlbS1hZGQgc2VxPSIxIiBjb2RlPSIwMDAxIiBkaXNjb3VudGFibGU9InRydWUiIHVuaXRwcmljZT0iMjUuMCIgcXR5PSIxLjAiIGxldmVsMT0iTUVOIiBsZXZlbDI9IkNBU1VBTCIgc3VwcGxpZXI9IiIgYnJhbmQ9IkxFVklTIiB4cHJpY2U9IjI1LjAiIG1hZ25pdHVkZT0iMS4wIiBkZXNjcmlwdGlvbj0iSmVhbiBjYXN1YWwiIGN1cnJlbmN5PSIkIiAvPgogICAgICAgPGl0ZW0tYWRkIHNlcT0iMiIgY29kZT0iMDAwMiIgZGlzY291bnRhYmxlPSJ0cnVlIiB1bml0cHJpY2U9IjI4LjAiIHF0eT0iMi4wIiBsZXZlbDE9Ik1FTiIgbGV2ZWwyPSJDQVNVQUwiIHN1cHBsaWVyPSIiIGJyYW5kPSJMRVZJUyIgeHByaWNlPSI0OC4wIiBtYWduaXR1ZGU9IjEuMCIgZGVzY3JpcHRpb249IkplYW4gY2FzdWFsIiBjdXJyZW5jeT0iJCIgLz4KPC9tZXNzYWdlPg==;269:1;268:1120181116055713;13:$;12:1200;11:SaleWallet;4:DATA;3:VTOL;2:1;25:20181116055713;71:True;1:1;54:90000}

Request to VTOL (RefundWallet):

Request: {271:4379999999999999437;269:1;16:20181116;13:$;12:1200;11:RefundWallet;4:DATA;3:VTOL;2:1;25:20181116105619;71:True;1:1}

Request to VTOL (QuerySaleWallet):

Request: {271:2289999999999999228;269:1;16:20190214;268:11020190514050534;25:20190214050534;11:QuerySaleWallet}

Estructura del campo posTicket

El mensaje con la estructura del ticket estará en XML. El elemento raíz de ese mensaje XML deberá ser la etiqueta <message>, siendo la misma lo que se llamará encabezado.

La manera de ejecutar un comando es utilizando una etiqueta con la forma <elemento-comando>. El elemento "item" identifica a los artículos. De esta manera, si se desea, por ejemplo, agregar un nuevo artículo el comando a utilizar será <item-add>. En el cuerpo del mensaje podrá contener uno, ninguno o varios de estos comandos.

Cada uno de los comandos que se envían posee diversos atributos, los cuales identifican al elemento que se está enviando y definen diversas propiedades que poseen los mismos. Poseerá un número de secuencia, el cual identifica cada elemento unívocamente:

...

Propiedad

...

Tipo de dato

...

Descripción

...

Requerido

...

seq

...

Entero positivo

...

Número identificador único del elemento dentro de la transacción.

...

Sí

Cada comando posee una serie de atributos que definirán las distintas propiedades del elemento que se está agregando (además del número de secuencia antes mencionado).

Para el elemento ítem, los atributos serán los siguientes:

...

Elemento

...

Atributo

...

Tipo de dato

...

Descripción

...

Requerido

...

Valor ante ausencia

Ítem

...

unitprice

...

Numérico positivo

...

Precio unitario del artículo en cuestión.

...

Si

...

xprice

...

Numérico positivo

...

Precio extendido del artículo en cuestión. Es igual a la cantidad por el precio unitario.

...

Si

...

qty

...

Entero positivo

...

Cantidad de artículos en la línea.

...

Si

...

magnitude

...

Numérico positivo

...

Si el artículo es mensurable por otro unidad que no sea la cantidad, deberá ser expresad en esta propiedad.

...

No

...

0

...

code

...

Alfanumérico

...

Código propio del artículo.

...

No

...

"-"

...

brand

...

Alfanumérico

Requerimiento

Informações

Referencias:

X = Obligatorio
O = Opcional
- = No requerido

Número	Nombre del campo	Tipo de dato	SaleWallet	RefundWallet	QuerySaleWallet	Descripción
11	trxType	Alfanumérico	X	X	X	Tipo de Transacción: SaleWallet = Compra con billetera electrónica RefundWallet = Devolución de compra realizada con billetera electrónica QuerySaleWallet = Consulta de transacción de compra realizada con billetera electrónica
12	amount	Importe	X	X	-	Monto de la transacción. 12 dígitos como máximo. Se envía sin coma. Los dos últimos dígitos representan los decimales. Ej: 1000 equivale a 10.00 Nota: El importe debe ser el número correspondiente a la moneda informada
13	currencyPosCode	Alfanumérico	X	X	-	Tipos de moneda: $ = Pesos U$S = Dólares Nota: En el punto de venta se deberá informar la moneda de la cuenta vendedor de Mercado Pago (si el retailer posee una cuenta argentina en Mercado Pago entonces tendrá que informar la moneda $ -pesos argentinos-) Importante: Tener en cuenta que operando con Mercado Pago siempre debe coincidir el país de la cuenta vendedor con el país de la cuenta comprador
16	originalDate	Numérico	-	X	X	Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD
24	lastTrxId	Numérico	O	O	O	Utilizado cuando está activo el control transaccional. En este campo el POS debe enviar la última transacción procesada correctamente.
25	dateTime	Numérico	X	X	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS
54	additionalAmount	Importe	O	O	-	Contiene el Importe del "Cashout". 12 dígitos como máximo. Valor entero. Los últimos 2 dígitos corresponden a los decimales. Para devoluciones, se debe enviar el monto total del cashout. Para devolver sólo el cashout, se debe enviar el campo 12 (amount) con valor 0. Sólo disponible para billetera de Mercado Pago.
268	walletPosTrxId	Alfanumérico	X	-	O	Identificador único de la transacción de billetera para la compañía. Es originado por el POS para realizar una compra con billetera. Formato: codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12) Longitud total de 32 Opcional en QuerySaleWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra
269	walletType	Numérico	X	X	X	Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 1: Mercado Pago
270	posTicket	Base 64	X	-	-	Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura del campo posTicket
271	walletPaymentId	Alfanumérico	-	X	O	Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet Opcional en QuerySaleWallet: Se informa este campo o el campo walletPosTrxId para localizar una transacción de compra
311	purchaseTitle	Alfanumérico	O	-	-	Título de la venta. Longitud máxima 100. Si el POS no lo envía, VTOL tomará un valor por defecto el siguiente label: "Pago con Mercado Pago en" + "CompanyName".
312	purchaseDesc	Alfanumérico	O	-	-	Descripción de la venta. Longitud máxima 100. Si el POS no lo envía, VTOL tomará un valor por defecto el siguiente label: "Pago realizado con QR. Por un monto de $amount. Y retiro de efectivo de $additionalAmount.".

Nota
Los valores de compañía, tienda y caja serán obtenidos de la sesión.

Ejemplo

Request to VTOL (SaleWallet):

Request: {270:PG1lc3NhZ2U+CiAgICAgICA8aXRlbS1hZGQgc2VxPSIxIiBjb2RlPSIwMDAxIiBkaXNjb3VudGFibGU9InRydWUiIHVuaXRwcmljZT0iMjUuMCIgcXR5PSIxLjAiIGxldmVsMT0iTUVOIiBsZXZlbDI9IkNBU1VBTCIgc3VwcGxpZXI9IiIgYnJhbmQ9IkxFVklTIiB4cHJpY2U9IjI1LjAiIG1hZ25pdHVkZT0iMS4wIiBkZXNjcmlwdGlvbj0iSmVhbiBjYXN1YWwiIGN1cnJlbmN5PSIkIiAvPgogICAgICAgPGl0ZW0tYWRkIHNlcT0iMiIgY29kZT0iMDAwMiIgZGlzY291bnRhYmxlPSJ0cnVlIiB1bml0cHJpY2U9IjI4LjAiIHF0eT0iMi4wIiBsZXZlbDE9Ik1FTiIgbGV2ZWwyPSJDQVNVQUwiIHN1cHBsaWVyPSIiIGJyYW5kPSJMRVZJUyIgeHByaWNlPSI0OC4wIiBtYWduaXR1ZGU9IjEuMCIgZGVzY3JpcHRpb249IkplYW4gY2FzdWFsIiBjdXJyZW5jeT0iJCIgLz4KPC9tZXNzYWdlPg==;269:1;268:1120181116055713;13:$;12:1200;11:SaleWallet;4:DATA;3:VTOL;2:1;25:20181116055713;71:True;1:1;54:90000}

Request to VTOL (RefundWallet):

Request: {271:4379999999999999437;269:1;16:20181116;13:$;12:1200;11:RefundWallet;4:DATA;3:VTOL;2:1;25:20181116105619;71:True;1:1}

Request to VTOL (QuerySaleWallet):

Request: {271:2289999999999999228;269:1;16:20190214;268:11020190514050534;25:20190214050534;11:QuerySaleWallet}

Estructura del campo posTicket

El mensaje con la estructura del ticket estará en XML. El elemento raíz de ese mensaje XML deberá ser la etiqueta <message>, siendo la misma lo que se llamará encabezado.

La manera de ejecutar un comando es utilizando una etiqueta con la forma <elemento-comando>. El elemento "item" identifica a los artículos. De esta manera, si se desea, por ejemplo, agregar un nuevo artículo el comando a utilizar será <item-add>. En el cuerpo del mensaje podrá contener uno, ninguno o varios de estos comandos.

Cada uno de los comandos que se envían posee diversos atributos, los cuales identifican al elemento que se está enviando y definen diversas propiedades que poseen los mismos. Poseerá un número de secuencia, el cual identifica cada elemento unívocamente:

Propiedad	Tipo de dato	Descripción	Requerido
*seq*	Entero positivo	Número identificador único del elemento dentro de la transacción.	Sí

Cada comando posee una serie de atributos que definirán las distintas propiedades del elemento que se está agregando (además del número de secuencia antes mencionado).

Para el elemento ítem, los atributos serán los siguientes:

Elemento	Atributo	Tipo de dato	Descripción	Requerido	Valor ante ausencia
Ítem	*unitprice*	Numérico positivo	Precio unitario del artículo en cuestión.	Si
	*xprice*	Numérico positivo	Precio extendido del artículo en cuestión. Es igual a la cantidad por el precio unitario.	Si
	*qty*	Entero positivo	Cantidad de artículos en la línea.	Si
	*magnitude*	Numérico positivo	Si el artículo es mensurable por otro unidad que no sea la cantidad, deberá ser expresad en esta propiedad.	No	0
	*code*	Alfanumérico	Código propio del artículo.	No	"-"
	*brand*	Alfanumérico	Marca del artículo.	No	"-"
	*supplier*	Alfanumérico	Proveedor al que pertenece el artículo.	No	"-"
	*discountable*	Alfanumérico	Si el artículo es puede recibir descuentos o no.	No	"-"
	*level1*	Alfanumérico	Nivel 1 de categorización del artículo. Anteriormente este nivel se conocía con el nombre de Departamento.	No	"-"
	*level2*	Alfanumérico	Nivel 2 de categorización del artículo. Anteriormente este nivel se conocía como la Familia del artículo.	No	"-"
	*level3*	Alfanumérico	Nivel 3 de categorización del artículo. Anteriormente este nivel se conocía como la Categoría del artículo.	No	"-"
	*level4*	Alfanumérico	Nivel 4 de categorización del artículo. Anteriormente este nivel se conocía como la subcategoría del artículo.	No	"-"
	description	Alfanumérico	Descripción del ítem	Si
	currency	Alfanumérico	Moneda utilizada en el precio del ítem Nota: En el punto de venta se deberá informar la moneda de la cuenta vendedor de Mercado Pago (si el retailer posee una cuenta argentina en Mercado Pago entonces tendrá que informar la moneda $ -pesos argentinos-).	Si
	*measure*	Alfanumérico	Unidad de medida del ítem. Valores posibles: unit - pack	No	"unit"

...

Número	Nombre del campo	Tipo de dato	SaleWallet	RefundWallet	QuerySaleWallet	Descripción
0	company	Numérico	X	X	X	Identificador de la compañía donde se generó la transacción
1	store	Alfanumérico	X	X	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	X	X	Identificación del nodo, en el sitio originador, donde se generó la transacción
12	amount	Importe	X	-	X	Monto de la transacción. Valor entero. Los últimos 2 dígitos corresponden a los decimales.
13	currencyPosCode	Alfanumérico	-	-	X	Tipos de moneda: $ = Pesos U$S = Dólares
14	payments	Numérico	-	-	O	Cantidad de cuotas seleccionadas al momento de realizar el pago QR. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago
22	authorizationCode	Alfanumérico	X	-	X	Código de autorización informado por el Autorizador
24	trxId	Numérico	X	X	X	Identificador de la transacción
25	dateTime	Numérico	X	X	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción
26	responseCode	Alfanumérico	X	X	X	Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24
27	isoCode	Numérico	X	X	X	Código de Respuesta emitido por el centro autorizador. 3 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas
28	responseMessage	Alfanumérico	X	X	X	Mensaje de la Respuesta relacionado con el código del campo 27
54	additionalAmount	Importe	O	O	O	Contiene el Importe del "Cashout". Para aquellas operaciones realizadas con retiro de efectivo. Valor entero. Los últimos 2 dígitos corresponden a los decimales. Sólo disponible para billetera de Mercado Pago.
140	paymentType	Numérico	-	-	X	Tipo de pago. Valores posibles: 0: Tarjeta 1: Efectivo
142	providerName	Alfanumérico	-	-	O	Proveedor de la tarjeta seleccionada al momento de efectuar el pago QR. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago
166	trxReferenceNumber	Numérico	X	X	-	Identificador único de la transacción en VTOL Server. Longitud entre 19 y 20 dígitos, debido a que utiliza el día como parte de formato
271	walletPaymentId	Alfanumérico	X	-	X	Identificador del número de pago informado por el Autorizador
272	amountRefunded	Importe	-	-	X	Monto devuelto en la transacción
273	paymentStatus	Alfanumérico	-	-	X	Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado 1: Devuelto 2: Pendiente 3: Autorizado 4: En Progreso 5: En mediacion 6: Rechazado 7: Cancelado 8: Contracargo
274	paymentStatusDetail	Alfanumérico	-	-	X	Detalle del estado de la transacción de pago informado por el Autorizador
275	cardType	Numérico	-	-	O	Tipo de tarjeta seleccionada al momento de efectuar el pago QR. El campo es opcional en caso de que se haya abonado con saldo de la cuenta de Mercado Pago. Valores posibles: 0: Débito 1: Crédito
1010	currentSessionId	Numérico	X	X	X	Identificador de la sesión
1027	libResponseCode	Numérico	X	X	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	X	X	Mensaje descriptivo del código de respuesta de la librería

...

Nota

title	Tener en cuenta

Si la respuesta de un mensaje QuerySaleWallet retorna con código 514 ("Tiempo expirado. Elija Consultar o Cancelar pago") el POS al aplicar la acción "Cancelar pago" sobre dicho mensaje, deberá enviar un mensaje de sincronización a EMVKit, sin incluir el id de transacción de la operación saleWallet. De esa manera EMVKit podrá sincronizar contra VTOL Server y este enviará una cancelación de la orden de compra contra la billetera virtual que se esté operando.

Ver mensaje de sincronización de transacciones

K. Procesar Mensaje Cuenta DNI

...

Número	Nombre del campo	Tipo de dato	SalePEI	RefundPEI	QueryPEI	Descripción
0	company	Numérico	X	X	X	Identificador de la compañía donde se generó la transacción.
1	store	Alfanumérico	X	X	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	X	X	Identificación del nodo, en el sitio originador, donde se generó la transacción
25	dateTime	Numérico	X	X	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción.
26	responseCode	Alfanumérico	X	X	X	Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos_de_Errores_del_CORE_de_VTOLServer TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24
27	isoCode	Numérico	X	X	X	Código de Respuesta ISO-8583 emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para PEI
28	responseMessage	Alfanumérico	X	X	X	Mensaje de la Respuesta ISO-8583 relacionado con el código del campo 27
35	errorDescription	Alfanumérico	X	X	X	Descripción de error. Sólo se encuentra presente si el valor del campo 26 es “Error”
153	idOperationPEI	Alfanumérico	X	X	X	Identificador de la operación PEI de pago o de devolución
154	idOperationOrigenPEI	Alfanumérico	-	X	O	Identificador de la operación original de pago.
170	idCommercePEI	Alfanumérico	X	X	X	Identificador PEI de compañía
171	idBranchPEI	Alfanumérico	X	X	X	Identificador PEI de local
172	idTerminalPEI	Alfanumérico	X	X	X	Identificador PEI de terminal
174	originalTrxStatus	Numérico	-	-	O	Informa el estado de la transacción original en una operación de consulta. Si el campo en la respuesta no se recibe es porque la consulta falló. Puede contener uno de los siguientes valores: 0: Aprobada 1: Rechazada 2: En proceso
278	bankingRefNum	Alfanumérico	X	X	X	Número de referencia de la transacción de pago.
1010	currentSessionId	Numérico	X	X	X	Identificador de la sesión actual
1027	libResponseCode	Numérico	X	X	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	X	X	Mensaje descriptivo del código de respuesta de la librería

...

Número	Nombre del campo	Tipo de dato	PromoPei	Descripción
0	company	Numérico	X	Identificador de la compañía donde se generó la transacción.
1	store	Alfanumérico	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	Identificación del nodo, en el sitio originador, donde se generó la transacción
25	dateTime	Numérico	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción
26	responseCode	Alfanumérico	X	Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24
27	isoCode	Numérico	X	Código de Respuesta ISO-8583 emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para PEI
28	responseMessage	Alfanumérico	X	Mensaje de la Respuesta ISO-8583 relacionado con el código del campo 27
35	errorDescription	Alfanumérico	X	Descripción de error. Sólo se encuentra presente si el valor del campo 26 es “Error”
1010	currentSessionId	Numérico	X	Identificador de la sesión actual
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería

...

Número	Nombre del campo	Tipo de dato	getConfiguration	Descripción
137	confVersion	Numérico	X	Número de versión de configuración.
138	confData	Alfanumérico	X	Configuración de POS recibida desde VTOL server. El valor recibido corresponde a los datos registrados en un archivo de configuración codificados en Base64. Ver sección Formato Configuración POS
1010	currentSessionId	Numérico	X	Identificador de la sesión actual
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería

...

Informações

title	Tener en cuenta

Ver el detalle de la configuración de Driver en el apartado Integración Contactless

Mensajería

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

...

Nro.	Nombre del campo	Tipo de dato	Sale	VoidSale	Refund	VoidRefund	SaleCashback	Descripción
0	company	Numérico	X	X	X	X	X	Identificador de la compañía donde se generó la transacción.
1	store	Alfanumérico	X	X	X	X	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	X	X	X	X	Identificación del nodo, en el sitio originador, donde se generó la transacción
10	inputMode	Alfanumérico	X	X	X	X	X	Forma en que se ingresó/leyó la tarjeta. Valores posibles: Contactless - Leída por Contactless Manual – Ingresada de forma manual por teclado MSR – Leída por banda magnética Chip – Leída por CHIP MSR Chip – Fallback
22	authorizationCode	Alfanumérico	O	O	O	O	O	Código de autorización generado por el centro autorizador para la transacción cuando la transacción fue aprobada.
23	authorizationMode	Alfanumérico	X	X	X	X	X	Modo de Autorización: OnLine = La autorización fue realizada por el Centro Autorizador Offhost = La autorización fue realizada internamente por VTOL Offline = La autorización fue realizada localmente por el POS
24	lastTrxId	Numérico	X	X	X	X	X	Id de transacción en VTOL Server. La misma queda en estado pendiente y debe ser confirmada o cancelada cuando se cierra la sesión con EMVKIT
25	dateTime	Numérico	X	X	X	X	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción.
26	responseCode	Alfanumérico	X	X	X	X	X	Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24
27	isoCode	Numérico	X	X	X	X	X	Código de Respuesta ISO-8583 emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server
28	responseMessage	Alfanumérico	X	X	X	X	X	Mensaje de la Respuesta ISO-8583 relacionado con el código del campo 27
29	serialNumber	Numérico	X	X	X	X	X	Número que identifica la terminal lógica en la que se procesó la transacción.
30	businessNumber	Numérico	X	X	X	X	X	Número de comercio en el que se procesó la transacción
31	lotNumber	Numérico	X	X	X	X	X	Número de lote en el que se registró la transacción
32	ticket	Numérico	O	O	O	O	O	Número de Ticket correspondiente a la transacción. 4 dígitos como máximo
33	creditCardIssuerName	Alfanumérico	O	O	O	O	O	Nombre del Centro emisor de la tarjeta
34	hostName	Alfanumérico	O	O	O	O	O	Nombre del canal por el cual se autorizó la tarjeta
35	errorDescription	Alfanumérico	O	O	O	O	O	Descripción de error. Sólo se encuentra presente si el valor del campo 26 es “Error”
42	lotDefinitionId	Numérico	X	X	X	X	X	Identificador de la definición de lote
57	accountType	Alfanumérico	O	O	O	O	O	Campo que se emplea para identificar el tipo de cuenta. Se usa para tarjetas de débito. Los valores posibles son: 1 = Caja de ahorros en pesos 2 = Cuenta corriente en pesos 3 = Caja de ahorros en dólares 4 = Cuenta corriente en dólares
58	workingKey	Alfanumérico	O	O	O	O	O	VTOL devuelve este campo tal como lo entrega el Centro Autorizador. Representa la llave que el PINPAD deberá usar para generar el PINBLOCK en la próxima transacción.
68	rrn	Numérico	O	O	O	O	O	Número de referencia de recuperación
75	accountNumber	Numérico	O	O	O	O	O	Número de cuenta. Este campo es devuelto si el campo 74- requestAccountNumber fue activado en el requerimiento
81	responseAuth	Alfanumérico	O	O	O	O	O	Mensaje de repuesta para ser mostrado en el display del POS donde se indican promociones. También es utilizado en la operación de Cash Back, cuando el autorizador responde con código de respuesta 98. En este campo se informará el importe máximo que puede solicitarse
82	softwareVersion	Alfanumérico	O	O	O	O	O	Versión de la aplicación
166	trxReferenceNumber	Numérico	X	X	X	X	X	Identificador único de la transacción en VTOL Server. Longitud entre 19 y 20 dígitos, debido a que utiliza el día como parte de formato.
1010	currentSessionId	Numérico	X	X	X	X	X	Identificador de la sesión actual
1027	libResponseCode	Numérico	X	X	X	X	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	X	X	X	X	Mensaje descriptivo del código de respuesta de la librería
1103	cardContextId	Numérico	X	X	X	X	X	Identifica el contexto de la tarjeta. Es un valor de referencia a la tarjeta leída a través del PINPAD.
1110	pinpadApplicationId	Alfanumérico	X	X	X	X	X	Identificador de la Aplicación del PINPAD.
1111	pinpadApplicationName	Alfanumérico	X	X	X	X	X	Nombre de la Aplicación del PINPAD.
1112	cardHolderName	Alfanumérico	O	O	O	O	O	Nombre del titular de la tarjeta si el track I está presente y la lectura fue por banda.
280	clientCopyVoucher	Alfanumérico	X	X	X	X	X	Exclusivo si se opera con pinpad de First Data. Campo para imprimir copia al cliente. Valores posibles: False: imprimir copia al cliente sin consultarlo. True: consultar al cliente si quiere copia del voucher.
281	requiresSignature	Alfanumérico	X	X	X	X	X	Exclusivo si se opera con pinpad de First Data. Campo para solicitar firma al cliente. Valores posibles: False: no requerido True: requerido

...

Número	Nombre del campo	Tipo de dato	synchronize	Descripción
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería

...

Número	Nombre del campo	Tipo de dato	SaleWallet	RefundWallet	QueryWallet	Descripción
11	trxType	Alfanumérico	X	X	X	Tipo de Transacción: SaleWallet = Compra con billetera electrónica RefundWallet = Devolución de compra realizada con billetera electrónica QueryWallet = Consulta de transacción de compra realizada con billetera electrónica
12	amount	Numérico	X	X	-	Monto de la transacción. 12 dígitos como máximo. Valor entero. Los dos últimos dígitos representan los decimales. Ej: "1000" equivale a "10.00". Para devoluciones, se debe enviar el monto total de la venta original, ya que no están permitidas las devoluciones parciales.
13	currencyPosCode	Alfanumérico	X	X	-	Tipos de moneda: $ = Pesos
16	originalDate	Numérico	-	X	X	Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD
24	lastTrxId	Numérico	O	O	O	Utilizado cuando está activo el control transaccional. En este campo el POS debe enviar la última transacción procesada correctamente.
25	dateTime	Numérico	X	X	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS
268	walletPosTrxId	Alfanumérico	X	X	O	Identificador único de la transacción de billetera para la compañía. Es originado por el POS para realizar una compra con billetera. Formato: codigoTienda (longitud 10) + codigoCaja (longitud 10) + Fecha (AAMMDDHHmmss) (longitud 12) Longitud total de 32. Opcional en QueryWallet: Se informa este campo o el campo walletPaymentId para localizar una transacción de compra.
269	walletType	Numérico	X	X	X	Tipo de billetera por la cual se cursará la transacción en el POS. Opciones: 2: QR Adquiriente
270	posTicket	Alfanumérico	X	-	-	Información del ticket en formato xml y posteriormente transformado en Base 64. Ver sección Estructura del campo posTicket
271	walletPaymentId	Alfanumérico	-	X	O	Identificador del número de pago informado por el Autorizador en el campo 271 de la respuesta de la operación SaleWallet. Opcional en QueryWallet: Se informa este campo o el campo walletPosTrxId para localizar una transacción de compra.
401	paymentMethodsData	Json	X	-	-	Información de los planes de pago, en formato json
402	walletBenefits	Json	X	-	-	Información de las tarjetas de beneficio, en formato json

...

Parámetro		Tipo de dato	Requerido	Descripción
providerPosCode		Alfanumérico	Si	Código del Proveedor de la tarjeta configurado en VTOL. Por ejemplo para Visa el código es "VI". El código se obtiene de la Configuración de POS.
bankCode		Numérico	No	Identificador del banco asociado a la tarjeta. Debe corresponder al ID de banco dispuesto por el BCRA. Ver códigos de bancos.
installments		Array	Si	Información de las cuotas.
	paymentOptionId	Alfanumérico	Si	Identificador de la opción de pago. Máximo 10 caracteres. Debe ser único dentro del campo "paymentMethodsData". Permite trazabilidad con la opción que elija el cliente en el momento de pagar. La opción de pago seleccionada por el cliente en su billetera virtual es retornada por VTOL en el mensaje de respuesta de la venta, en el campo 404.
	quantity	Numérico	Si	Cantidad de cuotas. Número entero. Máximo 2 dígitos
	paymentCondition	Alfanumérico	No	Condición de la opción de pago. Sólo se informará si existe en VTOL una opción de pago con una condición. Máximo 20 caracteres.
	amountPerInstallment	Importe	Si	Monto por cuotas. Valor entero. Los 2 últimos dígitos corresponden a los decimales.
	totalAmount	Importe	Si	Monto total. Incluye los recargos. Valor entero. Los 2 últimos dígitos corresponden a los decimales.
	surcharge	Numérico	Si	C.F.T. (Costo Financiero Total). Porcentaje de recargo sobre las cuotas. Valor entero. Los 2 últimos dígitos corresponden a los decimales.
	nominalAnnualRate	Numérico	Si	T.N.A. (Tasa Nominal Anual). Valor entero. Los 2 últimos dígitos corresponden a los decimales.

...

Estructura del campo walletBenefits (402)

El mensaje con la estructura de los beneficios estará en JSON. Estará conformado por los siguientes campos:

...

Identificador de la opción de pago creada por el POS. Máximo 10 caracteres. Debe ser único dentro del campo "walletBenefits".

Permite trazabilidad con la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente.

El ID del beneficio aplicado es retornado por VTOL en el mensaje de respuesta de la venta en el campo 405.

...

discountPercentage

...

maximumDiscountAmount

...

Ejemplo del campo walletBenefits (402)

Bloco de código

theme	Eclipse
title	json

[
   {
      "benefitCardId":"1",
      "providerPosCode":"CC",
      "discountPercentage":2000,
      "maximumDiscountAmount":25000
   },
   {
      "benefitCardId":"2",
      "providerPosCode":"CP",
      "discountPercentage":3000,
      "maximumDiscountAmount":50000
   }
]

Respuesta

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

...

Número

...

Nombre del campo

...

Tipo de dato

...

SaleWallet

...

RefundWallet

...

QueryWallet

...

Descripción

...

Contiene el importe que pagó el cliente, el cual puede variar si pagó con intereses o se aplicó algún descuento. Valor entero. Los últimos 2 dígitos corresponden a los decimales.

...

Tipos de moneda:

$ = Pesos

...

Código de autorización informado por el Autorizador

...

25

...

dateTime

...

Numérico

...

Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción

...

26

...

responseCode

...

Alfanumérico

...

Puede contener uno de los siguientes valores:

Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27
Error = ver sección Códigos de error del CORE
TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24

...

27

...

isoCode

...

Numérico

...

Código de Respuesta emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas

...

28

...

responseMessage

...

Alfanumérico

...

Mensaje de la Respuesta relacionado con el código del campo 27

...

29

...

serialNumber

...

Numérico

...

Número identificatorio de la terminal en la que se procesó la transacción.

Retorna en operaciones aprobadas.

...

30

...

businessNumber

...

Numérico

...

Número de comercio en el que se procesó la transacción.

Retorna en operaciones aprobadas.

...

Tipo de pago. Valores posibles:

0: Tarjeta
1: Efectivo

...

271

...

walletPaymentId

...

Alfanumérico

...

Estado de la transacción de pago informado por el Autorizador. Estados posibles:

0: Aprobado
1: Devuelto
2: Pendiente
3: Autorizado
4: En Progreso
6: Rechazado
7: Cancelado
8: Contracargo

...

Identificador de la opción de pago seleccionada por el cliente en su billetera virtual. Según la tarjeta, el banco, y las cuotas elegidas por el cliente, se vinculará con el paymentOptionId enviado por la caja en el requerimiento.

...

Monto original de la transacción: de venta o de devolución.

...

Contiene el importe que se descontó sobre el importe original. Debido a la aplicación de una tarjeta de beneficio vinculada en la billetera virtual del cliente.

Sólo retorna cuando se aplicó un descuento.

...

El mensaje con la estructura de los beneficios estará en JSON. Estará conformado por los siguientes campos:

Parámetro	Tipo de dato	Requerido	Descripción
benefitCardId	Alfanumérico	Si	Identificador de la opción de pago creada por el POS. Máximo 10 caracteres. Debe ser único dentro del campo "walletBenefits". Permite trazabilidad con la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente. El ID del beneficio aplicado es retornado por VTOL en el mensaje de respuesta de la venta en el campo 405.
providerPosCode	Alfanumérico	Si	Código de la tarjeta de beneficio configurada en VTOL. Por ejemplo para Clarin 365 el código es "CC".
discountPercentage	Numérico	Si	Porcentaje de descuento a aplicar sobre la compra. Valor entero. Los 2 últimos dígitos corresponden a los decimales.
maximumDiscountAmount	Numérico	Si	Importe máximo de descuento a aplicar sobre la compra. Valor entero. Los 2 últimos dígitos corresponden a los decimales.

Ejemplo del campo walletBenefits (402)

Bloco de código

theme	Eclipse
title	json

[
   {
      "benefitCardId":"1",
      "providerPosCode":"CC",
      "discountPercentage":2000,
      "maximumDiscountAmount":25000
   },
   {
      "benefitCardId":"2",
      "providerPosCode":"CP",
      "discountPercentage":3000,
      "maximumDiscountAmount":50000
   }
]

Respuesta

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

Número	Nombre del campo	Tipo de dato	SaleWallet	RefundWallet	QueryWallet	Descripción
0	company	Numérico	X	X	X	Identificador de la compañía donde se generó la transacción
1	store	Alfanumérico	X	X	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	X	X	Identificación del nodo, en el sitio originador, donde se generó la transacción.
6	cardNumber	Alfanumérico	X	-	O	Tarjeta enmascarada seleccionada por el cliente al momento de efectuar el pago QR.
12	amount	Importe	X	-	X	Contiene el importe que pagó el cliente, el cual puede variar si pagó con intereses o se aplicó algún descuento. Valor entero. Los últimos 2 dígitos corresponden a los decimales.
13	currencyPosCode	Alfanumérico	X	-	X	Tipos de moneda: $ = Pesos
14	payments	Numérico	X	-	O	Cantidad de cuotas seleccionadas al momento de realizar el pago QR.
22	authorizationCode	Alfanumérico	X	-	X	Código de autorización informado por el Autorizador
24	trxId	Numérico	X	X	X	Identificador de la transacción.
25	dateTime	Numérico	X	X	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción
26	responseCode	Alfanumérico	X	X	X	Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24
27	isoCode	Numérico	X	X	X	Código de Respuesta emitido por el centro autorizador. 2 dígitos como máximo. Ver sección Códigos de Respuesta de VTOL Server para Billeteras Electrónicas
28	responseMessage	Alfanumérico	X	X	X	Mensaje de la Respuesta relacionado con el código del campo 27
29	serialNumber	Numérico	O	O	O	Número identificatorio de la terminal en la que se procesó la transacción. Retorna en operaciones aprobadas.
30	businessNumber	Numérico	O	O	O	Número de comercio en el que se procesó la transacción. Retorna en operaciones aprobadas.
81	responseAuth	Alfanumérico	O	O	O	Mensaje de repuesta para imprimir en el ticket del POS. Retorna en operaciones aprobadas. Contiene información generada por el Autorizador.
140	paymentType	Numérico	-	-	X	Tipo de pago. Valores posibles: 0: Tarjeta 1: Efectivo
142	providerName	Alfanumérico	-	-	O	Proveedor de la tarjeta seleccionada al momento de efectuar el pago QR.
147	providerPosCode	Alfanumérico	O	-	O	Código del Provider. Retornará cuando la transacción fue aprobada por el Autorizador.
166	trxReferenceNumber	Numérico	X	X	-	Identificador único de la transacción en VTOL Server. Longitud entre 19 y 20 dígitos, debido a que utiliza el día como parte de formato
271	walletPaymentId	Alfanumérico	X	-	X	Identificador del número de pago informado por el Autorizador
272	amountRefunded	Importe	-	-	X	Monto devuelto en la transacción
273	paymentStatus	Alfanumérico	-	-	X	Estado de la transacción de pago informado por el Autorizador. Estados posibles: 0: Aprobado 1: Devuelto 2: Pendiente 3: Autorizado 4: En Progreso 6: Rechazado 7: Cancelado 8: Contracargo
306	cardIssuingBank	Alfanumérico	O	-	O	Banco emisor de la tarjeta. Retornará cuando la transacción fue aprobada por el Autorizador.
404	paymentOptionId	Alfanumérico	X	-	O	Identificador de la opción de pago seleccionada por el cliente en su billetera virtual. Según la tarjeta, el banco, y las cuotas elegidas por el cliente, se vinculará con el paymentOptionId enviado por la caja en el requerimiento.
405	benefitCardId	Alfanumérico	X	-	O	Identificador de la tarjeta de beneficio aplicada en el pago por estar vinculada en la billetera virtual del cliente.
406	originalAmount	Importe	X	-	O	Monto original de la transacción: de venta o de devolución.
407	amountDiscounted	Importe	X	-	O	Contiene el importe que se descontó sobre el importe original. Debido a la aplicación de una tarjeta de beneficio vinculada en la billetera virtual del cliente. Sólo retorna cuando se aplicó un descuento.
1010	currentSessionId	Numérico	X	X	X	Identificador de la sesión
1027	libResponseCode	Numérico	X	X	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	X	X	Mensaje descriptivo del código de respuesta de la librería

Nota

title	Tener en cuenta

Si la respuesta de un mensaje QuerySaleWallet retorna con código 514 ("Tiempo expirado. Elija Consultar o Cancelar pago") el POS al aplicar la acción "Cancelar pago" sobre dicho mensaje, deberá enviar un mensaje de sincronización a EMVKit, sin incluir el id de transacción de la operación saleWallet. De esa manera EMVKit podrá sincronizar contra VTOL Server y este enviará una cancelación de la orden de compra contra la billetera virtual que se esté operando.

Ver mensaje de sincronización de transacciones

P. Consultar Bines de excepción

Mensaje que permite consultar los bines de excepción configurados en VTOL.

El POS puede utilizar este mensaje antes de realizar cualquier operación. Enviará el número de la tarjeta, ya sea manual (el PAN completo) o los tracks de la tarjeta.

Mensajería

Requerimiento

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

Número	Nombre del campo	Tipo de dato	CardInfoService	Descripción
6	cardNumber	Numérico	O	Número de tarjeta. Sólo presente si el modo de ingreso fue Manual.
7	expiration	Numérico	O	Formato YYMM Fecha de vencimiento de la tarjeta. Sólo presente si el modo de ingreso fue Manual.
8	cvc	Numérico	O	Código de seguridad de la tarjeta. Sólo presente si el modo de ingreso fue Manual.
9	track2	Alfanumérico	O	Track2 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados
10	posInputMode	Alfanumérico	X	Forma en que se ingresó/leyó la tarjeta. Valores posibles: Manual – Ingresada de forma manual por teclado MSR – Leída por banda magnética Chip – Leída por CHIP MSR Chip – Fallback
11	trxType	Alfanumérico	X	Tipo de Transacción: CardInfoService
25	dateTime	Numérico	X	Fecha y hora de realización de la transacción, en formato: YYYYMMDDHHMMSS
66	track1	Alfanumérico	O	Track1 de la tarjeta entero (se envía todo el contenido del track1 en este campo)
71	checkPendingString	Alfanumérico	O	Indica si VTOL debe o no efectuar el chequeo de pendientes: true = activa chequeo de pendientes. false = desactiva chequeo de pendientes.
164	posEncryptedFields	Numérico	O	Indica si se utiliza encripción entre Pinpad y VTOL (modo RSA). En este caso los datos sensibles se envían encriptados. Si está activo, los campos a enviar encriptados son: 6, 8, 9, 66 Valores posibles: 1 = activado 0 = desactivado (valor por defecto).

Respuesta

X

Número	Nombre del campo	Tipo de dato	CardInfoService	Descripción
6	cardNumber	Numérico	O	Número de tarjeta. Sólo presente si el modo de ingreso fue Manual.
8	cvc	Numérico	O	Código de seguridad de la tarjeta. Sólo presente si el modo de ingreso fue Manual.
9	track2	Alfanumérico	O	Track2 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados
25	dateTime	Numérico	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción
26	responseCode	Alfanumérico	X	Puede contener uno de los siguientes valores: Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27 Error = ver sección Códigos de error del CORE TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24
27	isoCode	Numérico	X	Código de Respuesta ISO-8583
28	responseMessage	Alfanumérico	X	Descripción de la Respuesta ISO-8583 relacionado con el código del campo 27
66	track1	Alfanumérico	X	Track1 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados
145	exceptionBinName	Alfanumérico	O	Nombre de la tarjeta de Excepción. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados
146	exceptionBinData	Alfanumérico	O	Información adicional de la tarjeta de excepción. Presente solo para Tarjeta de Excepción.
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X		X	Mensaje descriptivo del código de respuesta de la librería

Nota

title	Tener en cuenta

Si la respuesta de un mensaje QuerySaleWallet retorna con código 514 ("Tiempo expirado. Elija Consultar o Cancelar pago") el POS al aplicar la acción "Cancelar pago" sobre dicho mensaje, deberá enviar un mensaje de sincronización a EMVKit, sin incluir el id de transacción de la operación saleWallet. De esa manera EMVKit podrá sincronizar contra VTOL Server y este enviará una cancelación de la orden de compra contra la billetera virtual que se esté operando.

Ver mensaje de sincronización de transacciones

P. Consultar Bines de excepción

Mensaje que permite consultar los bines de excepción configurados en VTOL.

El POS puede utilizar este mensaje antes de realizar cualquier operación. Enviará el número de la tarjeta, ya sea manual (el PAN completo) o los tracks de la tarjeta.

Mensajería

Q. Consultar Tarjetas de Fidelidad

Operatoria para realizar desde el Punto de Venta consultas de las tarjetas de fidelidad.

Requerimiento

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

CardInfoServiceCardInfoService

Número	Nombre del campo	Tipo de dato	CardQuery	Descripción
60	cardNumbercompany	Numérico	OX	Número de tarjeta. Sólo presente si el modo de ingreso fue Manual.
7	expiration	Numérico	O	Formato YYMM Fecha de vencimiento de la tarjeta. Sólo presente si el modo de ingreso fue Manual.
8	cvc	Numérico	O	Código de seguridad de la tarjeta. Sólo presente si el modo de ingreso fue Manual.
9	track2	Alfanumérico	O	Track2 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados
10	posInputMode	Alfanumérico	X	Forma en que se ingresó/leyó la tarjeta. Valores posibles: Manual – Ingresada de forma manual por teclado MSR – Leída por banda magnética Chip – Leída por CHIP MSR Chip – Fallback
Identificador de la compañía donde se generó la transacción.
1	store	Alfanumérico	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	Identificación del nodo, en el sitio originador, donde se generó la transacción
3	server	Alfanumérico	X	Identificador del Server que procesará la transacción. (en el caso de VTOL será 'VTOL')
4	messageType	Alfanumérico	X	Tipo de Mensaje: Control = Mensaje de Control, para uso interno por parte de un módulo en su comunicación con el server. Data = Mensaje de la Aplicación cliente.
11	trxType	Alfanumérico	X	Tipo de Transacción:	CardQuery = Consulta de transacción de compra realizada con billetera electrónica
25	dateTime	Numérico	X	Fecha y hora de realización de la transacción , en formato: YYYYMMDDHHMMSS
66269	track1walletType	AlfanuméricoNumérico	OX	Track1 Tipo de billetera por la tarjeta entero (se envía todo el contenido del track1 en este campo)
71	checkPendingString	Alfanumérico	O	Indica si VTOL debe o no efectuar el chequeo de pendientes: true = activa chequeo de pendientes. false = desactiva chequeo de pendientes.
164	posEncryptedFields	Numérico	O	Indica si se utiliza encripción entre Pinpad y VTOL (modo RSA). En este caso los datos sensibles se envían encriptados. Si está activo, los campos a enviar encriptados son: 6, 8, 9, 66 Valores posibles: 1 = activado 0 = desactivado (valor por defecto).

...

cual se realizará la consulta. Opciones:

2: Adquiriente Prisma

408

loyaltyCard

Numérico

X

Tipo de tarjeta de fidelidad que se quiere consultar. Opciones:

1: Clarín 365

157

customerDoc

Numérico

X

Número de documento del cliente que realiza la consulta.

Ejemplo

Request to VTOL:

Request: {157:11111111;408:1;269:2;11:CardQuery;4:DATA;3:VTOL;2:1;25:20210503192959;71:True;1:1;0:1}

Respuesta

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

Número	Nombre del campo	Tipo de dato

CardInfoService

CardQuery	Descripción

6

0

cardNumber

company

Numérico

O

X

Número de tarjeta. Sólo presente si el modo de ingreso fue Manual.8cvcNuméricoOCódigo de seguridad de la tarjeta. Sólo presente si el modo de ingreso fue Manual.9track2AlfanuméricoOTrack2 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados

Identificador de la compañía donde se generó la transacción
1	store	Alfanumérico	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	Identificación del nodo, en el sitio originador, donde se generó la transacción.
6	cardNumber	Alfanumérico	X	Número de Tarjeta del cliente. Si es una tarjeta de fidelidad, retornará en plano.
25	dateTime	Numérico	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS. El valor en este campo debe ser el mismo que el valor de la fecha y hora del requerimiento. El POS utiliza este dato para validar que se trate de la misma transacción
26	responseCode	Alfanumérico	X	Puede contener uno de los siguientes valores:

Iso8583

Iso8583 = la autorización fue procesada. Para evaluar si fue aprobada chequear el campo 27
Error =

ver

sección Códigos

sección Códigos de error del CORE

TrxIsPending: indica si existen transacciones pendientes de confirmar. En este caso, el ID de transacción a confirmar está en el campo 24

27

isoCode

Numérico

X

Código de Respuesta

ISO-8583

emitido por el centro autorizador. 3 dígitos como máximo. Ver sección: Códigos de Respuesta de VTOL Server para Consulta de Fidelidad
28	responseMessage	Alfanumérico	X

Descripción

Mensaje de la Respuesta

ISO-8583

relacionado con el código del campo 27

66

292

track1

customerFirstName

Alfanumérico

X

Track1 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados145exceptionBinName

Nombre del tarjetahabiente.
293	customerLastName	Alfanumérico

ONombre de la tarjeta de Excepción. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados146exceptionBinData

X	Apellido del tarjetahabiente.
409	loyaltyCardCategory	Alfanumérico

O

X

Información adicional

Categoría de la tarjeta de

excepción. Presente solo para Tarjeta de Excepción.

1027

libResponseCode

Numérico

X

Código de respuesta de la librería.
Indica cómo fue procesada la operación en EMVKIT:
Éxito = 000
Error <> 000
Ver sección Códigos de Respuesta de Librería

1028

libResponseMessage

Alfanumérico

X

Mensaje descriptivo del código de respuesta de la librería

fidelidad. Puede retornar los siguientes valores:

Classic
Plus

Ejemplo

Response from VTOL:

Response: {25:20210503193023;2:1;1:1;0:1;6:44123456789010;292:Juan;293:Perez;409:CLASSIC;26:ISO8583;27:00;28:APROBADA}

Âncora
_GoBack
_GoBack

...

R. Cerrar Sesión

Permite cerrar la sesión entre la aplicación de punto de venta y EMVKIT.
Internamente EMVKIT se sincroniza con VTOL Server, confirmando o cancelando las transacciones procesadas dentro de la sesión.

...

Número	Nombre del campo	Tipo de dato	closeSession	Descripción
1010	currentSessionId	Numérico	X	Identificador de la sesión que se cierra
1027	libResponseCode	Numérico	X	Código de respuesta de la librería. Indica cómo fue procesada la operación en EMVKIT: Éxito = 000 Error <> 000 Ver sección Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería

...

Sólo existirá una única interacción entre el POS e EMVKit. Será la única manera de operar con tarjetas Contactless. Ver mensajería

El POS deberá enviar obligatoriamente los campos asociados a la condición de pago antes de realizar la lectura de la tarjeta. EMVKit evaluará si se envía los campos:

...

A continuación se detallan las respuestas posibles de VTOL Server, cuando se opera con Billeteras Electrónicas, con una breve descripción de cada una:

Código

Descripción de respuesta al POS

Descripción del módulo antifraude

801Tarjeta no autorizadaFraude por validación de BlackList802Tarjeta no autorizadaPosible Fraude por BlackList803Operación no autorizadaFraude por Velocity Check804Operación no autorizadaPosible fraude por Velocity Check805Operación no autorizadaError en validación concurrente, posible fraude por Velocity Check806Operación no autorizadaError en validación Velocity Check807Operación no autorizadaError general en validación de Antifraude810Operación no autorizadaFaltan campos requeridos en el requerimiento

Código	Descripción
00	APROBADA
500	No se encuentra la transaccion original
501	El campo WalletPosTrxId es requerido
502	El campo WalletType es requerido
503	No esta configurado una Compañia MP
504	No esta configurado una Caja MP
505	El tipo de billetera es invalido
506	El campo WalletPaymentId es requerido
507	El campo OriginalDate es requerido
508	No es posible devolver una devolucion
509	Estado trx original no acepta devolucion
510	Importe devolucion supero monto limite
511	No se pudo realizar la orden de pago
512	La transaccion no posee estado
513	El campo posTicket es requerido
514	Tiempo expirado. Elija Consultar o Cancelar pago
515	Tiempo expirado confirmacion devolucion
516	Pago aun no realizado, desea seguir esperando?
517	Estado trx original no acepta devolucion
518	No se encuentra la devolucion
519	Acceso a MP no esta autorizado
520	Accion a MP no esta autorizada
521	El campo WalletPosTrxId es invalido
523	Estado trx original no acepta devolucion
524	Importe invalido para devolucion
525	Estado trx original no acepta devolucion
526	Compañia MP no permite operar
527	Numero devoluciones parciales superados
528	El pago es antiguo para ser devuelto
529	No es posible devolver una devolucion
530	Compañia MP sin dinero para devolver
531	Compañia MP sin dinero disponible
532	Estado trx original no acepta devolucion
533	Devolucion parcial no soportada
534	Url de notificacion invalido
535	El monto de la transaccion es invalido
536	Error general por parte de MP
537	No se encuentra la transaccion original
538	El campo WalletPosTrxId es requerido
539	Devuelto
540	Pendiente
541	Autorizado
542	En Progreso
543	En mediacion
544	Rechazado
545	Cancelado
546	Contracargo
547	No se encontró la trx original
548	Error en comunicación
549	No existe comunicación con Mercado Pago
550	Error al consultar venta original online
552	Orden no generada por Prisma
553	Pago Rechazado por parte de Prisma
554	Esta operación requiere autorización
555	Esta operación requiere autorización
556	Pago rechazado, reintente con otro medio de pago
557	Pago rechazado, reintente con otro medio de pago
558	Pago rechazado, reintente con otro medio de pago
559	Pago rechazado, reintente con otro medio de pago
560	Pago rechazado, reintente con otro medio de pago
561	No fue posible procesar su pago, intente más tarde
562	No fue posible procesar su pago, intente más tarde
563	No fue posible procesar su pago, intente más tarde
564	No fue posible procesar su pago, intente más tarde
565	No fue posible procesar su pago, intente más tarde
566	La cantidad de cuotas seleccionada es inválida
567	La cantidad de cuotas seleccionada es inválida
568	Tarjeta de crédito vencida
569	Tarjeta de crédito no habilitada
570	Fondos insuficientes, reintente otro medio de pago
571	Fondos insuficientes, reintente otro medio de pago
572	Datos incorrectos, revíselos y reintente
573	Datos incorrectos, revíselos y reintente
574	No fue posible procesar su pago, intente más tarde
575	No fue posible procesar su pago, intente más tarde
576	Tarjeta no vigente, reintente otro medio de pago
577	Esta operación requiere autorización
578	No fue posible procesar su pago, intente más tarde
579	No fue posible procesar su pago, intente más tarde
580	La cantidad de cuotas seleccionada es inválida
581	Datos incorrectos, revíselos y reintente
582	Datos incorrectos, revíselos y reintente
583	Las cuotas informadas son incorrectas
584	No existe la compra que se desea anular
585	El originante no es válido
586	El comercio informado es inválido
587	El establecimiento informado es inválido
588	El establecimiento no pertenece al comercio
589	El punto de venta informado es inválido
590	El punto de venta no pertenece al establecimiento
591	El tipo de documento es inválido
592	Se debe informar el ID de la operación
593	Se debe informar un timeStamp
594	Se debe informar el traceNumber
595	Intención de pago vencida
598	Las cuotas del pago ya fueron informadas
650	Importe de devolución de cashout invalido
651	Importe de cashout invalido
652	Medio de pago inválido
733	La transacción no corresponde a una operación de Billeteras Electrónicas
734	No es posible cancelar la transacción informada

6.2.3 Códigos de Respuesta de VTOL Server para Antifraude

A continuación se detallan las respuestas posibles de VTOL Server, cuando se opera con Antifraude:

	Datos incorrectos, revíselos y reintente
573	Datos incorrectos, revíselos y reintente
574	No fue posible procesar su pago, intente más tarde
575	No fue posible procesar su pago, intente más tarde
576	Tarjeta no vigente, reintente otro medio de pago
577	Esta operación requiere autorización
578	No fue posible procesar su pago, intente más tarde
579	No fue posible procesar su pago, intente más tarde
580	La cantidad de cuotas seleccionada es inválida
581	Datos incorrectos, revíselos y reintente
582	Datos incorrectos, revíselos y reintente
583	Las cuotas informadas son incorrectas
584	No existe la compra que se desea anular
585	El originante no es válido
586	El comercio informado es inválido
587	El establecimiento informado es inválido
588	El establecimiento no pertenece al comercio
589	El punto de venta informado es inválido
590	El punto de venta no pertenece al establecimiento
591	El tipo de documento es inválido
592	Se debe informar el ID de la operación
593	Se debe informar un timeStamp
594	Se debe informar el traceNumber
595	Intención de pago vencida
598	Las cuotas del pago ya fueron informadas
650	Importe de devolución de cashout invalido
651	Importe de cashout invalido
652	Medio de pago inválido
733	La transacción no corresponde a una operación de Billeteras Electrónicas
734	No es posible cancelar la transacción informada

6.2.3 Códigos de Respuesta de VTOL Server para Antifraude

A continuación se detallan las respuestas posibles de VTOL Server, cuando se opera con Antifraude:

Código	Descripción de respuesta al POS	Descripción del módulo antifraude
801	Tarjeta no autorizada	Fraude por validación de BlackList
802	Tarjeta no autorizada	Posible Fraude por BlackList
803	Operación no autorizada	Fraude por Velocity Check
804	Operación no autorizada	Posible fraude por Velocity Check
805	Operación no autorizada	Error en validación concurrente, posible fraude por Velocity Check
806	Operación no autorizada	Error en validación Velocity Check
807	Operación no autorizada	Error general en validación de Antifraude
810	Operación no autorizada	Faltan campos requeridos en el requerimiento

Âncora
codRespFidelidad
codRespFidelidad
6.2.4 Códigos de Respuesta de VTOL para Consulta de tarjetas de Fidelidad

A continuación se detallan las respuestas posibles de VTOL Server, cuando se realizan consultas de tarjetas de fidelidad:

Código	Descripción	Observaciones
770	Cliente no encontrado en servicio de fidelidad	El servicio de fidelidad respondió que el cliente no fue encontrado en su base de datos.
771	El cliente no está activo en servicio de fidelidad	El servicio de fidelidad respondió que el cliente no tiene ninguna tarjeta activa.
772	Error en el servicio de fidelidad	Cuando el servicio de fidelidad no está disponible o se vence el timeout.
773	Error de configuración en VTOL.	VTOL valida que se encuentre configurada la API Key del Comercio para consultar con Bimo, en las propiedades de configuración. Si no están configurados en VTOL Server, o si Bimo responde un error 400, VTOL retorna este mensaje al POS.
774	Es requerido el documento del cliente	El POS no envió el número de DNI del cliente.
775	Es requerido el tipo de tarjeta de fidelidad	El POS no envió el tipo de tarjeta de fidelidad del cliente.
776	El documento no es valido	El número de DNI enviado no tiene el formato correcto.
777	Tipo de tarjeta de fidelidad no válido.	El tipo de tarjeta de fidelidad enviado no está soportado.
778	Consulta no disponible para esta billetera	El tipo de consulta no es soportado por el tipo de billetera enviado por el POS en el campo WalletType.

Âncora
_Códigos_de_Errores
_Códigos_de_Errores
Âncora
_Toc508730840
_Toc508730840
6.3 Códigos de Error del CORE de VTOL Server

...

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

Âncora
_Toc508730814
_Toc508730814
Índice

K. Procesar Mensaje Cuenta DNI

P. Consultar Bines de excepción

P. Consultar Bines de excepción

Q. Consultar Tarjetas de Fidelidad

Âncora
_GoBack
_GoBack

R. Cerrar Sesión

6.2.3 Códigos de Respuesta de VTOL Server para Antifraude

6.2.3 Códigos de Respuesta de VTOL Server para Antifraude

Âncora
codRespFidelidad
codRespFidelidad
6.2.4 Códigos de Respuesta de VTOL para Consulta de tarjetas de Fidelidad

Âncora
_Códigos_de_Errores
_Códigos_de_Errores
Âncora
_Toc508730840
_Toc508730840
6.3 Códigos de Error del CORE de VTOL Server

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 1

Nova versão 2

Chave

Âncora_Toc508730814_Toc508730814Índice

K. Procesar Mensaje Cuenta DNI

P. Consultar Bines de excepción

P. Consultar Bines de excepción

Q. Consultar Tarjetas de Fidelidad

Âncora_GoBack_GoBack

R. Cerrar Sesión

6.2.3 Códigos de Respuesta de VTOL Server para Antifraude

6.2.3 Códigos de Respuesta de VTOL Server para Antifraude

ÂncoracodRespFidelidadcodRespFidelidad6.2.4 Códigos de Respuesta de VTOL para Consulta de tarjetas de Fidelidad

Âncora_Códigos_de_Errores_Códigos_de_Errores Âncora_Toc508730840_Toc5087308406.3 Códigos de Error del CORE de VTOL Server

Âncora
_Toc508730814
_Toc508730814
Índice

Âncora
_GoBack
_GoBack

Âncora
codRespFidelidad
codRespFidelidad
6.2.4 Códigos de Respuesta de VTOL para Consulta de tarjetas de Fidelidad

Âncora
_Códigos_de_Errores
_Códigos_de_Errores
Âncora
_Toc508730840
_Toc508730840
6.3 Códigos de Error del CORE de VTOL Server