Histórico da Página

...

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:

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

hostName

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

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.

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}

...

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	SalePEI	RefundPEI	QueryPEI	Descripción
3	server	Alfanumérico	X	X	X	Identificador del Server que procesará la transacción. Enviar "VTOL"
10	inputMode	Alfanumérico	X	X	X	Forma de ingreso: barCodeBarCode softTokenSoftToken
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.

...

Número	Nombre del campo	Tipo de dato	PromoPei	Descripción
3	server	Alfnumérico	X	Identificador del Server que procesará la transacción. Enviar "VTOL"
11	trxType	Alfanumérico	X	Tipo de Transacción: PromoPei
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
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.
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.

...

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

...

Árvore de páginas

Versões comparadas

Versão antiga 10

Nova versão 11

Chave