Image Removed
Manual de IntegraciónImage Added

VTOL EMVKIT AR 1.6.X

...

Painel
borderColor #E4E3E3
bgColor #ffffff
titleColor #ffffff
borderWidth 1px
titleBGColor #704581
title REVISIONES

Expandir
title Expandir revisiones

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
...
Índice
...
El presente documento explica la manera de integrarse a la Librería VTOL EMV Kit Argentina.
...
10/03/2020 1.43 Incorporación de mensaje de Sincronización de transacciones entre EMVKit y el POS.
30/07/2020 1.44 Incorporación de funcionalidad de Billeteras Mercado Pago con retiro de efectivo.
22/09/2020 1.45 Se actualiza el campo 54 (additionalAmount) como tipo de dato Importe, en la mensajería de Billeteras electrónicas.
26/11/2020 1.46 Agregado del campo Descripción en Configuración de POS para indicar la descripción sobre un plan de pago.
27/08/2021 1.47 Se quitan las referencias a la Billetera Todo Pago, ya que la misma fue desarrollada en versiones posteriores, dentro de la funcionalidad "QR Adquiriente Prisma".

Painel
borderColor #E4E3E3
titleColor #ffffff
borderWidth 1
titleBGColor #704581
title CONTENIDO

Expandir
title Expandir contenido
Índice

Âncora
_Toc508730814
_Toc508730814

Âncora
_Toc508730815
_Toc508730815
1. Introducción

Âncora
_Toc508730816
_Toc508730816
1.1 Acerca de este documento

El presente documento explica la manera de integrarse a la Librería VTOL EMV Kit Argentina.

Âncora
_Toc508730817
_Toc508730817
1.2 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:

...

Propiedad	Descripción	Valor por defecto
portName	Nombre del puerto	COM9
dataBits	Data bits length	8
stopBits			1
baudRate	Baud rate of serial port	19200
parity	Paridad	none
timeout	Default time to wait for response from PINPad. This time is expressed in milliseconds.	180000
pinEntryTimeout	Time in milliseconds to wait until card holder enters PIN. If card holder don't enter PIN during this milliseconds, then a packet 72 should be sent to PINPad to cancel PIN entry.	180000
bufferSize	Tamaño máximo del buffer de lectura del puerto serie.	2048
nativeImpleClass	Clase de driver nativo para comunicarse con el PINPad.
Y01Tec	Tiempo entre comandos expresado en segundos (Formato: NNN). Es el tiempo máximo que el PINPAD espera el siguiente comando.	035
firmwareVersion	Opcional. Indica la versión de compatibilidad de firmware con la que trabajará EMVKIT.
requiredInitAppVersions	Opcional (Solo para FD). Indica que versiones de compatibilidad de firmware requieren enviar mensaje de inicio al PINPAD
approveInSecondInstance	Opcional. Indica si EMVKIT permite que el PINPAD apruebe en segunda decisión, una transacción rechazada por el HOST.	True

...

Informações

title	Referencias

X = Obligatorio

O = Opcional

- = No requerido

Número	Nombre del campo	Tipo de dato	SalePEI	RefundPEI	QueryPEI	Descripción
3	server	Alfanumérico	X	X	X	Identificador del Server que procesará la transacción. Enviar "VTOL"
8	Cvc	Numérico	X	X	-	Código de seguridad de la tarjeta
9	track2	Alfanumérico	X	X	X	Track2 de la tarjeta entero (se envía todo el contenido del track2 en este campo)
10	inputMode	Alfanumérico	X	X	X	Forma en que se ingresó/leyó la tarjeta. Valor posible: MSR – Leída por banda magnética
11	trxType	Alfanumérico	X	X	X	Tipo de Transacción: SalePEI = Compra PEI RefundPEI = Devolución PEI QueryPEI = Consulta de transacción PEI
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 Para operaciones PEI el monto tendrá un TOPE, el cual estará definido por LINK, quienes validan que no se supere por transacción el equivalente a un Salario Mínimo, Vital y Móvil.
13	currencyPosCode	Alfanumérico	X	X	-	Tipos de Moneda: $ = Pesos U$S = Dólares
25	dateTime	Numérico	X	X	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
66	track1	Alfanumérico	X	X	X	Track1 de la tarjeta entero (se envía todo el contenido del track1 en este campo)
153	idOperationPEI	Alfanumérico	-	X	-	Identificador de la operación PEI de pago que se desea devolver
155	cbu	Alfanumérico	-	O	-	CBU de la cuenta destino de la devolución asociada con la tarjeta Banelco. Si el dato se envía, el valor es validado por Link
156	cbuAlias	Alfanumérico	-	O	-	Alias del CBU de la cuenta destino de la devolución asociada con la tarjeta Banelco. Si el dato se envía, el valor es validado por Link
157	customerDoc	Alfanumérico	X	O	-	Número de documento del titular de la tarjeta
158	lastFourDigits	Numérico	X	X	-	Últimos 4 dígitos de la tarjeta. La solicitud de la validación de los últimos 4 dígitos de la tarjeta es configurable por prefijo
161	operationConcept	Numérico	O	-	-	Concepto por el cual se realiza la operación, valores posibles: 1 = COMPRA_DE_BIENES 2 = PAGO_DE_SERVICIOS
173	dateTimeOriginalTrx	Numérico	-	-	X	Fecha y hora de realización de la transacción de venta o devolución que se desea consultar en formato YYYYMMDDHHMMSS. Se debe enviar el valor del campo 25 de la transacción a consultar

...

Request to EMV Kit (SalePEI):

Request: {158:9002;66:%b778899000000049002^apellido24/nombre24 ^371212000000000840;157:34000499;13:$;12:100;11:SalePEI;10:MSR;9:778899000000049002=371212000000000840;8:523;25:20180904131343;161:1;3:VTOL}

Request to EMV Kit (RefundPEI):

Request: {158:9002;66:%b778899000000049002^apellido24/nombre24 ^371212000000000840;157:34000499;156:alias;155:12345678945612345879;153:5439999999999999543;13:$;12:100;11:RefundPEI;10:MSR;9:778899000000049002=371212000000000840;8:523;25:20180904131400;3:VTOL}

Request to EMV Kit (QueryPEI):

Request: {10:MSR;9:778899000000049002=371212000000000840;173:20180904131400;25:20180904131915;11:QueryPEI;66:%b778899000000049002^apellido24/nombre24 ^371212000000000840;3:VTOL}

Respuesta

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

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

...

El mensaje queryPEI debe generarse dentro de la sesión del POS en la cual se realizó la operación de pago o devolución PEI, es decir que previamente se ejecutaron las operaciones de "Leer datos de tarjeta" y "Procesar operación con tarjeta". Esto se debe a que la consulta a Link se deben enviar los track 1 y 2 de la tarjeta.

Requerimiento

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
11	trxType	Alfanumérico	X	Tipos de Transacciones: QueryPEI = Consulta de transacción
25	dateTime	Numérico	X	Fecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS
173	dateTimeOriginalTrx	Numérico	X	Fecha y hora de realización de la transacción de venta o devolución que se desea consultar en formato YYYYMMDDHHMMSS. Se debe enviar el valor del campo 25 de la transacción a consultar.

...

Request: {173:20190122093302;25:20190122093352;11:QueryPEI;0:1}

Respuesta

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
11	trxType	Alfanumérico	X	Tipo de Transacción: PrintTrxVoucher: imprime el comprobante
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
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"
1118	voucherParameters	Mapa	X	Se informa con el siguiente formato [copyCount\|nroCopia] la cantidad de copias a efectuar del comprobante, donde: nroCopia = 1 es copia comercio nroCopia = 2 es copia comercio y cliente nroCopia = 0 no imprime voucher físico. Disponible únicamente en caso de solicitar firma digital (requestSignature =1).
1130	requestSignature	Numérico	X	Se informa si se solicitará o no la firma en el Pinpad. Valores posibles: 0: no solicita firma digital, pero se imprime el texto "Firma" en el ticket físico. No genera comprobante digital. 1: solicita firma digital y genera comprobante digital. 2: no solicita firma y no genera comprobante digital. NotaImportante: En caso de no solicitar firma digital (opciones 0 y 2), no se genera el archivo .POS (del comprobante) por lo que no se tendrá constancia del mismo en VTOL Server.
1131	voucherHeader	Mapa	O	Se informa la leyenda del header del comprobante con el siguiente formato [headerNro\|detalle,...,headerNro\|detalle], donde Nro es un número del 1 al 5 y detalle es la leyenda a imprimir. El largo máximo para cada línea es de 40 caracteres
1132	clientDNI	Alfanumérico	O	DNI del cliente. Valor hasta 9 caracteres
1133	billNumber	Numérico	O	Número de la factura. Valor hasta 11 caracteres
1134	voucherPromoMessage	Mapa	O	Se informa el mensaje de promoción con el siguiente formato [promotionalNro\|detalle,...,promotionalNro\|detalle], donde Nro es un número del 1 al 7 y detalle es la leyenda de promoción a imprimir. El largo máximo para cada línea es de 28 caracteres Nota: A partir del firmware 810 de FirstData, se podrá enviar o el campo 1134 - voucherPromoMessage o el campo 1135 - voucherPromoLine
1135	voucherPromoLine	Alfanumérico	O	Se informa la promoción obtenida. Valor hasta 40 caracteres	1136	billType	Alfanumérico	Nota: A partir del firmware 810 de FirstData, se podrá enviar o el campo 1134 - voucherPromoMessage o el campo 1135 - voucherPromoLine
1136	billType	Alfanumérico	O	Tipo de factura. Valor hasta 1 caracter

...

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

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

...

La anulación, no precisa de interacción por parte del comprador en la caja. Simplemente el POS envía el identificador del número de pago del Autorizador en el mensaje RefundWallet.

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).

operar cashout con Mercado Pago

Se podrán realizar las siguientes operaciones:

Ventas

Ventas de productos y retiro de efectivo
- En estos casos, se aprueban ambas cosas. No es posible obtener aprobaciones parciales.

Devoluciones

Realizar devoluciones de los productos y del cashout.

- Operación de venta con productos y cashout. Permite devolver en una misma transacción, lo siguiente:
  - Devolución total de los productos y del cashout
  - Devolución parcial de los productos, y devolución total del cashout
  - Devolución total o parcial solo de los productos
  - Devolución total solo del cashout
  - Varias devoluciones parciales de los productos
- Operación de venta sólo con productos. Permite devolver en una misma transacción, lo siguiente:
  - Devolución total o parcial de los productos
  - Varias devoluciones parciales de los productos
En la operación de devolución parcial de productos, se permiten efectuar varias devoluciones parciales de un pago. Se pueden realizar hasta 20 devoluciones parciales a un mismo pago. VTOL valida que no se supere el monto de la venta.
La devolución de cashout siempre debe ser por el monto total.

Anulaciones

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.

Requerimiento

Informações

Referencias:

X = Obligatorio
O = Opcional
- = No requerido

14payments-OO

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-)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
16	originalDate	Numérico	-	X	X	Cantidad de cuotas por las cuales se realizará el pago. 2 dígitos como máximo Si es sin cuotas, el valor por defecto es 1
15	plan	Alfanumérico	-	-	O	Plan. 1 caracter de longitud
16	originalDate	Numérico	-	X	X	Fecha de realización de la compra con billetera electrónica en formato YYYYMMDD
24	lastTrxId	Numérico	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	53additionalAmount	Importe	paymentConditionO	AlfanuméricoO	-	-	O	Condición de pago. Sólo se encuentra presente si existe una condición de pago vinculada con la transacción 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 Pago2: Todo 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	1102	provider	Alfanumérico	-	-	Proveedor / tarjeta seleccionada manualmente de la lista devuelta por la librería. Por Ejemplo: Si el saleWallet retorna la lista {VI, EL}, en el querySaleWallet se debe enviar el valor seleccionado entre las dos opciones VI o EL.

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

...

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í

...

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

Elemento	Tipo de dato	Descripción	Requerido	Valor ante ausencia
Ítem	*unitprice*	*unitprice*	Numérico positivo	Precio unitario del artículo 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"

Ejemplo

...

Informações

Referencias

X = Obligatorio
O = Opcional
- = No requerido

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
6	cardNumber	Alfanumérico	O	-	O	Tarjeta enmascarada seleccionada al momento de efectuar el pago QR.
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. 2 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	157	customerDoc	Numérico	O	O	O	Numero de documento del titular de la tarjeta.
303	customerName	Alfanumérico	O	O	O	Nombre del titular de la tarjeta.
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
11021010	providercurrentSessionId	ListaNumérico	OX	-X-	X	Lista de proveedores/tarjetas que coinciden con la tarjeta ingresada en la app de la billetera electrónica. Ejemplo: {VI, EL}. Esta lista deberá ser utilizada para seleccionar la tarjeta manualmente por el POS.
1010	currentSessionId	Numérico	X	X	X	Identificador de la sesión
1027	libResponseCode	Numérico	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

...

Response from VTOL (SaleWallet):

Response message: {1:1;2:1;1027:000;1028:Ok;166:14021905052200000204;271:2289999999999999228;1010:1550131493463;22:1234567;24:121;25:20190214050518;26:ISO8583;27:00;28:APROBADA}

Response from VTOL (RefundWallet):

Response message: {1:1;2:1;1010:1550131493463;1027:000;1028:Ok;25:20190214050543;26:ISO8583;27:509;28:Estado trx original no acepta devolucion}

Response from VTOL (QuerySaleWallet):

Response message: {1:1;2:1;1027:000;1028:Ok;6:450995xxxxxx3704;140:0;12:53.0;13:$;14:1;142:visa;271:2289999999999999228;272:0.0;273:0;274:accredited;1010:1550131493463;275:1;22:1234567;24:121;25:20190214050534;26:ISO8583;27:00;28:APROBADA}

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" 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

...

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

Requerimiento

Número

Nombre del campo

Tipo de dato

SalePEI

RefundPEI

QueryPEI

Descripción

3

server

Alfanumérico

X

Identificador del Server que procesará la transacción.

Enviar "VTOL"

10

inputMode

Alfanumérico

X

Forma de ingreso:

barCode

BarCode

softToken

SoftToken
11	trxType	Alfanumérico	X	X	X	Tipo de Transacción: SalePEI = Compra Cuenta DNI PEI RefundPEI = Devolución Cuenta DNI PEI QueryPEI = Consulta de transacción Cuenta DNI PEI
12	amount	Importe	X	X	-	Monto de la transacción de Venta o de Devolució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 Se validará el importe enviado por el POS: En la venta: que el importe sea mayor a 0. En la devolución: que el importe sea mayor a 0 y menor al importe original de venta. Si el POS informa un importe igual que el original de venta, o no lo informa, corresponde a una devolución Total. Si el POS informa un importe menor que el original de venta, corresponde a una devolución Parcial.
13	currencyPosCode	Alfanumérico	X	X	-	Tipos de Moneda: $ = Pesos U$S = Dólares
25	dateTime	Numérico	X	X	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
153	idOperationPEI	Alfanumérico	-	X	O	Identificador de operación Cuenta DNI PEI de pago que se desea devolver o consultar.
157	customerDoc	Alfanumérico	O	-	-	Número de documento del titular de la cuenta. Obligatorio junto con softToken, únicamente si el modo de ingreso es softToken.
173	dateTimeOriginalTrx	Numérico	-	-	X	Fecha y hora de realización de la transacción de venta o devolución que se desea consultar en formato YYYYMMDDHHMMSS. Se debe enviar el valor del campo 25 de la transacción a consultar.
279	softToken	Alfanumérico	O	-	-	Token generado por la app mobile. Este token se lo informa el cliente al cajero, para que sea ingresado en el POS. Obligatorio junto con customerDoc, únicamente si el modo de ingreso es softToken.
300	barCode	Alfanumérico	O	-	-	Código generado por la app mobile. Este código se lo informa el cliente al cajero, para que sea ingresado en el POS. Obligatorio únicamente si el modo de ingreso es barCode.

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

Respuesta

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

L. Procesar Mensaje Promociones PEI

...

Informações
Referencias X = Obligatorio O = Opcional - = No requerido

Requerimiento

Número	Nombre del campo	Tipo de dato	PromoPei	Descripción
3	server	Alfanumérico	X	Identificador del Server que procesará la transacción. Enviar "VTOL"
11	trxType	Alfanumérico	X	Tipo de Transacción: PromoPei
301	originalTrxType	Alfanumérico	X	Identificador del Tipo de Promoción que se está informando. Valores posibles: "1" para Pagos con promociones y "2" para Devoluciones de pagos con promoción.
12	amount	Importe	X	Monto total de la transacción original de venta, debe ser el mismo valor. 12 dígitos como máximo. Se envía sin coma. Los dos últimos dígitos representan los decimales.
13	currencyPosCode	Alfanumérico	X	Tipos de Moneda: $ = Pesos U$S = Dólares
302	promoAmount	Importe	X	Importe para informar una promoción o para informar la devolución de un pago con promoción. En donde los últimos 2 dígitos serán los decimales. Puede ser igual al importeOperacion (amount), en el caso en que todo el importe del pago esté sujeto a promoción. Pero no puede superar el importeOperacion. Para informar una Promoción en una Venta, se informará la sumatoria del importe de los productos sujetos a promoción. Si el pago completo está sujeto a promoción, el PromoAmount será igual a amount. El mismo comportamiento se aplicará para informar la Devolución de un pago sujeto a promoción. Se informará la suma del importe de los productos que fueron sujetos a promoción en la venta.
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
153	idOperationPEI	Alfanumérico	X	Identificador de operación PEI de pago que devuelve Link en la respuesta del pago.
278	bankingRefNum	Alfanumérico	X	Número de referencia bancaria de la operación de pago. Es devuelta por Link en la operación de pago.

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

Respuesta

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

VTOL EMVKIT AR 1.4.X#_Toc5087308386.1C%C3%B3digosdeRespuestadeEMVKIT

Códigos de Respuesta de Librería
1028	libResponseMessage	Alfanumérico	X	Mensaje descriptivo del código de respuesta de la librería

M. Obtener Configuración de POS

Operación que permite a la aplicación de punto de venta obtener la información existente en VTOL Server relacionada con los planes, cuotas, tarjetas, prefijos y bines de excepción.

Mensajería

Requerimiento

Número

Nombre del campo

Tipo de dato

getConfiguration

Descripción

11

trxType

Alfanumérico

X

Tipo de Transacción:

getConfiguration: solicitud de configuración de POS

...

Request to Full library: {11:getConfiguration}

Respuesta

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

...

Mensajería que permite realizar operaciones con tarjetas Contactless, leídas por el pinpad de First Data. También será posible operar con cualquier modo de ingreso: Manual, Banda y Chip.

Aviso

...

Sólo compatible con tarjetas Mastercard y Pinpad de First Data

...

firmware A809R02 o superior.

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
11	trxType	Alfanumérico	X	X	X	X	X	Tipo de Transacción: Sale = Compra VoidSale = Anulación de venta Refund = Devolución VoidRefund = Anulación de devolución SaleCashBack = Compra con extracción de efectivo
22	authorizationCode	Alfanumérico	O	O	O	O	O	Código de autorización telefónica. 6 dígitos como máximo. Este campo se encuentra presente sólo si la transacción se autorizó off-line por teléfono. Obligatorio solamente cuando la autorización fue aprobada telefónicamente. No disponible para operaciones por Contactless.
24	lastTrxId	Numérico	O	O	O	O	O	Utilizado cuando está activo el control transaccional. En este campo el POS debe enviar la última transacción procesada correctamente.(Si el POS tuvo algún problema con la transacción previa no debería enviar su trxId en este campo)
25	dateTime	Numérico	X	X	X	X	X	Fecha y hora de realización de la transacción, en formato: YYYYMMDDHHMMSS
12	amount	Numérico	X	X	X	X	X	Importe. 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
13	currencyPosCode	Alfanumérico	X	X	X	X	X	Tipos de Moneda: $ = Pesos U$S = Dólares
54	additionalAmount	Alfanumérico	-	-	-	-	X	Contiene el Importe del "Cash Back". Se usa en transacciones del tipo SaleCashBack. Debe contener 12 dígitos como máximo. Los últimos dos representan los decimales.
14	payments	Numérico	O	O	O	O	O	Cantidad de cuotas. 2 dígitos como máximo Si no tiene cuotas, el valor por defecto es 1.
15	plan	Alfanumérico	O	O	O	O	O	Plan. 1 caracter de longitud
16	originalDate	Fecha	-	-	X	-	-	Este campo debe viajar si el tipo de transacción es Refund. Se trata de la fecha de la transacción original en el formato YYYYMMDD
17	originalTrxTicketNr	Numérico	-	O	X	-	-	Este campo debe viajar si el tipo de transacción es Refund y es opcional cuando el tipo de transacción es VoidSale. Se trata del número de ticket de la transacción original. 4 dígitos como máximo.
73	interestAmount	Alfanumérico	O	O	O	O	O	Este campo es por si se necesita enviar el monto de los intereses en el mensaje a Autorizar. Normalmente el monto que llega del POS ya contiene los intereses en el caso de pagar en cuotas. Existe algún caso de alguna tarjeta especial donde el monto hay que enviarlo libre de intereses y justamente el monto de los intereses viaja en este campo.
1102	provider	Alfanumérico	O	O	O	O	O	Proveedor/tarjeta seleccionada por el POS.

...

Campo para solicitar firma al cliente. Valores posibles:

False: no requerido
True: 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	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	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		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	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	Campo para solicitar firma al cliente. Valores posibles: False: no requerido True: requerido

Âncora
synchronize
synchronize
O. Sincronizar transacciones

Mensaje que permite sincronizar el estado de las operaciones entre la aplicación de punto de venta y la librería EMVKIT. Se utilizará cuando está activo el control transaccional.

El POS puede utilizar este mensaje luego de recibir una respuesta de operación aprobada por parte de la librería. Enviará el ID de la última transacción procesada correctamente. Internamente EMVKIT se sincroniza con VTOL Server, confirmando o reversando la transacción.

Este mensaje podrá ser utilizado para confirmar o cancelar una transacción antes de hacer un cierre de sesión con EMVKit. Es una alternativa al control transaccional, pero si no se usa el Synchronize, se debe usar el mecanismo tradicional de control transaccional.

A continuación se detallan dos ejemplos de aplicación de este mensaje.

1. Dos ventas distintas dentro de la misma sesión:

Se crea sesión
- Se realiza una venta con Mercado Pago y el resultado es Aprobado. trxId 10
  - El POS envía un Synchronize con id 10. Lo cual confirma dicha transacción.
- Se realiza otra venta con Mercado Pago y el resultado es Rechazado por MP. trxId 11
  - El POS envía un Synchronize con lastTrxId 10. En ese momento la transacción 11 es reversada tanto en VTOL como en MP.
- La venta que no pudo ser realizada con Mercado Pago, se realiza con tarjeta de crédito. La cual finaliza Aprobada. trxId 12
Se cierra sesión informando los id {10, 12}.

2. Una misma venta con pagos parciales. Una parte se paga con tarjeta de crédito y la otra parte con Mercado Pago.

Se crea sesión
- Una parte de la venta se paga con tarjeta de crédito y el resultado es Aprobado. trxId 20
  - El POS envía un Synchronize con id 20. Lo cual confirma dicha transacción.
- La otra parte de la venta se paga con Mercado Pago y el resultado es Rechazado por MP. trxId 21
  - El POS envía Synchronize con lastTrxId 20. En ese momento la transacción 21 es reversada tanto en VTOL como en MP.
- La parte de la venta que no pudo ser pagada con Mercado Pago, se realiza con tarjeta de débito. La cual finaliza Aprobada. trxId 22
Se cierra sesión informando los id {20, 22}.

Mensajería

Requerimiento

Informações

title	Referencias

X = Obligatorio
O = Opcional
- = No requerido

Número

Nombre del campo

Tipo de dato

synchronize

Descripción

11

trxType

Alfanumérico

X

Tipo de Transacción:

- synchronize: sincronización con la librería

25

dateTime

Numérico

X

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

24

lastTrxId

Numérico

O

Utilizado cuando está activo el control transaccional. En este campo el POS debe enviar la última transacción procesada correctamente. (Si el POS tuvo algún problema con la transacción previa no debería enviar su trxId en este campo)

Ejemplo:

Bloco de código
Request to Full library: {25:20200310110302;24:55;11:synchronize}

Respuesta

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

Ejemplo:

Bloco de código
Response from Full library: {1028:Ok;1027:000}

Âncora
_GoBack
_GoBack

...

P. 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.

...

A continuación se detallan las respuestas posibles con una breve descripción de cada una:

Código	Descripción
'00'	Aprobada
'01'	Pedir autorización telefónica
'02'	Pedir autorización
'03'	Comercio inválido
'04'	Capturar tarjeta
'05'	Denegada
'07'	Retenga y llame
'11'	Aprobada
'12'	Transacción inválida
'13'	Monto inválido
'14'	Tarjeta inválida
'25'	No existe original
'30'	Error en formato
'38'	Excede ingreso de PIN
'43'	Retener tarjeta
'45'	No opera en cuotas
'46'	Tarjeta no vigente
'47'	PIN requerido
'48'	Excede máximo de cuotas
'49'	Error fecha de vencimiento
'50'	Entrega supera límite
'51'	Fondos insuficientes
'53'	Cuenta inexistente
'54'	Tarjeta vencida
'55'	PIN incorrecto
'56'	Tarjeta no habilitada
'57'	Transacción no permitida
'58'	Servicio inválido
'61'	Excede límite
'65'	Excede límite de tarjeta
'76'	Llamar al emisor
'77'	Error plan/cuotas
'85'	Aprobada
'86'	No envía fecha original
'89'	Terminal inválida
'91'	Emisor fuera de línea
'94'	Número de secuencia duplicado
'95'	Re-transmitiendo
'96'	Error en sistema
'98'	No aprobada
'99'	Error no clasificado
	Modo de ingreso inválido
	Proveedor inválido
	Error CVC
	Error creando mensaje
	Tipo de mensaje inválido
	No envía código de autorización
	Error en fecha efectiva
	Error en fecha vencimiento
	Tarjeta no efectiva
	No opera off-line
	Devolución monto mayor
	Original ya anulada
	Original ya devuelta
	Original reversada
	Moneda inválida
	No envía fecha
	Campo 71 inválido
	Campo 71 nulo
	CVC inválido
	Tarjeta inválida
	Track2 inválido
	No envía moneda
	No envía CVC
	Timeout
	Fecha original inválida
	No envía ticket original
	Ticket original inválido
	No envía código de autorización de venta referida
	Reintente
	Chiptokens Invalido
	Pinpad R. Cod. Error
	Pinpad A. Cod. Error

...

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

Código	Descripción
00	APROBADA
300	Se agoto el tiempo de espera
301	La sucursal ingresada es incorrecta
302	El concepto ingresado es incorrecto
303	El concepto ingresado no esta disponible
304	El concepto ingresado no esta habilitado
305	La cuenta destino del pago es incorrecta
306	La cuenta destino no esta habilitada
307	La cuenta origen del pago es incorrecta
308	La cuenta origen no esta habilitada
309	La Red destino del pago es incorrecta
310	La cuenta del comercio es incorrecta
311	La cuenta de la sucursal es incorrecta
312	El comercio supero el importe máximo
313	La sucursal supero el importe máximo
314	La tarjeta ha superado el importe diario
315	Comercio ha superado el importe diario
316	Comercio ha superado el importe mensual
317	Comercio supero las trxs diarias
318	Comercio supero las trxs mensuales
319	La sucursal supero el importe diario
320	La sucursal supero el importe mensual
321	La sucursal supero las trxs diarias
322	La sucursal supero las trxs mensuales
323	Encriptacion incorrecta
324	El DNI no coincide con el de la tarjeta
325	Los datos de tarjeta no se condicen
326	El comercio es invalido
327	Cuenta destino del comercio es invalida
328	La tarjeta es invalida
329	La referencia de trx ya fue utilizada
330	El importe no es un numero mayor a cero
331	Ultimos 4 dig. no coinciden con la tarj.
332	Tarjeta inhabilitada para operar
333	Tarjeta vencida
334	Fondos insuficientes
335	El CBU Banelco ingresado es incorrecto
336	El ALIAS CBU Banelco es incorrecto
337	El id de pago es invalido
338	El id del canal es invalido
339	Importe excede saldo remanente del pago
340	El ID de requerimiento es invalido
341	IP de cliente invalida
342	Existe una devolucion aprobada del pago
343	El pago tiene devoluciones parciales
344	Pago no admite el tipo de devolucion
345	Pago no admite el tipo de devolucion
346	Terminal en uso
347	Terminal PEI Invalida
348	Comercio PEI Invalido
349	Sucursal PEI Invalida
350	Id operacion Requerido
351	Id operacion Rango invalido
352	Ultimos cuatro digitos invalidos
353	Numero de documento requerido
354	Trx original no se puede devolver
355	La cuenta es incorrecta
356	La cuenta no está habilitada
357	La cuenta del comercio es incorrecta
358	La cuenta de la sucursal es incorrecta
359	Comercio supero monto para concepto
360	Sucursal supero monto para concepto
361	Tarjeta supero monto tipo de operacion
362	Comercio supero monto tipo operacion
363	Comercio supero monto tipo operacion
364	Comercio supero cantidad transacciones
365	Comercio supero cantidad transacciones
366	Sucursal supero monto diario permitido
367	Sucursal supero monto mensual permitido
368	Sucursal supero cantidad trxs diarias
369	Sucursal supero cantidad trx mensuales
370	Error al desencriptar campos encriptados
371	La cuenta destino del comercio invalida
372	Ref de trx del comercio ya fue utilizada
373	Ultimos 4 digitos incorrectos
374	El ID de requerimiento enviado invalido
375	Error General
376	Concepto ingresado no habilitado
377	Concepto ingresado no habilitado
378	Cuenta es incorrecta
379	Cuenta no está habilitada
380	ALIAS CBU red Banelco es incorrecto
381	El pago tiene devoluciones parciales
382	Esta operacion no acepta devol. total
383	Esta operacion no acepta devol. parcial
384	La fecha es invalida
385	El estado del pago es invalido
386	El Concepto Operacion es invalido
387	Estado trx original no acepta devolucion
388	Importe devolucion supero monto limite
389	No se encontró la trx original
390	No es posible devolver una devolución
391	Error en comunicación
392	Campo DateTimeOriginalTrx invalido
393	Autorizacion Original en Proceso
600	El codigo de barras es requerido
601	El softToken es requerido
602	El importe de promoción es invalido
603	Original transaction type es requerido
604	El numero de referencia bancaria es requerido
605	El importe original informado es invalido
606	La venta original no tiene promoción aplicada
607	El numero de referencia bancaria es incorrecto
608	La venta original no permite promoción
609	Clave DNI inválido

Âncora
codrespbill
codrespbill
6.2.2 Códigos de Respuesta de VTOL Server para Billeteras Electrónicas

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
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

Consulte el pago por tiempo expirado

Tiempo expirado. Elija Consultar o Cancelar pago
515	Tiempo expirado confirmacion devolucion
516	No se encuentra el pago original
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 Todo Pago
553	Pago Rechazado por parte de TodoPago
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 en Todo Pago
598	Las cuotas del pago ya fueron informadas
599	Debe informar cuotas
650	Importe de devolución de cashout invalido
651	Importe de cashout invalido
733	La transacción no corresponde a una operación de Billeteras Electrónicas
734	No es posible cancelar la transacción informada

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

...

Pos.	Descripción	Longitud	Tipo de dato	Detalle
1	HD	2	AN	Identificador de tipo de registro
2	Local	6	AN	Código local.
3	Incremental	6	N	Nº de incremental.
4	CRC	8	N
5	Fecha / Hora	16	AN	Fecha/Hora. yyyy/mm/dd

...

Pos	Descripción	Longitud	Tipo de dato	Detalle
1	PF	2	AN	Identificador de tipo de registro
2	Hasta	20	AN	Rango Desde.
3	Desde	20	AN	Rango Hasta.
4	Largo prefijo	2	N	Largo del prefijo.
5	Largo tarjeta	2	N	Largo de la tarjeta.
6	ID Tarjeta	2	AN	ID proveedor VTOL
7	Condición	10	AN
8	Largo CVC	2	N	Largo código seguridad.
9	Validar digito	1	N	Valida el digito verificador.
10	Envía Track I	1	N	0/vacío deshabilitado / 1 habilitado / 2 Opcional.
11	Validar vencimiento	1	N	Valida fecha vencimiento.
12	Offline permitido	1	N	Permite operar offline.
13	Offline monto	14	N	Límite para operación Offline.
14	Habilitado	1	N	Prefijo habilitado.
15	Valida fecha efectiva	1	N	Valida fecha emisión o fecha desde.
16	Valida CVC	1	N	0/vacío deshabilitado / 1 habilitado / 2 Opcional.
17	Service code	5	AN	Se suele utilizar en VTOL para diferenciar Visa débito (2) de Visa crédito (0 ó vació)
18	Ingreso manual permitido	1	N
19	Chequea boletines	1	N	Valida contra boletines protectivos.
20	Es debito	1	N	Es prefijo de tarjeta de tipo débito. (0/vacío ó 1)
21	Requiere pin.	1	N	0 deshabilitado / 1 habilitado / 2 Opcional.
22	Valida últimos N números.	2	N	Cantidad de últimos números a validar de la tarjeta. 0 no valida nada.
23	Pide tipo de cuenta.	1	N	Requiere envío tipo de cuenta. (0 ó 1)
24	Solicita número de cuenta	1	N	Solicita al autorizador el número de cuenta. (0 ó 1)
25	Cashback	1	N	Habilita la operatoria de Cashback
26	Puntos de Lealtad	1	N	Habilita la acumulación y/o redención de puntos de lealtad.
27	Tarjeta que Encripta punto a punto POS - CA.	1	N	Indica si la tarjeta encripta. (0 ó 1)
28	Posición de la Master Key	1	N	Indica la posición de la Master Key en los registros del Firmware. Valores posibles: 0: Mastercard y Maestro 1: Visa 1 99: Indica que el Pinpad no tiene registro para la MK. Es el caso de tarjeta Amex.
29	Código de banco	10	AN	Código del banco
30	Permite Fallback	1	N	Visa 1; Mastercard y Maestro 0
31	CashBack Amount Limit	10	N	Límite de importe Cashback

...

Pos.	Descripción	Longitud	Tipo de dato	Detalle
1	PP	2	AN	Identificador de tipo de registro
2	ID Tarjeta	2	AN	ID proveedor VTOL
3	Símbolo moneda	10	AN
4	Condición de pago	20	AN	Información adicional del plan de pago.
5	Plan	4	N
6	Cuotas	4	N
7	Numero de comercio	30	AN
8	ID Lote	6	N
9	Limite a superar.	13	N	Monto a superar para poder utilizar el plan de pagos. En formato 0000000000.00 0 indica sin límite
10	Limite intereses	13	N	Si el monto es superior a éste valor, entonces el interés es = 0 En formato 0000000000.00 0 indica sin límite
11	Interés	5	AN	Tasa de interés (%) para el plan de pago. En formato 00.00 0 indica sin interés
12	Promocional	1	N	Activa con 1 o Desactiva con 0 Si aplica o no una promoción para el plan de pago.
13	Descripción	20	AN	Descripción del Plan de pago.

Ejemplo:

PP:AM;$;;0;1;98765432;101607;0000000000.00;0000000000.00;12.30;1;Normal
PP:VI;$;;0;10;98765432;101608;0000000100.00;0000000000.00;15.00;0;Normal

Tabla Definición de Lote

Pos.	Descripción	Longitud	Tipo de dato	Detalle
1	DL	2	AN	Identificador de tipo de registro
2	ID Lote	6	N	Identificador interno de Lote en VTOL
3	Caja o Nodo	10	N
4	Número de serie terminal	200	AN

Ejemplo:
DL:5;0000000001;99990080
DL:5;0000000002;99990081
DL:5;0000000003;99990082
DL:5;0000000004;99990083
DL:5;0000000005;99990084
DL:5;0000000006;99990085
DL:5;0000000007;99990086

Tabla Bines de Excepción

...

Ref	Dato	Canal VISA	Canal POSNET	Canal AMEX	Campo EMV Kit	Nota
1	Tipo de transacción u operación Opciones VISA: Compra Compra + Extracción Anulación de compra Anulación de compra + Extracción Devolución Anulación de devolución Opciones Posnet y AMEX: Compra Compra + Retiro Anulación de compra Anulación de compra + Retiro Devolución Anulación de devolución	X	X	X	11 - trxType
2	Número de comercio o establecimiento asignado por el Emisor	X	X	X	30 - businessNumber
3	Número de Terminal	X	X	X	29 - serialNumber
4	Número de Lote	X	X	X	31 - lotNumber
5	Número de cupón correspondiente a la transacción	X	X	X	32 - ticket
6	Últimos 4 números de la tarjeta	X	X	X	1106 - panLastDigit	Cuando VISA autoriza, se debe enmascarar toda la tarjeta con X exceptuando los últimos 4 dígitos. Cuando Posnet autoriza, se deberá imprimir el número de tarjeta enmascarando con el carácter “*” o “#” los primeros doce dígitos de la misma, a solicitud de cada emisor. Nota: Tener en cuenta que la longitud de la tarjeta puede variar
7	Modo de ingreso del número de tarjeta Opciones VISA: (M): Manual (B): Banda (C): Chip (F): Fallback (EMV Kit devuelve MSR Chip, pero deberá imprimirse (F) o Fallback) Opciones Posnet: (*): Manual Blanco: Banda	X	X	X	10 - inputMode	Cuando el ingreso es manual (Mastercard), se debe dejar en el voucher un espacio de embozado para marcar el relieve de la tarjeta
8	Fecha de vencimiento de la tarjeta	X	X	X	7 - expiration, pero la fecha de vencimiento de la tarjeta debe ser siempre XX/XX	La fecha de vencimiento de la tarjeta siempre va enmascarada
9	Número de cuenta	O	O	O	75 - accountNumber	Se debe imprimir el número de cuenta en caso de que la tarjeta lo devuelva En Posnet, cuando se reciba al menos un asterisco (“*”) se deberá imprimir el Número de Tarjeta en forma completa y se deberá imprimir el campo Número de Cuenta tal como se lo recibió
10	Tarjeta o proveedor con que se efectuó la operación	X	X	X	33 - creditCardIssuerName
11	Importe y moneda de la operación	X	X	X	12 - amount y 13 - currencyPosCode
12	Cantidad de cuotas	X	X	X	14 - payments
13	Identificador de la aplicación (AID)	O	-	O	1110 - pinpadApplicationId	Se debe imprimir este valor en caso de que el ingreso de la tarjeta sea Chip y cuando el valor sea devuelto
14	Nombre de la aplicación (APN)	O	-	O	1111 - pinpadApplicationName	Se debe imprimir este valor en caso de que el ingreso de la tarjeta sea Chip y cuando el valor sea devuelto
15	Modo de autorización	X	X	X	23 - authorizationMode	Cuando la transacción es offline, se debe dejar en el voucher un espacio de embozado para marcar el relieve de la tarjeta
16	Código de autorización otorgado por el Emisor	X	X	X	22 - authorizationCode
17	Número de cupón original	O	O	O	17 - originalTrxTicketNr	Sólo en las transacciones de Anulaciones de compra y Devoluciones
18	Fecha del cupón original	O	O	O	16 - originalDate	Sólo en las transacciones de Devoluciones
19	Importe y moneda de la extracción en efectivo	O	O	-	54 - additionalAmount
20	Importe y moneda total de la operación (suma entre la compra/anulación y la extracción)	O	O	-	N/A	Sólo en operación compra + extracción y anulación de compra + extracción
21	Tipo de cuenta de tarjetas de débito Maestro Opciones: Caja de ahorros en pesos Cuenta corriente en pesos Caja de ahorros en dólares Cuenta corriente en dólares	O	O	-	57 - accountType	Exclusivo para tarjetas Maestro. Mastercard Debit no solicita el ingreso de este dato ni se imprime en el voucher
22	Tipo de plan	O	O	-	15 - plan	Sólo para emisores que lo requieran
23	Nombre del tarjeta habiente	O	O	O	1112 - cardHolderName	Nombre del titular de la tarjeta si el track I está presente y la lectura fue por banda
24	Versión del software o aplicación	X	X	X	82 - softwareVersion
25	Resultado descriptivo de la operación	O	O	O	27 - isoCode
26	Leyenda "Operación a confirmar"	O	-	-	N/A	Cuando es una devolución realizada por VISA, siempre se debe imprimir esta leyenda en el voucher
27	Mensaje adicional	O	-	-	81 - responseAuth	Es opcional y se puede agregar para informarle alguna información adicional al cliente
28	Tipo de tarjeta	X	X	X	1113 - cardIsDebit	Tarjeta de débito o tarjeta de crédito
-	Verificación de pin offline	-	-	O	59 - offlinePinCheck	Si el dato se encuentra, se imprime en el voucher
-	Tipo de criptograma y valor	-	-	O	1138 - emvData	Sólo será retornado en operaciones CHIP con tarjetas Amex
-	Número de referencia de recuperación (RRN)	-	-	O	68 - rrn

...

Nota

Ubicación de los datos
La ubicación de los datos en el voucher no poseen alguna obligatoriedad, pero se recomienda seguir una estructura lógica como ser que los datos del cliente a completar se encuentren al final del voucher o que la fecha y hora se encuentren en la cabecera del voucher
Original y Copia
Los mencionados en esta documentación son los vouchers "Original Comercio", los vouchers "Copia Cliente" deberán ser similares pero contener esta nota al pie del voucher y omitir los datos a completar (Firma, Aclaración y Tipo y N° Doc)
Vouchers de rechazo
Cuando la operación resulte rechazada, el POS deberá imprimir un voucher similar a los mencionados pero informando solamente la terminal, el número de comercio y el motivo del rechazo obtenido del campo 28 - responseMessage

...

Árvore de páginas

Versões comparadas

Versão antiga 7

Nova versão Atual

Chave

VTOL EMVKIT AR 1.6.X

Âncora
_Toc508730814
_Toc508730814

Âncora
_Toc508730815
_Toc508730815
1. Introducción

Âncora
_Toc508730816
_Toc508730816
1.1 Acerca de este documento

Âncora
_Toc508730817
_Toc508730817
1.2 Qué es EMVKIT?

K. Procesar Mensaje Cuenta DNI

L. Procesar Mensaje Promociones PEI

M. Obtener Configuración de POS

Âncora
synchronize
synchronize
O. Sincronizar transacciones

Âncora
_GoBack
_GoBack

P. Cerrar Sesión

Âncora
codrespbill
codrespbill
6.2.2 Códigos de Respuesta de VTOL Server para Billeteras Electrónicas

Â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 7

Nova versão Atual

Chave

VTOL EMVKIT AR 1.6.X

Âncora_Toc508730814_Toc508730814

Âncora_Toc508730815_Toc5087308151. Introducción

Âncora_Toc508730816_Toc5087308161.1 Acerca de este documento

Âncora_Toc508730817_Toc5087308171.2 Qué es EMVKIT?

K. Procesar Mensaje Cuenta DNI

L. Procesar Mensaje Promociones PEI

M. Obtener Configuración de POS

ÂncorasynchronizesynchronizeO. Sincronizar transacciones

Âncora_GoBack_GoBack

P. Cerrar Sesión

Âncoracodrespbillcodrespbill6.2.2 Códigos de Respuesta de VTOL Server para Billeteras Electrónicas

Â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

Âncora
_Toc508730815
_Toc508730815
1. Introducción

Âncora
_Toc508730816
_Toc508730816
1.1 Acerca de este documento

Âncora
_Toc508730817
_Toc508730817
1.2 Qué es EMVKIT?

Âncora
synchronize
synchronize
O. Sincronizar transacciones

Âncora
_GoBack
_GoBack

Âncora
codrespbill
codrespbill
6.2.2 Códigos de Respuesta de VTOL Server para Billeteras Electrónicas

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