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

Âncora
_Toc508730814
_Toc508730814
Índice

...

Número

Nombre del campo

Tipo de dato

Sale

VoidSale

Refund

VoidRefund

SaleCashBack

ServicePayment

VoidServicePayment

SalePEI

RefundPEI

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

6

cardNumber

Numérico

O

-

Número de tarjeta en texto plano. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados

9

track2

Alfanumérico

O

-

Track2 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados

10

inputMode

Alfanumérico

X

Forma en que se ingresó/leyó la tarjeta. Valores posibles:

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

-

Código de autorización generado por el centro autorizador para la transacción cuando al transacción fue aprobada

23

authorizationMode

Alfanumérico

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

-

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

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

28

responseMessage

Alfanumérico

X

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

29

serialNumber

Numérico

X

-

Número que identifica de la terminal lógica en la que se procesó la transacción

30

businessNumber

Numérico

X

-

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

31

lotNumber

Numérico

X

-

Número de lote en el que se registró la transacción

32

ticket

Numérico

O

-

Número de Ticket correspondiente a la transacción. 4 dígitos como máximo

33

creditCardIssuerName

Alfanumérico

O

-

Nombre del Centro emisor de la tarjeta

34

Name

Alfanumérico

O

-

Nombre del canal por el cual se autorizó la tarjeta

35

errorDescription

Alfanumérico

O

Descripción de error. Sólo se encuentra presente si el valor del campo 26 es “Error”

42

lotDefinitionId

Numérico

X

-

Identificador de la definición de lote

57

accountType

Alfanumérico

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

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

59

offlinePinCheck

Numérico

O

Informa si se verifica o no el Pin Offline con AMEX EMV. Valores posibles:

0 = No
1 = Si

66

track1

Alfanumérico

O

-

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

68

rrn

Numérico

O

-

Reference referral number

75

accountNumber

Alfanumérico

O

-

Número de cuenta. Este campo es devuelto si el campo 74- requestAccountNumber fue activado en el requerimiento. Longitud 28.

81

responseAuth

Alfanumérico

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

-

Versión de la aplicación

130

posPeriod

Numérico

O

-

[Opcional si viaja en la solicitud] Periodo enviado por el POS. Longitud 5

131

turn

Numérico

O

-

[Opcional si viaja en la solicitud] Turno. Longitud 2

132

operatorCode

Alfanumérico

O

-

[Opcional si viaja en la solicitud] Código de operador. Longitud 20

133

operatorName

Alfanumérico

O

-

[Opcional si viaja en la solicitud] Nombre de operador. Longitud 50

134

sellerCode

Alfanumérico

O

-

[Opcional si viaja en la solicitud] Código del vendedor. Longitud 20

135

sellerName

Alfanumérico

O

-

[Opcional si viaja en la solicitud] Nombre del vendedor. Longitud 50

136

attentionMode

Alfanumérico

O

-

[Opcional si viaja en la solicitud] Modalidad de atención (AU ó AS). Longitud 2

145

exceptionBinName

Alfanumérico

O

-

Nombre de la tarjeta de Excepción. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados

166

trxReferenceNumber

Numérico

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

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

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.

1110

pinpadApplicationId

Alfanumérico

X

-

Identificador de la Aplicación del PINPAD.

1111

pinpadApplicationName

Alfanumérico

X

-

Nombre de la Aplicación del PINPAD.

1112

cardHolderName

Alfanumérico

O

X

Nombre del titular de la tarjeta si el track I está presente y la lectura fue por banda.

1120

voucherHeader

Mapa

O

-

[Opcional 1] Reservado para uso futuro. Retorna los datos del encabezado del voucher. El valor recibido corresponde a un campo compuesto mapa con una serie de claves y valor:

[clave1|valor1, clave2|valor2,…, claveN|valorN]

1121

voucherFooter

Mapa

O

-

[Opcional 1] Reservado para uso futuro. Retorna los datos del pie del voucher. El valor recibido corresponde a un campo compuesto mapa con una serie de claves y valor:

[clave1|valor1, clave2|valor2,…, claveN|valorN]

1122

voucherBody

Mapa

O

-

[Opcional 1] Reservado para uso futuro. Retorna el cuerpo del voucher. El valor recibido corresponde a un campo compuesto mapa con una serie de claves y valor:

[clave1|valor1, clave2|valor2,…, claveN|valorN]

1123

formattedVoucher

Alfanumérico

O

-

[Opcional 2] Reservado para uso futuro. Retorna el voucher completo y formateado para ser impreso.

1124

printVoucher

Numérico

O

-

[Opcional 3] Reservado para uso futuro. Indica si la impresión del voucher tuvo éxito o no. Valores permitidos:

1 = true
0 = false

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

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. Sólo para RefundPEI

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.

280

clientCopyVoucher

Alfanumérico

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

-

Campo para solicitar firma al cliente. Valores posibles:

False: no requerido
True: requerido

1138

emvData

Alfanumérico

O

-

Este campo sólo será retornado en operaciones CHIP con tarjetas Amex. Corresponden a datos del criptograma, los cuales deben ser impresos en el ticket.

Wiki Markup

\\ *Campos opcionales:* \\ \[Opcional 1\]: Cuando la autorización fue aprobada y la librería retorna los datos del Voucher separados en encabezado, Cuerpo y pie. No implementado, reservado para uso futuro. \\ \[Opcional 2\]: Cuando la autorización fue aprobada y la librería retorna en un solo campo el Voucher formateado. No implementado, reservado para uso futuro. \\ \[Opcional 3\]: Cuando la autorización fue aprobada y la librería se encarga de imprimir el Voucher. No implementado, reservado para uso futuro. \\ *Ejemplo* \\

Response from Full library:

{10:MSR;42:101001;1028:Ok;1027:000;82:STS;34:Visa;81:,---esta es una prueba de impresion---|-------esta es la segunda linea-----|-------esta es la tercera linea------|-------esta es la cuarta linea------|-------esta es la quinta linea-------^;33:Visa;32:231;31:14;1112:GOMEZ/JUAN HORACIO ;30:123456788;1111:VISA CLASSIC;29:00000001;1110:A0000000031010;28:APROBADA;27:00;26:ISO8583;25:20150828003911;24:270;23:onLine;1010:28082015003859;22:123456;68:123456789012;110:false;2:1;1:1}

...

Número	Nombre del campo	Tipo de dato	Sale	VoidSale	Refund	VoidRefund	SaleCashBack	ServicePayment	VoidServicePayment	Descripción
0	company	Numérico	X	X	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	X	X	Identificador del sitio originador de la transacción
2	node	Numérico	X	X	X	X	X	X	X	Identificación del nodo, en el sitio originador, donde se generó la transacción
22	authorizationCode	Alfanumérico	O	O	O	O	O	O	O	Código de autorización generado por el centro autorizador para la transacción.
23	authorizationMode	Alfanumérico	X	X	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	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	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	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	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	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	X	X	Número que identifica de la terminal lógica en la que se procesó la transacción
30	businessNumber	Numérico	X	X	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	X	X	Número de lote en el que se registró la transacción
32	ticket	Numérico	O	O	O	O	O	O	O	Número de Ticket correspondiente a la transacción. 4 dígitos como máximo
33	creditCardIssuerName	Alfanumérico	X	X	X	X	X	X	X	Nombre del Centro emisor de la tarjeta
34	hostName	Alfanumérico	O	O	O	O	O	O	O	Nombre del canal por el cual se autorizó la tarjeta
35	errorDescription	Alfanumérico	O	O	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	X	X	Identificador de la definición de lote
58	workingKey	Alfanumérico	O	O	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	X	X	X	X	X	X	X	Reference referral number
75	accountNumber	Alfanumérico	O	O	O	O	O	O	O	Número de cuenta. Este campo es devuelto si el campo 74- requestAccountNumber fue activado en el requerimiento. Longitud 28.
81	responseAuth	Alfanumérico	O	O	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	X	X	X	X	X	X	X	Versión de la aplicación
130	posPeriod	Numérico	O	O	O	O	O	O	O	[Opcional si viaje en la solicitud] Periodo enviado por el POS. Longitud 5
131	turn	Numérico	O	O	O	O	O	O	O	[Opcional si viaje en la solicitud] Turno. Longitud 2
132	operatorCode	Alfanumérico	O	O	O	O	O	O	O	[Opcional si viaje en la solicitud] Código de operador. Longitud 20
133	operatorName	Alfanumérico	O	O	O	O	O	O	O	[Opcional si viaje en la solicitud] Nombre de operador. Longitud 50
134	sellerCode	Alfanumérico	O	O	O	O	O	O	O	[Opcional si viaje en la solicitud] Código del vendedor. Longitud 20
135	sellerName	Alfanumérico	O	O	O	O	O	O	O	[Opcional si viaje en la solicitud] Nombre del vendedor. Longitud 50
136	attentionMode	Alfanumérico	O	O	O	O	O	O	O	[Opcional si viaje en la solicitud] Modalidad de atención (AU ó AS). Longitud 2
166	trxReferenceNumber	Numérico	X	X	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	X	X	Identificador de la sesión actual
1027	libResponseCode	Numérico	X	X	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	X	X	Mensaje descriptivo del código de respuesta de la librería
1110	pinpadApplicationId	Alfanumérico	X	X	X	X	X	X	X	Identificador de la Aplicación del PINPAD.
1111	pinpadApplicationName	Alfanumérico	X	X	X	X	X	X	X	Nombre de la Aplicación del PINPAD.
1112	CardHolderName	Alfanumérico	O	O	O	O	O	O	O	Nombre del titular de la tarjeta si el track I está presente y la lectura fue por banda.
1120	voucherHeader	Mapa	O	O	O	O	O	O	O	[Opcional 1] Reservado para uso futuro. Retorna los datos del encabezado del voucher. El valor recibido corresponde a un campo compuesto mapa con una serie de claves y valor: [clave1\|valor1, clave2\|valor2,…, claveN\|valorN]
1121	voucherFooter	Mapa	O	O	O	O	O	O	O	[Opcional 1] Reservado para uso futuro. Retorna los datos del pie del voucher. El valor recibido corresponde a un campo compuesto mapa con una serie de claves y valor: [clave1\|valor1, clave2\|valor2,…, claveN\|valorN]
1122	voucherBody	Mapa	O	O	O	O	O	O	O	[Opcional 1] Reservado para uso futuro. Retorna el cuerpo del voucher. El valor recibido corresponde a un campo compuesto mapa con una serie de claves y valor: [clave1\|valor1, clave2\|valor2,…, claveN\|valorN]
1123	formattedVoucher	Alfanumérico	O	O	O	O	O	O	O	[Opcional 2] Reservado para uso futuro. Retorna el voucher completo y formateado para ser impreso.
1124	printVoucher	Numérico	O	O	O	O	O	O	O	[Opcional 3] Reservado para uso futuro. Indica si la impresión del voucher tuvo éxito o no. Valores permitidos: 1 = true 0 = false

Wiki Markup

\\ *Campos opcionales:* \\ \[Opcional 1\]: Cuando la autorización fue aprobada y la librería retorna los datos del Voucher separados en encabezado, Cuerpo y pie. No implementado, reservado para uso futuro. \\ \[Opcional 2\]: Cuando la autorización fue aprobada y la librería retorna en un solo campo el Voucher formateado. No implementado, reservado para uso futuro. \\ \[Opcional 3\]: Cuando la autorización fue aprobada y la librería se encarga de imprimir el Voucher. No implementado, reservado para uso futuro. \\ *Ejemplo* \\

Response from Full library:

{42:101001;1028:Ok;1027:000;82:STS;34:Visa;81:,---esta es una prueba de impresion---|-------esta es la segunda linea-----|-------esta es la tercera linea------|-------esta es la cuarta linea------|-------esta es la quinta linea-------^;33:Visa;32:231;31:14;1112:GOMEZ/JUAN HORACIO ;30:123456788;1111:VISA CLASSIC;29:00000001;1110:A0000000031010;28:APROBADA;27:00;26:ISO8583;25:20150828003911;24:270;23:onLine;1010:28082015003859;22:123456;68:123456789012;110:false;2:1;1:1}

...

Alfanumérico

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	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". Debe contener 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 2: 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

...

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. 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	AlfanuméricoImporte	O	O	O	Contiene el Importe del "Cash BackCashout". 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

...

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

...

Árvore de páginas

Versões comparadas

Versão antiga 13

Nova versão 14

Chave

Âncora
_Toc508730814
_Toc508730814
Índice

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 13

Nova versão 14

Chave

Âncora_Toc508730814_Toc508730814Índice

Âncora
_Toc508730814
_Toc508730814
Índice