Header

Mensaje

Longitud del mensaje (4 bytes)

Indica si el mensaje requiere respuesta o no (2 bytes)

Ejemplo: {25:20020426172836;1:5;2:1;27:00;26:ISO8583;28:Aprobado}

Longitud del mensaje

Requiere respuesta

A101

01

#

FieldId

Tipo

Descripción

1

store

Alfanumérico

Identificador del sitio originador de la transacción

2

node

Numérico

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

22

authorizationCode

Numérico

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

23

authorizationMode

Alfanumérico

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

Id de transacción. En caso que el Campo 26 sea TrxIsPending, contendrá el trxId de la transacción pendiente.

25

dateTime

Numérico

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

26

responseCode

Alfanumérico

Puede contener uno de los siguientes valores:

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

27

isoCode

Numérico

Código de Respuesta ISO-8583 emitido por el centro autorizador. 2 dígitos como máximo

28

responseMessage

Alfanumérico

Mensaje de la Respuesta ISO-8583

29

serialNumber

Numérico

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

30

businessNumber

Numérico

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

31

lotNumber

Numérico

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

32

ticket

Numérico

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

33

creditCardIssuerName

Alfanumérico

Nombre del Centro emisor de la tarjeta

34

hostName

Alfanumérico

Nombre del canal por el cual se autorizó la tarjeta.

35

errorDescription

Alfanumérico

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

42

lotDefinitionId

Numérico

Identificador de la definición de lote.

68

rrn

Numérico

Reference referral number.

82

SoftwareVersion

Alfanumérico

Versión software. Constante STS

102

chipTokens

Alfanumérico

En este campo se concatenan los tokens cuando son devueltos por el autorizador.

116

cardSequenceNumber

Numérico

Número de secuencia de la tarjeta. Se utiliza para distinguir tarjetas que tienen el mismo PAN (Primary Account Number).
Este campo se obtiene del TAG 5F34
Para transacciones Bancomer EMV.

117

emvFullGradeIcc

Numérico

Datos de EMV Full Grade
Conforme a anexo 2 de Especificación de EMV FULLGrade de Bancomer para campo 55 del ISO
Para transacciones EMV

119

refundIsVoided

125

qps

Numérico

Aplica para Bancomer
Indicador de Quick Payment Service
0 - El pagaré SÍ requiere firma
9 - El pagaré NO requiere firma

129

pinpadReset

Numérico

0 = Cuenta por omisión. Pin Pad NO requiere telecarga
1 = Pin Pad requiere telecarga

160

hostCode

Alfanumérico

Código del canal por el cual se autorizó la tarjeta.
Disponible a partir de la versión 3.7.30.4

166

trxReferenceNumber

Numérico

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.

302

issuingBank

Alfanumérico

Nombre del banco emisor de la tarjeta. Informado por Centro Autorizador.

309

cardBrand

Alfanumérico

Marca de tarjeta. Informado por Centro Autorizador

#

FieldId

Tipo

Obligatorio

Descripción

1

store

Alfanumérico

SI

Identificador del sitio originador de la transacción

2

node

Numérico

SI

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

3

server

Alfanumérico

Compatibilidad atrás.

Identificador del Server que procesará la transacción. (en el caso de eVTOL será 'VTOL')

4

messageType

Alfanumérico

Compatibilidad atrás.

Tipo de Mensaje:

• Control = Mensaje de Control, para uso interno por parte de un módulo en su comunicación con el server.
• Data = Mensaje de la Aplicación cliente.

6

cardNumber

Numérico

Obligatorio si es Manual

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

7

expiration

Numérico

Obligatorio si es Manual

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

8

cvc

Numérico

Obligatorio si es Manual. Además es opcional según la tarjeta.

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

9

track2

Alfanumérico

Obligatorio si es MSR

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

posInputMode

Alfanumérico

Obligatorio

Modo de Ingreso:

• MSR = Ingreso por banda magnética
• Manual = Ingreso manual
• Chip = Tarjeta insertada PIN Pad
• MSR Chip = Tarjeta deslizada PIN Pad
• MSR ChipNR = Ingreso Manual PIN Pad
• MSR ChipError = Fallback PIN Pad

11

trxType

Alfanumérico

Obligatorio

Tipo de Transacción:

• CAddressVerification = Compra

12

amount

Importe

Obligatorio

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

Obligatorio

Tipos de Moneda:

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

14

payments

Numérico

Obligatorio

Cantidad de cuotas/parcialidades (meses). 2 dígitos como máximo.

15

plan

Alfanumérico

Obligatorio

Plan. 1 caracter de longitud.

22

authorizationCode

Numérico

Condicional a si fue realizada la autorización telefónica.

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.

23

authorizationMode

Alfanumérico

Opcional, default = Online

Modo de Autorización:

• Online = La autorización debe ser realizada por el Centro Autorizador.
• Offhost = La autorización fue realizada internamente por VTOL.
• Offline = La autorización fue realizada localmente por el POS.

25

dateTime

Numérico

Obligatorio

Fecha de generación de la trx en el POS. Formato YYYYMMDDHHmmss

53

paymentCondition

Alfanumérico

Opcional

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

56

pinblock

Alfanumérico

Condicional a PIN Pad

PIN encriptado. Se emplea para tarjetas de débito. Ejemplo pinblock: D76484D688FE1826

66

track1

Alfanumérico

Opcional a su lectura

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

70

effectiveDate

Alfanumérico

Opcional AMEX

Fecha efectiva. Se usa para AMEX con formato yyMM

71

checkPendingString

Alfanumérico

Opcional, default = true

Indica si VTOL debe o no efectuar el chequeo de pendientes (se emplea para pagos parciales de tarjetas):

• True = activa chequeo de pendientes.
• False = desactiva chequeo de pendientes.

82

customerEmail

Alfanumérico y caracteres especiales

Condicional

Para transacciones E-Commerce y MOTO
Correo electrónico del cliente
Ejemplo:
[email protected]

102

chipTokens

Alfanumérico

Obligatorio para modo de ingreso Chip

Amex: En el caso que el adquirente sea Banamex. Los tokens se envían tal cual los general el PinPad sin ningún tipo de procesamiento.

115

originIndicator

117

emvFullGradeIcc

Alfanumerico

Condicional

Para Amex:. Los Tags se deben enviar tal cual los genera el PinPad sin ningun tipo de procesamiento.

150

customerHostname

Alfanumérico y caracteres especiales

Condicional

Para transacciones E-Commerce y MOTO
Nombre del servidor al que el cliente está conectado.
Ejemplo:
PHX.QW.AOL.COM

152

shipToCountry

Alfanumérico y caracteres especiales

Condicional

Para transacciones E-Commerce y MOTO
Código del país
Ejemplo:
Para México: 484

153

shippingMethod

Alfanumérico y caracteres especiales

Condicional

Para transacciones E-Commerce y MOTO
Método de envío:
01 = Mismo día
02 = Día siguiente
03 = Prioridad, 2-3 días
04 = Por tierra 4 o más
05 = Entrega electrónica

154

sku

Alfanumérico y caracteres especiales

Condicional

Para transacciones E-Commerce y MOTO
SKU único del producto asociado a esta solicitud de autorización. Para autorizaciones con múltiples artículos colocar un único SKU correspondiente al artículo con el precio mayor.
Ejemplo:
TKDC315U

155

customerIp

Alfanumérico y caracteres especiales

Condicional

Para transacciones E-Commerce y MOTO
Dirección IP del cliente
Ejemplo 1: 127.142.151.223
Ejemplo 2: 127.142.5.56~~~

156

customerANI

Alfanumérico y caracteres especiales

Condicional

Para transacciones E-Commerce y MOTO
ANI (Automatic Number Identification)
Número telefónico que el cliente utilizó para realizar la orden.
Example: 6025551212

157

customerIIDigits

Alfanumérico y caracteres especiales

Condicional

Para transacciones E-Commerce y MOTO
ANI Information Identifier (II)
Dígitos asociados con el tipo de teléfono del cliente
Ejemplo:
Celular (61-63), teléfono público (27),llamada gratuita (24, 25), etc.

'00'

Aprobada

'01'

Pedir autorización telefónica

'02'

Pedir autorización

'03'

Comercio inválido

'04'

Capturar tarjeta

'05'

Denegada

'07'

Retenga y llame

'11'

Aprobada

'12'

Transacción inválida

'13'

Monto inválido

'14'

Tarjeta inválida

'22

Código de Seguridad Inválido

'25'

No existe original

'30'

Error en formato

'38'

Excede ingreso de PIN

'43'

Retener tarjeta

'45'

No opera en cuotas/Promoción no permitida

'46

Monto inferior al mínimo para promoción

'46'

Tarjeta no vigente

'47'

PIN requerido

'48'

Excede máximo de cuotas

'48

CV2 inválido

'49'

Error fecha de vencimiento

'50'

Entrega supera límite

'51'

Fondos insuficientes

'53'

Cuenta inexistente/inválida

'54'

Tarjeta vencida

'55'

PIN incorrecto

'56'

Tarjeta no habilitada

'57'

Transacción no permitida

'58'

Servicio inválido

'61'

Excede límite

'62

Bin Card no permitido

'65'

Excede límite de tarjeta

'65

Intento de retiros excedido

'70

Error descifrando T2

'71

Inicializar Llaves

'72

Error al inicializar llaves

'73

Error en CRC

'76'

Llamar al emisor

'77'

Error plan/cuotas

'82

CVV/CVV2 Incorrecto

'85'

Aprobada

'86'

No envía fecha original

'89'

Terminal inválida

'89

Comercio cerrado o cancelado

'89

Nueva tarjeta emitida

'91'

Emisor fuera de línea

'94'

Número de secuencia duplicado

'95'

Re-transmitiendo

'96'

Error en sistema

'99'

Error no clasificado 

Modo de ingreso inválido 

Proveedor inválido 

Error CVC 

Error creando mensaje 

Tipo de mensaje inválido 

No envía código de autorización 

Error en fecha efectiva 

Error en fecha vencimiento

Tarjeta no efectiva 

No opera off-line 

Devolución monto mayor 

Original ya anulada

Original ya devuelta 

Original reversada

Moneda inválida 

No envía fecha 

Campo 71 inválido 

Campo 71 nulo 

CVC inválido 

Terjeta inválida 

Track2 inválido 

No envía moneda 

No envía CVC 

Timeout

Fecha original inválida 

No envía ticket original 

Ticket original inválido 

No envía código de autorización de venta referida

Reintente 

Chiptokens Invalido

Campo emvFullGradeIcc Inválido 

Error script 

Error criptograma 

Error cardSequenceNumber 

Check-in no confirmado

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 

Banorte: sólo para Vesta

El monto no puede ser mayor al monto de la Preautorización.

Banorte: sólo para Vesta

Amex: Para cancelar se utiliza un reverso a través del Rollback

• Mensaje en línea
• Envío de TEF

• Lote abierto: mensaje en línea
• Lote cerrado: no envía ningún mensaje

Para lote abierto, se maneja como una cancelación del CheckIn.

Para lote cerrado, si el POS anula la Preautorización, se la deja vencer, no se envía mensaje al Autorizador. La devolución del dinero al tarjetahabiente se realiza cuando se vence la Preautorización.