Versões comparadas

Versão antiga 4

changes.mady.by.user José Daniel Valor

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Sabrina Zimmermann

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin


Image Removed
Manual de IntegraciónImage Added




VTOL EMVKIT AR 1.4.X

...






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


Expandir
titleExpandir revisiones


1

Fecha

Revisión

Cambios – Motivo

2

06/01/2014

1.0

Creación del documento

3

17/08/2015

1.1

Definición de librería como servicio. Explicación de integración

4

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

5

09/11/2015

1.3

Agregado de campo 1102–Proveedor seleccionado en mensaje Procesar Operación con Tarjeta

6

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

7

16/05/2016

1.5

Revisión del documento

8

06/06/2016

1.6

Agregado del valor FORCED_CLOSE en el campo 1008–closeSessionAction del mensaje Cerrar Sesión

9

14/07/2016

1.7

Agregados los tipos de transacciones ServicePayment y VoidServicePayment

10

18/08/2016

1.8

Agregado del anexo "Mecanismo de Autorización Telefónica"

11

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.

12

19/09/2016

1.10

Se modifica la condición del campo 1113 – cardIsDebit.

13

21/09/2016

1.11

Posibilidad de recibir desde el POS, el valor que indica la capacidad de captura de la terminal.

14

23/09/2016

1.12

Agregado del tipo de operación "Cancelar Lectura de Tarjeta"

15

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

16

05/04/2017

1.14

Agregado de propiedad approveInSecondInstance en sección de Configuración de PINPAD

17

16/05/2017

1.15

Modificación del apartado Mecanismo de Autorización Telefónica

18

17/05/2017

1.16

Agregado del valor MSR Chip en campo inputMode

19

30/05/2017

1.17

Agregado del apartado "Circuito Operativo de la EMVKIT"

20

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

21

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

22

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"

23

27/07/2017

1.21

Modificación del apartado "Pre requisitos"
Incorporación del apartado "Configuración de enlace con VTOL"

24

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"

25

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"

26

14/11/2017

1.24

Incorporación del apartado "Instalación"
Actualización del apartado "Configuración"

27

01/02/2018

1.25

Aclaración sobre requerimiento de software

2823/04/20181.26

Revisión general del documento.

Agregado de apartado Pagos Parciales.

2913/06/20181.27Agregado de procesamiento de tarjetas de empleados
3012/07/20181.28Agregado de campos 6 - cardNumber, 9 - track2, 66 - track1 y 145 - exceptionBinName en la respuesta de la operación "Procesar Operación con Tarjeta"
3106/08/20181.29Incorporación de la funcionalidad PEI en la mensajería
3217/08/20181.30Agregado de campo 1104 - prefixesList en la respuesta de la operación "Leer Datos de la Tarjeta"
3314/01/20191.31Incorporación de las funcionalidades de impresión de vouchers en la mensajería
3415/02/20191.32Incorporación de la funcionalidad Billeteras Electrónicas QR (Mercado Pago y Todo Pago)
3503/04/20191.33Agregado del campo 0 (compañía) en todos los tipos de transacciones.





Painel
borderColor#E4E3E3
titleColor#ffffff
borderWidth1
titleBGColor#704581
titleCONTENIDO


Expandir
titleExpandir contenido

Índice


Âncora
_Toc508730814
_Toc508730814

...


Âncora
_Toc508730815
_Toc508730815
1. Introducción

...

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

...

Número

Nombre del campo

Tipo de dato

createSession

Descripción

0companyNuméricoXIdentificador 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

Tipo de Transacción:

  • createSession: crea una nueva sesión con EMVKIT
25dateTimeNuméricoXFecha y hora de realización de la transacción en formato YYYYMMDDHHMMSS

1025

transactionalControl

Alfanumérico

O

Campo opcional del tipo flag. Este campo activo indica que se debe realizar un control transacción por transacción para decidir qué acción tomar sobre la última transacción procesada en la librería (confirmarla o reversarla).
Valores posibles:
0: Control desactivado
1: Control activado
Por defecto, está desactivado por compatibilidad hacia atrás, pero se recomienda fuertemente su utilización para evitar estados de inconsistencia.

...

Request to Full library: {25:20190401094039;0:1;2:1;1:1;11:createSession}

...

Número

Nombre del campo

Tipo de dato

SaleVoidSaleRefundVoidRefundSaleCashBackServicePaymentVoidServicePayment

Descripción

11

trxType

Alfanumérico

XXXXXXX

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
  • ServicePayment = Pago de servicio
  • VoidServicePayment = Anulación de pago de servicio

22

authorizationCode

Alfanumérico

OOOOOOO

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

24

lastTrxId

Numérico

OOOOOOO

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)

25dateTimeNuméricoXXXXXOOFecha y hora de realización de la transacción, en formato: YYYYMMDDHHMMSS


Nota

...

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



Ejemplo

Request to Full library: {25:20190125102422;11:Sale;22:123456}

...

Número

Nombre del campo

Tipo de dato

cancel

Descripción

11

trxType

Alfanumérico

X

Tipo de Transacción:

  • cancel: cancela la lectura de la tarjeta


Nota

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

...

Número

Nombre del campo

Tipo de dato

SaleVoidSaleRefundVoidRefundSaleCashBackServicePaymentVoidServicePayment

Descripción

11

trxType

Alfanumérico

XXXXXXX

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
  • ServicePayment = Pago de servicio
  • VoidServicePayment = Anulación de pago de servicio

12

amount

Importe

XXXXXXX

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

XXXXXXX

Tipos de Moneda:

  • $ = Pesos
  • U$S = Dólares

14

payments

Numérico

XXXXXXX

Cantidad de cuotas. 2 dígitos como máximo
Si es sin cuotas, el valor por defecto es 1

15

plan

Alfanumérico

XXXXXXX

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

-OX----

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

18

referedSale

Numérico

O------

Se usa para indicar si una venta se hizo de forma referida. SOLO para AMEX. Se debe encender este campo con el valor 1

25

dateTime

Numérico

XXXXXXX

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

53

paymentCondition

Alfanumérico

OOOOOOO

Condición de pago. Sólo se encuentra presente si existe una condición de pago vinculada con la transacción

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

70

effectiveDate

Alfanumérico

OOOOOOO

Fecha efectiva. Se usa para AMEX con formato YYMM

73

interestAmount

Alfanumérico

OOOOOOO

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

74

requestAccountNumber

Alfanumérico

OOOOOOO

Indica si puede recibir el número de cuenta (Visa y Posnet). Default = 0. Valores posible:

  • 1 = activado
  • 0 = desactivado

101

differDate

Alfanumérico

OOOOOOO

Fecha diferida. Solo utilizada para AMEX

118

terminalCapability

Alfanumérico

OOOOOOO

Capacidad de captura. Valores 1 = Manual / 2 = Lectura de Banda / 5 = Lectura de Chip

130

posPeriod

Numérico

OOOOOOO

Indica el Periodo del POS en que se realiza la operación. Solamente es registrado en VTOL. Longitud 5

131

turn

Numérico

OOOOOOO

Indica Turno en que se realiza la operación. Solamente es registrado en VTOL. Longitud 2

132

operatorCode

Alfanumérico

OOOOOOO

Código de operador. Solamente es registrado en VTOL. Longitud 20

133

operatorName

Alfanumérico

OOOOOOO

Nombre de operador. Solamente es registrado en VTOL. Longitud 50

134

sellerCode

Alfanumérico

OOOOOOO

Código del vendedor que realiza la operación. Solamente es registrado en VTOL. Longitud 20

135

sellerName

Alfanumérico

OOOOOOO

Nombre del vendedor que realiza la operación. Solamente es registrado en VTOL. Longitud 50

136

attentionMode

Alfanumérico

OOOOOOO

Modalidad de atención (AU ó AS). Longitud 2

1102

provider

Alfanumérico

OOOOOOO

Proveedor / tarjeta seleccionada manualmente de la lista devuelta por la librería en la operación Leer Datos de la Tarjeta. Por Ejemplo: Si la operación Leer Datos de Tarjeta retorna la lista {VI, EL}, en la operación Procesar Operación con Tarjeta se debe enviar el valor seleccionado entre las dos opciones VI o EL.

1103

cardContextId

Numérico

XXXXXXX

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"


Nota

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

...

Número

Nombre del campo

Tipo de dato

SaleVoidSaleRefundVoidRefundSaleCashBackServicePaymentVoidServicePayment

Descripción

0companyNuméricoXXXXXXXIdentificador de la compañía donde se generó la transacción.

1

store

Alfanumérico

XXXXXXX

Identificador del sitio originador de la transacción

2

node

Numérico

XXXXXXX

Identificación del nodo, en el sitio originador, donde se generó la transacción

6cardNumberNuméricoOOOOOOO

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

9track2AlfanuméricoOOOOOOOTrack2 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados

10

inputMode

Alfanumérico

XXXXXXX

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

OOOOOOO

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

23

authorizationMode

Alfanumérico

XXXXXXX

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

XXXXXXX

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

XXXXXXX

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

XXXXXXX

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

XXXXXXX

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

XXXXXXX

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

29

serialNumber

Numérico

XXXXXXX

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

30

businessNumber

Numérico

XXXXXXX

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

31

lotNumber

Numérico

XXXXXXX

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

32

ticket

Numérico

OOOOOOO

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

33

creditCardIssuerName

Alfanumérico

OOOOOOO

Nombre del Centro emisor de la tarjeta

34

hostName

Alfanumérico

OOOOOOO

Nombre del canal por el cual se autorizó la tarjeta

35

errorDescription

Alfanumérico

OOOOOOO

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

42

lotDefinitionId

Numérico

XXXXXXX

Identificador de la definición de lote

57

accountType

Alfanumérico

OOOOOOO

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

OOOOOOO

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

59offlinePinCheckNuméricoOOOOOOO

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

  • 0 = No
  • 1 = Si
66track1AlfanuméricoOOOOOOOTrack1 de la tarjeta entero. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados

68

rrn

Numérico

OOOOOOO

Reference referral number

75

accountNumber

NuméricoAlfanumérico

OOOOOOO

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

81

responseAuth

Alfanumérico

OOOOOOO

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

OOOOOOO

Versión de la aplicación

130

posPeriod

Numérico

OOOOOOO

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

131

turn

Numérico

OOOOOOO

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

132

operatorCode

Alfanumérico

OOOOOOO

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

133

operatorName

Alfanumérico

OOOOOOO

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

134

sellerCode

Alfanumérico

OOOOOOO

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

135

sellerName

Alfanumérico

OOOOOOO

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

136

attentionMode

Alfanumérico

OOOOOOO

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

145exceptionBinNameAlfanuméricoOOOOOOONombre de la tarjeta de Excepción. Solo presente en Tarjeta de Excepción o Tarjetas de Empleados

166

trxReferenceNumber

Numérico

XXXXXXX

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

XXXXXXX

Identificador de la sesión actual

1027

libResponseCode

Numérico

XXXXXXX

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

XXXXXXX

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

1110

pinpadApplicationId

Alfanumérico

XXXXXXX

Identificador de la Aplicación del PINPAD.

1111

pinpadApplicationName

Alfanumérico

XXXXXXX

Nombre de la Aplicación del PINPAD.

1112

cardHolderName

Alfanumérico

OOOOOOO

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

1120

voucherHeader

Mapa

OOOOOOO

[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

OOOOOOO

[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

OOOOOOO

[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

OOOOOOO

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

1124

printVoucher

Numérico

OOOOOOO

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

{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

SaleVoidSaleRefundVoidRefundSaleCashBackServicePaymentVoidServicePayment

Descripción

6

cardNumber

Numérico

OOOOOOO

Número de tarjeta. Sólo presente si el modo de ingreso fue Manual.

7

expiration

Numérico

OOOOOOO

Formato YYMM Fecha de vencimiento de la tarjeta. Sólo presente si el modo de ingreso fue Manual.

8

Cvc

Numérico

OOOOOOO

Código de seguridad de la tarjeta. Sólo presente si el modo de ingreso fue Manual.

9

track2

Alfanumérico

OOOOOOO

Track2 de la tarjeta entero (se envía todo el contenido del track2 en este campo) Este campo sólo está presente si la banda magnética / chip de la tarjeta pudo ser leído.

10

inputMode

Alfanumérico

XXXXXXX

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

11

trxType

Alfanumérico

XXXXXXX

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
  • ServicePayment = Pago de servicio
  • VoidServicePayment = Anulación de pago de servicio

12

amount

Importe

XXXXXXX

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

XXXXXXX

Tipos de Moneda:

  • $ = Pesos
  • U$S = Dólares

14

payments

Numérico

XXXXXXX

Cantidad de cuotas. 2 dígitos como máximo
Si es sin cuotas, el valor por defecto es 1

15

plan

Alfanumérico

XXXXXXX

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

-OX----

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

18

referedSale

Numérico

OOOOOOO

Se usa para indicar si una venta se hizo de forma referida. SOLO para AMEX. Se debe encender este campo con el valor 1

22

authorizationCode

Alfanumérico

OOOOOOO

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

24

lastTrxId

Numérico

OOOOOOO

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

XXXXXXX

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

53

paymentCondition

Alfanumérico

OOOOOOO

Condición de pago. Sólo se encuentra presente si existe una condición de pago vinculada con la transacción

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

70

effectiveDate

Alfanumérico

OOOOOOO

Fecha efectiva. Se usa para AMEX con formato YYMM

73

interestAmount

Alfanumérico

OOOOOOO

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

74

requestAccountNumber

Alfanumérico

OOOOOOO

Indica si puede recibir el número de cuenta (Visa y Posnet). Default = 0. Valores posible:

  • 1 = activado
  • 0 = desactivado

101

differDate

Alfanumérico

OOOOOOO

Fecha diferida. Solo utilizada para AMEX

130

posPeriod

Numérico

OOOOOOO

Indica el Periodo del POS en que se realiza la operación. Solamente es registrado en VTOL. Longitud 5

131

turn

Numérico

OOOOOOO

Indica Turno en que se realiza la operación. Solamente es registrado en VTOL. Longitud 2

132

operatorCode

Alfanumérico

OOOOOOO

Código de operador. Solamente es registrado en VTOL. Longitud 20

133

operatorName

Alfanumérico

OOOOOOO

Nombre de operador. Solamente es registrado en VTOL. Longitud 50

134

sellerCode

Alfanumérico

OOOOOOO

Código del vendedor que realiza la operación. Solamente es registrado en VTOL. Longitud 20

135

sellerName

Alfanumérico

OOOOOOO

Nombre del vendedor que realiza la operación. Solamente es registrado en VTOL. Longitud 50

136

attentionMode

Alfanumérico

OOOOOOO

Modalidad de atención (AU ó AS). Longitud 2

1103

cardContextId

Numérico

XXXXXXX

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"


Nota

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

...

Número

Nombre del campo

Tipo de dato

SaleVoidSaleRefundVoidRefundSaleCashBackServicePaymentVoidServicePayment

Descripción

0companyNuméricoXXXXXXXIdentificador de la compañía donde se generó la transacción.

1

store

Alfanumérico

XXXXXXX

Identificador del sitio originador de la transacción

2

node

Numérico

XXXXXXX

Identificación del nodo, en el sitio originador, donde se generó la transacción

22

authorizationCode

Alfanumérico

OOOOOOO

Código de autorización generado por el centro autorizador para la transacción.

23

authorizationMode

Alfanumérico

XXXXXXX

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

XXXXXXX

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

XXXXXXX

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

XXXXXXX

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

XXXXXXX

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

XXXXXXX

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

29

serialNumber

Numérico

XXXXXXX

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

30

businessNumber

Numérico

XXXXXXX

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

31

lotNumber

Numérico

XXXXXXX

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

32

ticket

Numérico

OOOOOOO

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

33

creditCardIssuerName

Alfanumérico

XXXXXXX

Nombre del Centro emisor de la tarjeta

34

hostName

Alfanumérico

OOOOOOO

Nombre del canal por el cual se autorizó la tarjeta

35

errorDescription

Alfanumérico

OOOOOOO

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

42

lotDefinitionId

Numérico

XXXXXXX

Identificador de la definición de lote

58

workingKey

Alfanumérico

OOOOOOO

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

XXXXXXX

Reference referral number

75

accountNumber

NuméricoAlfanumérico

OOOOOOO

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

81

responseAuth

Alfanumérico

OOOOOOO

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

XXXXXXX

Versión de la aplicación

130

posPeriod

Numérico

OOOOOOO

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

131

turn

Numérico

OOOOOOO

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

132

operatorCode

Alfanumérico

OOOOOOO

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

133

operatorName

Alfanumérico

OOOOOOO

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

134

sellerCode

Alfanumérico

OOOOOOO

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

135

sellerName

Alfanumérico

OOOOOOO

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

136

attentionMode

Alfanumérico

OOOOOOO

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

166

trxReferenceNumber

Numérico

XXXXXXX

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

XXXXXXX

Identificador de la sesión actual

1027

libResponseCode

Numérico

XXXXXXX

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

XXXXXXX

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

1110

pinpadApplicationId

Alfanumérico

XXXXXXX

Identificador de la Aplicación del PINPAD.

1111

pinpadApplicationName

Alfanumérico

XXXXXXX

Nombre de la Aplicación del PINPAD.

1112

CardHolderName

Alfanumérico

OOOOOOO

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

1120

voucherHeader

Mapa

OOOOOOO

[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

OOOOOOO

[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

OOOOOOO

[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

OOOOOOO

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

1124

printVoucher

Numérico

OOOOOOO

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

...

Número

Nombre del campo

Tipo de dato

SalePEI

RefundPEIQueryPEI

Descripción

8

Cvc

Numérico

X

X-

Código de seguridad de la tarjeta

9

track2

Alfanumérico

X

XX

Track2 de la tarjeta entero (se envía todo el contenido del track2 en este campo)

10

inputMode

Alfanumérico

X

XX

Forma en que se ingresó/leyó la tarjeta. Valor posible:

  • MSR – Leída por banda magnética

11

trxType

Alfanumérico

X

XX

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

XX

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

66track1AlfanuméricoXXXTrack1 de la tarjeta entero (se envía todo el contenido del track1 en este campo)
153idOperationPEIAlfanumérico-X-Identificador de la operación PEI de pago que se desea devolver
155cbuAlfanumé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
156cbuAliasAlfanumé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
157customerDocAlfanumé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

161operationConceptNuméricoO--

Concepto por el cual se realiza la operación, valores posibles:

  • 1 = COMPRA_DE_BIENES
  • 2 = PAGO_DE_SERVICIOS
  • 3 = EXTRACCION
173dateTimeOriginalTrxNumérico--XFecha 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


Nota

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

...

Número

Nombre del campo

Tipo de dato

SalePEIRefundPEIQueryPEI

Descripción

0companyNuméricoXXXIdentificador de la compañía donde se generó la transacción.
1storeAlfanuméricoXXXIdentificador del sitio originador de la transacción
2nodeNuméricoXXXIdentificación del nodo, en el sitio originador, donde se generó la transacción

25

dateTime

Numérico

XXX

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

XXX

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

XXX

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

XXX

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

35

errorDescription

Alfanumérico

XXX

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

153

idOperationPEI

Alfanumérico

XXX

Identificador de la operación PEI de pago o de devolución

154idOperationOrigenPEIAlfanumérico-XOIdentificador de la operación PEI de origen con la cual se solicitó la devolución
170idCommercePEIAlfanuméricoXXXIdentificador PEI de compañía
171idBranchPEIAlfanuméricoXXXIdentificador PEI de local
172idTerminalPEIAlfanuméricoXXXIdentificador PEI de terminal
174originalTrxStatusNumé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
278bankingRefNumAlfanuméricoX-XNumero 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

XXX

Identificador de la sesión actual

1027

libResponseCode

Numérico

XXX

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

XXX

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

...

  • requestSignature = 1: Solicita firma digital y genera comprobante digital.
  • requestSignature distinto de 1: No genera comprobante digital.


Nota: Actualmente esta
Nota
titleImportante

Esta funcionalidad se

encuentra disponible

encuentra disponible para los pinpad de

Posnet

First Data, a partir del firmware A0808.

En el archivo devices.properties de EMVKIT se debe habilitar el siguiente driver: pinPad_driver=com.synthesis.vtol.ar.client.devices.posnet.PinpadVx820A0808PosnetDriver


Mensajería


  • Requerimiento

Informações
titleReferencias

X = Obligatorio
O = Opcional
- = No requerido


Número

Nombre del campo

Tipo de dato

PrintTrxVoucher

Descripción

11

trxType

Alfanumérico

X

Tipo de Transacción:

  • PrintTrxVoucher: imprime el comprobante
25dateTimeNuméricoXFecha 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
1103cardContextIdNuméricoXIdentifica 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"
1118voucherParametersMapaX

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).
1130requestSignatureNumé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.

Nota: En caso de no solicitar firma digital, no se genera el archivo .POS (del comprobante) por lo que no se tendrá constancia del mismo en VTOL Server.

1131voucherHeaderMapaO

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

1132clientDNIAlfanuméricoODNI del cliente. Valor hasta 9 caracteres
1133billNumberNuméricoONúmero de la factura. Valor hasta 11 caracteres
1134voucherPromoMessageMapaOSe 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
1135voucherPromoLine AlfanuméricoOSe informa la promoción obtenida. Valor hasta 40 caracteres
1136billType AlfanuméricoOTipo de factura. Valor hasta 1 caracter


Nota

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


Ejemplo


Request to Full library: {1103:20190115143308991;1118:[copyCount

\

|1];11:PrintTrxVoucher;1136:B;1135:Vale Otro!;1134:[promotional1|**************************,promotional2|   Gracias por utilizar,promotional3|     nuestros Servicios,promotional4|    Esperamos su regreso,promotional5|     El presente voucher,promotional6|     no contiene premios,promotional7|**************************];1133:1235456;1132:123456789;1131:[header1|    ******************************,header2|    **            NAPSE         **,header3|    ******************************,header4|Conectate con la evolucion del Retail,header5|-------------------------------------];1130:1;2:1;25:20190115143332;1:1}


  • Respuesta


Informações
titleReferencias

X = Obligatorio

O = Opcional

- = No requerido


Número

Nombre del campo

Tipo de dato

PrintTrxVoucher

Descripción

1010currentSessionIdNuméricoXIdentificador de la sesión

1027

libResponseCode

Numérico

X

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

1028

libResponseMessage

Alfanumérico

X

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

1103cardContextIdNuméricoXIdentifica 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"


Ejemplo


Response from Full library: {1010:1547573567858;1027:000;1028:Ok;1103:20190115143308991}


H. Impresión Libre

Este comando tiene como funcionalidad la libre impresión y formateo de comprobantes por parte del punto de venta.

...

Informações
titleReferencias

X = Obligatorio

O = Opcional

- = No requerido


Número

Nombre del campo

Tipo de dato

Print

Descripción

1storeAlfanuméricoXIdentificador del sitio originador de la transacción.2nodeNuméricoXIdentificador del nodo, en el sitio originador, donde se generó la transacción.

Print

Descripción

11

trxType

Alfanumérico

X

Tipo de Transacción:

  • Print: imprime el comprobante informado por el POS
25dateTimeNuméricoXFecha 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
1137

printContent

Base 64X

Texto en plano codificado en base 64 con el siguiente formato:

XXNN     *****************************  

Donde XX indican el formato de la línea, valores posibles:

  • 01: Impresión normal
  • 02: Impresión negrita (no disponible en Verifone)
  • 03: Impresión doble alto
  • 04: Impresión doble ancho
  • 05: Impresión doble alto, doble ancho
  • 10: Solicitud de firma en pantalla
  • 20: Salto de línea

El texto por linea es de hasta 40 caracteres cuando no es doble ancho, seguido de un salto de línea. Lineas permitidas: 30


Nota

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


Ejemplo


Request to Full library: {1137:MDJOTiAgICAgKioqKioqKioqKioqKioqKioqKioqKioqKioqKiogICAgIA0KMDJOTiAgICAgICAg ICAgIEFWSVNPIERFIFBSRU1JTyAgICAgICAgICAgIA0KMDJOTiAgICAgKioqKioqKioqKioqKioq KioqKioqKioqKioqKiogICAgIA0KMjBOTg0KMDFOTlNZTlRIRVNJUyBMQUJPUkFUT1JJTyAxICAt ICA1OTcwNDAwMDQ0NzENCjAxTk4gICAgICAgICAgICAgICAgMjMvMTAvMTcgICAgICAgICAgICAg ICANCjIwTk4NCjIwTk4NCjAxTk4gICAgICAgICAgICAgICBQUk9NT0NJT04gICAgICAgICAgICAg ICAgICAgICAgDQowMU5OICAgICAgICAgICAgIFBFTDFQVE9ERVZFTlRBICAgICAgICAgICAgDQoy ME5ODQowMU5OICAgRkVMSUNJVEFDSU9ORVMsIFVTVEVEIFNFIEhBIEdBTkFETyAgDQowMU5OICAg WFlYIEgySCBQRUwgMSAtIFBSRU1JTyBDT01JRU5aQSBZICAgDQowMU5OICAgICAgVEVSTUlOQSBD T04gLSBQRUwgMSBIMkggWFlYICAgICAgDQoyME5ODQowM05OICAgICAgICAgICBDT0RJR08gREVM IFBSRU1JTyAgICAgICAgICAgDQowMU5OICAgICAgICAgIDc5MTQyNyBCIC0gMDAwMzU2MjIgICAg ICAgICAgDQoyME5OICAgDQoyME5OICAgDQowMU5OICBQQVJBIENBTkpFQVIgU1UgUFJFTUlPIFBS RVNFTlRFIEVTVEUgDQowMU5OVkFMRSBBIENVQUxRVUlFUiBWRU5ERURPUiBERSBFU1RFIExPQ0FM DQoyME5ODQoyME5ODQowMU5OUkVDSUJJIENPTkZPUk1FOg0KMTBOTg0KMjBOTg0KMjBOTg0KMjBO Tg==;25:20190115143513;2:1;1:1;11:Print}


  • Respuesta


Informações
titleReferencias

X = Obligatorio

O = Opcional

- = No requerido


Número

Nombre del campo

Tipo de dato

Print

Descripción

1010

currentSessionId

NuméricoXIdentificador de la sesión

1027

libResponseCode

Numérico

X

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

1028

libResponseMessage

Alfanumérico

X

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

1103cardContextIdNuméricoXIdentifica 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"


Ejemplo


Response from Full library: {1010:1547573567858;1027:000;1028:Ok}


I. Procesar Mensajes Billeteras Electrónicas

...

Informações

Referencias

X = Obligatorio

O = Opcional

- = No requerido


Número

Nombre del campo

Tipo de dato

SaleWallet

RefundWallet
QuerySaleWallet

Descripción

11

trxType

Alfanumérico

X

XX

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

16originalDateNumérico-XX

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

24lastTrxIdNuméricoOOOUtilizado cuando está activo el control transaccional. En este campo el POS debe enviar la última transacción procesada correctamente.

25

dateTime

Numérico

X

XX

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

268walletPosTrxIdAlfanuméricoX-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

269walletTypeNuméricoXXX

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

1: Mercado Pago
2: Todo Pago

270posTicketBase 64X--

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

271walletPaymentIdAlfanumérico

-

XO

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


Nota

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


Ejemplo


Request to VTOL (SaleWallet):

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

Request to VTOL (RefundWallet):

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

Request to VTOL (QuerySaleWallet):

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


Estructura del campo posTicket

...

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


Propiedad

Tipo de dato

Descripción

Requerido

seq

Entero positivo

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

Sí


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

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


Elemento

Atributo

Tipo de dato

Descripción

Requerido

Valor ante ausencia

Ítem

 

 

 

 

 

 

 

 

 

 

 





















unitprice

Numérico positivo

Precio unitario del artículo en cuestión.

Si

 


xprice

Numérico positivo

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

Si

 


qty

Entero positivo

Cantidad de artículos en la línea.

Si

 


magnitude

Numérico positivo

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

No

0

code

Alfanumérico

Código propio del artículo.

No

"-"

brand

Alfanumérico

Marca del artículo.

No

"-"

supplier

Alfanumérico

Proveedor al que pertenece el artículo.

No

"-"

discountable

Alfanumérico

Si el artículo es puede recibir descuentos o no.

No

"-"

level1

Alfanumérico

Nivel 1 de categorización del artículo. Anteriormente este nivel se conocía con el nombre de Departamento.

No

"-"

level2

Alfanumérico

Nivel 2 de categorización del artículo. Anteriormente este nivel se conocía como la Familia del artículo.

No

"-"

level3

Alfanumérico

Nivel 3 de categorización del artículo. Anteriormente este nivel se conocía como la Categoría del artículo.

No

"-"

level4

Alfanumérico

Nivel 4 de categorización del artículo. Anteriormente este nivel se conocía como la subcategoría del artículo.

No

"-"

descriptionAlfanuméricoDescripción del ítemSi
currencyAlfanumé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



Ejemplo


<message>
<item-add seq="1" code="0001" discountable="true" unitprice="25.0" qty="1.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" xprice="25.0" magnitude="1.0" description="Jean casual" currency="$" />
<item-add seq="2" code="0002" discountable="true" unitprice="28.0" qty="2.0" level1="MEN" level2="CASUAL" supplier="" brand="LEVIS" xprice="48.0" magnitude="1.0" description="Jean casual" currency="$" />
</message>


Aviso
Importante: Esta estructura generada debe transformarse al formato Base 64 para informárselo a VTOL en el campo 270 posTicket.

...

Informações

Referencias

X = Obligatorio

O = Opcional

- = No requerido


Número

Nombre del campo

Tipo de dato

SaleWalletRefundWalletQuerySaleWallet

Descripción

0companyNuméricoXXXIdentificador de la compañía donde se generó la transacción
1storeAlfanuméricoXXXIdentificador del sitio originador de la transacción
2nodeNuméricoXXXIdentificación del nodo, en el sitio originador, donde se generó la transacción
6cardNumberAlfanumérico--OTarjeta enmascarada 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
12amountImporte--XMonto de la transacción
13currencyPosCodeAlfanumérico--X

Tipos de moneda:

  • $ = Pesos
  • U$S = Dólares
14paymentsNumérico--OCantidad 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
22authorizationCodeAlfanuméricoX-X

Código de autorización informado por el Autorizador

24trxIdNuméricoXXXIdentificador de la transacción

25

dateTime

Numérico

XXX

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

XXX

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

XXX

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

28

responseMessage

Alfanumérico

XXX

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

140paymentTypeNumérico--X

Tipo de pago. Valores posibles:

0: Tarjeta
1: Efectivo

142providerNameAlfanumérico--OProveedor 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
166trxReferenceNumberNuméricoXX-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-XIdentificador del número de pago informado por el Autorizador
272amountRefundedImporte--XMonto devuelto en la transacción
273paymentStatusAlfanumé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

274paymentStatusDetailAlfanumérico--XDetalle del estado de la transacción de pago informado por el Autorizador
275cardTypeNumé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

1010currentSessionIdNuméricoXXXIdentificador de la sesión
1027libResponseCodeNuméricoXXX

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

1028libResponseMessageAlfanuméricoXXXMensaje descriptivo del código de respuesta de la librería


Ejemplo


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}


J. Obtener Configuración de POS

...

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


Nota

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

...

Número

Nombre del campo

Tipo de dato

closeSession

Descripción

11

trxType

Alfanumérico

X

Tipo de Transacción:

  • closeSession: cierre de sesión con la librería

1008

closeSessionAction

Alfanumérico

X

Acción que se debe realizar sobre el cierre de sesión:

  • CLOSE = Confirmar autorizaciones realizadas en la sesión
  • CANCEL = Reversar las autorizaciones realizadas en la sesión
  • FORCED_CLOSE = Confirmar autorizaciones realizadas en la sesión que fue cerrada forzosamente

1009

closeTrxIdList

Lista

O

Lista de los trxId (campo 24) recibidos en la respuestas a las distintas llamadas "Procesar Operación con la Tarjeta"

Obligatorio cuando el campo 1008 es igual a CLOSE

250

actionCode

Alfanumérico

O

Identificación del motivo por el cual la sesión tuvo un cierre forzado. Código de 5 caracteres.
Valores posibles:

  • 00001 – Corte de energía en el local
  • 00002 – El tarjeta habiente se marchó
  • 00003 – El vendedor decidió cerrarla
  • 00004 – Error en la impresión
  • 00005 – Error en el punto de venta
  • 99999 – Motivo desconocido

Obligatorio cuando el campo 1008 es igual a FORCED_CLOSE

251

actionNote

Alfanumérico

O

Motivo informado por el punto de venta cuando la sesión tuvo un cierre no tradicional. Máximo de 50 caracteres

Se debe enviar cuando el campo 1008 es igual a FORCED_CLOSE


Nota

...

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


Ejemplo


Request to Full library: {1009:{270};1008:CLOSE;11:closeSession}

...

  • El campo closeSessionAction puede tomar uno de los siguientes valores:
    • CLOSE: la sesión terminó correctamente, es decir, la aplicación de punto de venta finalizó la transacción de punto de venta correctamente.
    • CANCEL: la sesión no terminó correctamente, es decir, la aplicación de punto de venta NO finalizó correctamente la transacción de punto de venta debido a algún tipo de contingencia.
    • FORCED_CLOSE: la sesión no terminó correctamente, es decir, la aplicación de punto de venta NO finalizó correctamente la transacción de punto de venta y se forzó el cierre de la sesión. Por ejemplo, corte de luz, el cliente se marcha, errores en el punto de venta, etc.
  • El campo closeTrxIdList es la lista de los trxIds que la aplicación de punto de venta recibió y almacenó. Solamente debe enviar esta lista cuando el valor del campo closeSessionAction es igual a CLOSE

...

En este caso, si el valor de isoCode es igual a 00, 11 o 85 indica que la autorización ha sido Aprobada por VTOL Server y que debe capturarse el valor del campo 24 (lastTrxId) para ser enviado en el cierre de sesión:

...

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

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


Â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ódigoDescripción
000
00APROBADA
500No se encuentra la transaccion original
501El campo WalletPosTrxId es requerido
502El campo WalletType es requerido
503No esta configurado una Compañia MP
504No esta configurado una Caja MP
505El tipo de billetera es invalido
506El campo WalletPaymentId es requerido
507El campo OriginalDate es requerido
508No es posible devolver una devolucion
509Estado trx original no acepta devolucion
510Importe devolucion supero monto limite
511No se pudo realizar la orden de pago
512La transaccion no posee estado
513El campo posTicket es requerido
514Consulte el pago por tiempo expirado
515Tiempo expirado confirmacion devolucion
516No se encuentra el pago original
517Estado trx original no acepta devolucion
518No se encuentra la devolucion
519Acceso a MP no esta autorizado
520Accion a MP no esta autorizada
521El campo WalletPosTrxId es invalido
523Estado trx original no acepta devolucion
524Importe invalido para devolucion
525Estado trx original no acepta devolucion
526Compañia MP no permite operar
527Numero devoluciones parciales superados
528El pago es antiguo para ser devuelto
529No es posible devolver una devolucion
530Compañia MP sin dinero para devolver
531Compañia MP sin dinero disponible
532Estado trx original no acepta devolucion
533Devolucion parcial no soportada
534Url de notificacion invalido
535El monto de la transaccion es invalido
536Error general por parte de MP
537No se encuentra la transaccion original
538El campo WalletPosTrxId es requerido
539Devuelto
540Pendiente
541Autorizado
542En Progreso
543En mediacion
544Rechazado
545Cancelado
546Contracargo
547No se encontró la trx original
548Error en comunicación
549No existe comunicación con Mercado Pago
550Error al consultar venta original online 


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

...

A continuación se detalla la información que viaja en el campo confData de un mensaje de solicitud de configuración, que se corresponde con la interface de configuración generada para el POS en VTOL Server.
La versión de Formato de interface utilizada por Crédito Debito Argentina es la v106v107.


Header

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

...

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.

...

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

...