Especificaciones Técnicas y Funcionales

Proyecto: Visa POS Integrado

Tipo: Especificaciones protocolo

VISA POS Integrado

Especificaciones de protocolo

Observaciones

PRISMA Medios de Pago Pagina 1 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

1. Histórico

Versión Fecha Descripción Autor

1.01 23/10/2006 Creación del documento. JB

1.02 04/07/2007 Se agregaron campos a algunos mensajes y FN

codigos de respuesta de host en anexo 3
1.03 26/12/2011 Se agrega campo a algunos mensajes con el VA
agregado del BIN.
1.04 30/10/2015 Se modifica la longitud de Planes MERA

1.05 17/12/2015 Se incorpora la funcionalidad Vending, con la MERA

tarjeta genérica “VVI”
1.06 12/02/2016 Se agrega ejemplos de tramas MERA

1.07 21/11/2016 Se corrigio el comando PLA: IOR

Código de tarjeta de N2 a N3
Código de plan de N1 a N2

1.08 17/03/2017 Apartado 5.2 , formato del campo LARGO DE

CAMPOS (2 bytes hex) en mensaje pos
integrado

1.09 13/03/2018 Se corrigió la respuesta del Comando DEV. MERA

Posición 76 (4 últimos dígitos de la tarjeta)
Posición 80 (6 primeros dígitos de la tarjeta)

PRISMA Medios de Pago Pagina 2 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

2. Índice

1. Histórico ......................................................................................................... 2
2. Índice ............................................................................................................. 3
3. Introducción ................................................................................................... 4
4. Arquitectura ................................................................................................... 4
5. Protocolo Serial ............................................................................................. 5
5.1. Nivel de enlace ....................................................................................... 5
5.2. Nivel de aplicación .................................................................................. 5
5.2.1. Test de conexión ............................................................................. 6
5.2.2. Venta ............................................................................................... 7
5.2.3. Anulación de venta .......................................................................... 9
5.2.4. Devolución ..................................................................................... 12
5.2.5. Anulación de devolución................................................................ 14
5.2.6. Cierre............................................................................................. 15
5.2.7. Obtener datos de última transacción ............................................. 17
5.2.8. Obtener datos de último cierre ...................................................... 18
5.2.9. Reimpresión de ticket de última transacción ................................. 20
5.2.10. Reimpresión de ticket de último cierre ....................................... 20
5.2.11. Obtener tabla de tarjetas ........................................................... 21
5.2.12. Obtener tabla de planes ............................................................. 25
Anexo 1............................................................................................................... 28
Códigos de respuesta generales (IngStore) .................................................... 28
Códigos de respuesta específicos ( Visa POS Integrado) ............................... 28
Anexo 2............................................................................................................... 29
Resumen de nombres de comandos............................................................... 29
Anexo 3............................................................................................................... 30
Códigos de respuesta de Host. ........................................................................... 30

PRISMA Medios de Pago Pagina 3 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

3. Introducción

Este documento tiene como objetivo la definición del protocolo de

comunicaciones entre una caja tipo PC y un POS Ingenico con la aplicación
Crédito-Débito de Visa Argentina.
La solución está planteada por capas. La aplicación de la caja o del POS, le
pasarán los parámetros necesarios a los módulos:
 “visaposi.dll”: DLL de Windows 32, que corre del lado de la caja.
 “visaposi.lib”: Librería estática, que es linkeada a la aplicación del POS.
Este módulo es el encargado de formatear los parámetros que son enviados a la
capa de más bajo nivel, que es definitiva la que se encarga de la comunicación.
Estos módulos son:
 “ingstore.dll”: del lado de la PC
 “ingstore.lib”: del lado del POS

4. Arquitectura

Caja POS
Sistema propio Crédito-Débito
Visa Arg

visaposi visaposi

ingestor ingestor
RS232

PRISMA Medios de Pago Pagina 4 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

5. Protocolo Serial

5.1. Nivel de enlace

La comunicación debe ser serial RS232. La configuración es parametrizable,

con la siguiente configuración por defecto:
 Velocidad: 19200 bps
 Bits de datos: 8
 Paridad: N (sin paridad)
 Bits de parada: 1

La comunicación siempre la inicia y finaliza la Caja, y el POS responde.

5.2. Nivel de aplicación

Formato del paquete de datos

Largo Descripción
0x02 H1 Indicador de inicio de paquete (STX)
COMANDO A3 Indica el comando enviado (VEN, ANV, Etc)
Largo de los campos enviados. Tamaño 2 bytes
Si no tiene
parámetros, el valor es 0 (“00h 00h”)

Ejemplo para el comando VEN con largo de 104

(decimal) 68 (hex) caracteres:
LARGO DE 56 45 4E 68 00
CAMPOS H2
Ejemplo para el comando TES con largo de 0
caracteres:
54 45 53 00 00

0x03 H1 Indicador de fin de paquete (ETX)

CRC 1

PRISMA Medios de Pago Pagina 5 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

5.2.1. Test de conexión

Nombre del comando

“TES”

Parámetros de entrada

Sin parámetros

Parámetros de retorno

Sin parámetros

Ejemplo Trama
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 41
HEX: 02 54 45 53 00 00 03 41
DEC: .TES...A

Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 70
HEX: 06 02 54 45 53 30 30 31 00 00 03 70
DEC: ..TES001...p
Enviado:
HEX: 06
DEC: 6

PRISMA Medios de Pago Pagina 6 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Venta
Nombre del comando:

“VEN”

Parámetros de entrada:

Posición Formato Largo Descripción

0 N 12 Monto. Los dos últimos dígitos son los decimales
12 N 12 Número de factura. En caso de no corresponder
se completará con “0”
24 N 2 Cantidad de cuotas. Alineado a derecha, relleno
con “0”.
26 N 3 Código de tarjeta. Alineado a derecha, relleno
con “0”.
29 N 1 Código de plan. Alineado a derecha, relleno con
“0”. En caso de no corresponder, deber ir en
blanco.
30 N 12 Monto de propina. Los dos últimos dígitos
son decimales. En caso de no corresponder
se completará con “0”
42 N 15 Código de comercio. En caso de no
corresponder deberá ir en blanco.
57 A 23 Nombre de comercio. En caso de no
corresponder deberá ir en blanco.
80 A 23 Cuit del comercio. En caso de no corresponder
deberá ir en blanco.
103 A 1 Line mode. \x01 si la trx es online y ‘\x00’ si la
transacción es offline

PRISMA Medios de Pago Pagina 7 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 2 Código de respuesta del host. El valor “00”
significa aprobado.
2 A 32 Mensaje de respuesta. Alineado a izquierda,
relleno con blancos.
34 N 6 Código de autorización. Relleno con “0” en caso
de no corresponder.
40 N 7 Número de cupón. Relleno con “0” en caso de
no corresponder.
47 N 3 Número de lote. Alineado a derecha, relleno con
“0”.
50 A 26 Nombre del cliente leído de la banda. Relleno
con blanco en caso de no corresponder.
76 N 4 Últimos 4 dígitos de la tarjeta. Relleno con “0” en
Caso de no corresponder.
80 N 6 Primeros 6 dígitos de la tarjeta. Relleno con “0”
en caso de no corresponder.
86 A 10 Fecha de la transacción (“DD/MM/AAAA”)
96 A 8 Hora de la transacción (“HH:MM:SS”)
104 N 8 Terminal id

PRISMA Medios de Pago Pagina 8 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Ejemplo Trama
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 11
Fin de paquete: 03
HEX: 02 56 45 4E 68 00 30 30 30 30 30 30 30 30 30 31
30 30 31 30 30 30 30 30 30 38 39 30 31 32 30 31
30 56 49 30 30 30 30 30 30 30 30 30 30 30 30 30
30 33 36 35 39 33 30 37 20 20 20 20 20 20 20 50
52 49 53 4D 41 20 4D 50 20 20 20 20 20 20 20 20
20 20 20 20 20 20 33 30 2D 35 39 38 39 31 30 30
34 2D 35 20 20 20 20 20 20 20 20 20 20 01 03 11
DEC:
.VENh.000000000100100000089012010VI000000000000003659307
PRISMA MP 30-59891004-5 ...

Formato del paquete

STX + VEN + 2 bytes LEN + CAMPOS + ETX + CRC
68 00 (HEX) = 104 bytes de largo de campos

Descripción de los campos del comando “VEN”

Monto: 000000000100
Nro de Factura: 100000089012
Cantidad Cuotas: 01
Código de Tarj: 0VI
Código de Plan: 0
Monto de Propina: 000000000000
Código de Comercio: 03659307
Nombre Comercio: PRISMA MP
CUIT: 30-59891004-5
Online: 01

Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 7C
Fin de paquete: 03
HEX: 06 06 02 56 45 4E 30 30 30 70 00 30 30 30 30 20
20 50 4C 41 4E 20 56 3A 20 61 62 6F 6E 65 20 73
75 20 72 65 73 75 6D 65 6E 20 20 20 20 30 32 30
36 37 30 30 30 30 30 30 30 31 30 30 31 50 52 55
45 42 41 2F 50 52 55 45 42 41 20 20 20 20 20 20
20 20 20 20 20 20 20 37 37 38 37 34 35 30 37 39
39 31 32 2F 30 32 2F 32 30 31 36 31 34 3A 34 32
3A 30 30 31 37 30 30 30 30 39 36 03 7C
DEC:
...VEN000p.0000 PLAN V: abone su resumen
0206700000001001PRUEBA/PRUEBA
778745079912/02/201614:42:0017000096.|

PRISMA Medios de Pago Pagina 9 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Descripción de los campos de respuesta del comando “VEN”

Código de Respuesta: 00
Mensaje de Respuesta: 00 PLAN V: abone su resumen
Codigo de Autorización: 020670
Nro de Cupón: 0000001
Nro de Lote: 001
Nombre del Cliente: PRUEBA/PRUEBA
4 últimos de Tarjeta: 7787
Bin de Tarjeta: 450799
Fecha trans: 12/02/2016
Hora trans: 14:42:00
Nro Terminal: 17000096

Enviado:
HEX: 06
DEC: 6

En el caso que se obtenga la respuesta de la venta se obtiene ...VEN000p.

En el caso que se envie la venta, pero se cancele desde el POS o se caiga por
time out se obtiene ..VEN201...m:
Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 6D
Fin de paquete: 03
HEX: 06 02 56 45 4E 32 30 31 00 00 03 6D
DEC: ..VEN201...m

Enviado:
HEX: 06
DEC: 6

PRISMA Medios de Pago Pagina 10 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Anulación de venta
Nombre del comando:

“ANV”

Parámetros de entrada:

Posición Formato Largo Descripción

0 N 7 Número de cupón de la transacción original.
7 N 3 Código de tarjeta.

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 2 Código de respuesta del host. El valor “00”
significa aprobado.
2 A 32 Mensaje de respuesta del host
34 N 6 Código de autorización. Relleno con “0” en caso
de no corresponder.
40 N 7 Número de ticket. Relleno con “0” en caso de no
corresponder.
47 N 3 Número de lote
50 A 26 Nombre del cliente leído de la banda. Alineado a
izquierda, relleno con blanco en caso de no
corresponder.
76 N 6 Primeros 6 dígitos de la tarjeta. Relleno con “0”
en caso de no corresponder.
82 N 4 Últimos 4 dígitos de la tarjeta. Relleno con “0” en
caso de no corresponder.
86 A 10 Fecha de la transacción (“DD/MM/AAAA”)
96 A 8 Hora de la transacción (“HH:MM:SS”)
104 N 8 Terminal ID

PRISMA Medios de Pago Pagina 11 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Devolución
Nombre del comando:

“DEV”

Parámetros de entrada:

Posición Formato Largo Descripción

0 N 12 Monto. Los dos últimos dígitos son los decimales
12 N 3 Código de tarjeta. Alineado a derecha, relleno
con “0”.
15 N 1 Código de plan. Alineado a derecha, relleno con
“0”.
16 N 2 Cantidad de cuotas. Alineado a derecha, relleno
con “0”.
18 N 7 Número de cupón de la transacción original
25 A 10 Fecha de la transacción original. Formato
“DD/MM/AAAA”
35 N 12 Número de factura. En caso de no corresponder
se completará con “0”
47 N 15 Código de comercio. En caso de no
corresponder deberá ir en blanco.
62 A 23 Nombre de comercio. En caso de no
corresponder deberá ir en blanco.
85 A 23 Cuit del comercio. En caso de no corresponder
deberá ir en blanco.
108 A 1 Line mode. \x01 si la trx es online y ‘\x00’ si la
transacción es offline

PRISMA Medios de Pago Pagina 12 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 2 Código de respuesta del host. El valor “00”
significa aprobado (Ver lista completa en Anexo
2).
2 A 32 Mensaje de respuesta. Alineado a izquierda,
relleno con blancos.
34 N 6 Código de autorización. Relleno con “0” en caso
de no corresponder.
40 N 7 Número de cupón. Relleno con “0” en caso de
no corresponder.
47 N 3 Número de lote. Alineado a derecha, relleno con
“0”.
50 A 26 Nombre del cliente leído de la banda. Relleno
con blanco en caso de no corresponder.
76 N 4 Últimos 4 dígitos de la tarjeta. Relleno con “0” en
caso de no corresponder.
80 N 6 Primeros 6 dígitos de la tarjeta. Relleno con “0”
en caso de no corresponder.
86 A 10 Fecha de la transacción (“DD/MM/AAAA”)
96 A 8 Hora de la transacción (“HH:MM:SS”)
104 N 8 Terminal ID

PRISMA Medios de Pago Pagina 13 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

5.2.2. Anulación de devolución

Nombre del comando:

“AND”

Parámetros de entrada:

Posición Formato Largo Descripción

0 N 7 Número de cupón de la transacción original.
7 N 3 Código de tarjeta

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 2 Código de respuesta del host. El valor “00”
significa aprobado (Ver lista completa en Anexo
2)
2 A 32 Mensaje de respuesta del host
34 N 6 Código de autorización. Relleno con “0” en caso
de no corresponder.
40 N 7 Número de ticket. Relleno con “0” en caso de no
corresponder.
47 N 3 Número de lote
50 A 26 Nombre del cliente leído de la banda. Relleno
con blanco en caso de no corresponder.
76 N 4 Últimos 4 dígitos de la tarjeta. Relleno con “0” en
caso de no corresponder.
80 N 6 Primeros 6 dígitos de la tarjeta. Relleno con “0”
en caso de no corresponder.
86 A 10 Fecha de la transacción (“DD/MM/AAAA”)
96 A 8 Hora de la transacción (“HH:MM:SS”)
104 N 8 Terminal ID

PRISMA Medios de Pago Pagina 14 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

5.2.3. Cierre
Nombre del comando:

“CIE”

Parámetros de entrada:

Ninguno

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 2 Código de respuesta del host
2 A 10 Fecha (“DD/MM/AAAA”)
12 A 8 Hora (“HH:MM:SS”)
20 N 8 Terminal ID

PRISMA Medios de Pago Pagina 15 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Ejemplo Trama
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 4C
Fin de paquete: 03
HEX: 02 43 49 45 00 00 03 4C
DEC: .CIE...L
Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 63
Fin de paquete: 03
HEX: 06 02 43 49 45 30 30 30 1C 00 30 30 31 32 2F 30
32 2F 32 30 31 36 31 36 3A 31 34 3A 35 39 31 37
30 30 30 30 39 36 03 63
DEC: ..CIE000..0012/02/201616:14:5917000096.c

Descripción de los campos de respuesta del comando “CIE”

Código de Respuesta: 00
Fecha: 12/02/2016
Hora: 16:14:59
Nro Terminal: 17000096

Enviado:
HEX: 06
DEC: 6

PRISMA Medios de Pago Pagina 16 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Obtener datos de última transacción

Nombre del comando

“ULT”

Parámetros de entrada:

Sin parámetros.

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 1 Código de tipo de transacción:
 1: Venta
 2: Anulación de venta
 3: Devolución
 4: Anulación de devolución
1 N 2 Código de respuesta del host. El valor “00”
significa aprobado (Ver lista completa en Anexo
2)
3 A 32 Mensaje de respuesta del host.
35 N 6 Código de autorización. Relleno con “0” en caso
de no corresponder.
41 N 7 Número de cupón. Relleno con “0” en caso de
no corresponder.
48 3 Número de lote.
51 A 26 Nombre del cliente leído de la banda. Relleno
con blanco en caso de no corresponder.
77 N 6 Primeros 6 dígitos de la tarjeta. Relleno con “0”
en caso de no corresponder.
83 N 4 Últimos 4 dígitos de la tarjeta. Relleno con “0” en
caso de no corresponder.
87 A 10 Fecha de la transacción (“DD/MM/AAAA”)
97 A 8 Hora de la transacción (“HH:MM:SS”)
105 N 8 Terminal ID

PRISMA Medios de Pago Pagina 17 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

5.2.4. Obtener datos de último cierre

Nombre del comando

“ULC”

Parámetros de entrada

Posición Formato Largo Descripción

0 N 4 Índice del registro requerido de tarjeta,
comenzando por 0. Alineado a la derecha,
relleno con “0”.

Parámetros de retorno

Posición Formato Largo Descripción

0 N 4 Índice del registro.
4 N 3 Código de procesador.
7 N 3 Número de lote.
10 N 3 Código de tarjeta
13 N 4 Cantidad de ventas.
17 N 12 Monto total de ventas.
29 N 4 Cantidad de anulaciones de venta.
33 N 12 Monto total de anulaciones.
45 N 4 Cantidad de devoluciones de venta.
49 N 12 Monto total de devoluciones de venta.
61 N 4 Cantidad de anulaciones de devolución.
65 N 12 Monto total de anulaciones de devolución.
77 A 10 Fecha de cierre xx/xx/20xx
87 A 8 Hora de cierre xx:xx:xx
95 N 8 Terminal ID

PRISMA Medios de Pago Pagina 18 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Ejemplo Trama
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 5D
Fin de paquete: 03
HEX: 02 55 4C 43 04 00 30 30 30 30 03 5D
DEC: .ULC..0000.]
Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 4F
Fin de paquete: 03
HEX: 06 02 55 4C 43 30 30 30 67 00 30 30 30 30 56 49
53 30 30 31 56 49 20 30 30 30 33 30 30 30 30 30
30 30 30 30 33 30 30 30 30 30 30 30 30 30 30 30
30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30
30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30
30 30 30 30 30 30 30 31 32 2F 30 32 2F 32 30 31
36 31 36 3A 31 34 3A 35 39 31 37 30 30 30 30 39
36 03 4F
DEC:
..ULC000g.0000VIS001VI
00030000000003000000000000000000000000000000000000000
0000000000012/02/201616:14:5917000096.O

Descripción de los campos de respuesta del comando “ULC”

Índice de Reg: 0000
Código de Procesador: VIS
Nro de Lote: 001
Código Tarjeta: VI
Cantidad Ventas: 0003
Monto Ventas: 000000000300
Cantidad Anulaciones Ventas: 0000
Monto Anulaciones Ventas: 000000000000
Cantidad Devoluciones Ventas: 0000
Monto Devoluciones Ventas: 000000000000
Cantidad Anulación de Devoluciones Ventas: 0000
Monto Anulación Devoluciones Ventas: 000000000000
Fecha Cierre: 12/02/2016
Hora Cierre: 16:14:59
Nro Terminal: 17000096

Enviado:
HEX: 06
DEC: 6

PRISMA Medios de Pago Pagina 19 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Reimpresión de ticket de última transacción

Nombre del comando

“IMT”

Parámetros de entrada

Sin parámetros.

Parámetros de retorno

Sin parámetros.

5.2.5. Reimpresión de ticket de último cierre

Nombre del comando

“IMC”

Parámetros de entrada

Sin parámetros.

Parámetros de retorno

Sin parámetros.

PRISMA Medios de Pago Pagina 20 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

5.2.6. Obtener tabla de tarjetas

Nombre del comando

“TAR”

Parámetros de entrada:

Posición Formato Largo Descripción

0 N 4 Índice del registro requerido, comenzando por 0.
Alineado a la derecha, relleno con “0”.

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 4 Índice del registro
4 A 3 Código de procesador
7 A 3 Código de tarjeta
10 A 16 Nombre de la tarjeta. Alineado a izquierda
relleno con blancos.
26 N 2 Máxima cantidad de cuotas permitidas por la
tarjeta
28 N 8 Terminal ID

PRISMA Medios de Pago Pagina 21 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Ejemplo Trama
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 40
Fin de paquete: 03
HEX: 02 54 41 52 04 00 30 30 30 30 03 40
DEC: .TAR..0000.@

Descripción de los campos del comando “TAR”

Índice de Reg: 0000

Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 26
Fin de paquete: 03
HEX: 06 02 54 41 52 30 30 31 24 00 30 30 30 30 56 49
53 56 49 20 56 49 53 41 20 20 20 20 20 20 20 20
20 20 20 20 39 39 31 37 30 30 30 30 39 36 03 26
DEC:
..TAR001$.0000VISVI VISA 9917000096.&
Descripción de los campos de respuesta del comando “TAR”
Índice de Reg: 0000
Código de Procesad or: VIS
Código Tarjeta: VI
Nombre Tarjeta: VISA
Máximo Cuotas: 99
Nro Terminal: 17000096
Enviado:
HEX: 06
DEC: 6
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 41
Fin de paquete: 03
HEX: 02 54 41 52 04 00 30 30 30 31 03 41
DEC: .TAR..0001.A

Descripción de los campos del comando “TAR”

Índice de Reg: 0001

PRISMA Medios de Pago Pagina 22 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 26
Fin de paquete: 03
HEX: 06 02 54 41 52 30 30 31 24 00 30 30 30 31 56 49
53 45 4C 20 56 49 53 41 20 44 45 42 49 54 4F 20
20 20 20 20 32 34 31 37 30 30 30 30 39 36 03 26
DEC:
..TAR001$.0001VISEL VISA DEBITO 2417000096.&
Descripción de los campos de respuesta del comando “TAR”
Índice de Reg: 0001
Código de Procesad or: VIS
Código Tarjeta: EL
Nombre Tarjeta: VISA DEBITO
Máximo Cuotas: 24
Nro Terminal: 17000096
Enviado:
HEX: 06
DEC: 6
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 42
Fin de paquete: 03
HEX: 02 54 41 52 04 00 30 30 30 32 03 42
DEC: .TAR..0002.B

Descripción de los campos del comando “TAR”

Índice de Reg: 0002

Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 37
Fin de paquete: 03
HEX: 06 02 54 41 52 30 30 30 24 00 30 30 30 32 56 49
53 4F 55 20 43 54 43 49 4C 53 2D 47 43 20 20 20
20 20 20 20 31 20 31 37 30 30 30 30 39 36 03 37
DEC:
..TAR000$.0002VISOU CTCILS-GC 1 17000096.7
Descripción de los campos de respuesta del comando “TAR”
Índice de Reg: 0002
Código de Procesad or: VIS
Código Tarjeta: OU
Nombre Tarjeta: CTCILS-GC
Máximo Cuotas: 1
Nro Terminal: 17000096
Enviado:
HEX: 06
DEC: 6

PRISMA Medios de Pago Pagina 23 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Aclaración: en la respuesta del comando TAR, mientras existan mas registro

devolverá ..TAR001, se indicará como ultimo registro al llegar ..TAR000

PRISMA Medios de Pago Pagina 24 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

5.2.7. Obtener tabla de planes

Nombre del comando

“PLA”

Parámetros de entrada:

Posición Formato Largo Descripción

0 N 4 Índice del registro requerido, comenzando por 0.
Alineado a la derecha, relleno con “0”.

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 4 Índice del registro. Alineado a la derecha, relleno
con “0”.
4 N 3 Código de tarjeta
7 N 2 Código de plan
9 A 14 Nombre del plan
23 N 8 Terminal ID

PRISMA Medios de Pago Pagina 25 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Ejemplo Trama
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 5A
Fin de paquete: 03
HEX: 02 50 4C 41 04 00 30 30 30 30 03 5A
DEC: .PLA..0000.Z

Descripción de los campos del comando “PLA”

Índice de Reg: 0000

Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 51
Fin de paquete: 03
HEX: 06 02 50 4C 41 30 30 31 1F 00 30 30 30 30 4F 55
20 30 20 20 20 20 43 4F 4D 50 52 41 20 20 20 20
20 31 37 30 30 30 30 39 36 03 51
DEC:
..PLA001..0000OU0 COMPRA 17000096.Q
Descripción de los campos de respuesta del comando “PLA”
Índice de Reg: 0000
Código Tarjeta: OU
Código Plan: 0
Nombre Plan: COMPRA
Nro Terminal: 17000096
Enviado:
HEX: 06
DEC: 6
Enviado:
ENQ:
05
Recibido:
ACK:
06
Enviado:
STX: 02
SUMA EN XOR PAQUETE COMPLETO SIN EL STX: 5B
Fin de paquete: 03
HEX: 02 50 4C 41 04 00 30 30 30 31 03 5B
DEC: .PLA..0001.[

Descripción de los campos del comando “PLA”

Índice de Reg: 0001

Recibido:
ACK: 06
SUMA EN XOR PAQUETE COMPLETO SIN EL ACK: 3A

PRISMA Medios de Pago Pagina 26 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Fin de paquete: 03
HEX: 06 02 50 4C 41 30 30 30 1F 00 30 30 30 31 4F 55
20 31 43 4F 4E 53 55 4C 54 41 20 53 41 4C 44 4F
20 31 37 30 30 30 30 39 36 03 3A
DEC:
..PLA000..0001OU1CONSULTA SALDO17000096.:
Descripción de los campos de respuesta del comando “PLA”
Índice de Reg: 0001
Código Tarjeta: OU
Código Plan: 1
Nombre Plan: CONSULTA SALDO
Nro Terminal: 17000096
Enviado:
HEX: 06
DEC: 6

Aclaración: en la respuesta del comando PLA, mientras existan más registro

devolverá ..PLA001, se indicará como último registro al llegar ..PLA000

PRISMA Medios de Pago Pagina 27 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Anexo 1
Códigos de respuesta generales (IngStore)

Valor Descripción
000 Operación exitosa.
Errores de implementación
901 Nombre del comando inexistente.
902 Largo de los parámetros inválido para este comando.
903 Formato de algún parámetro no es correcto.
909 Error general en la operación.

Códigos de respuesta específicos ( Visa POS Integrado)

Valor Descripción
001 Quedan registros por enviar.
Errores de parámetros de entrada
102 El número de ticket no existe.
103 El código de plan no existe.
104 El índice de registro no existe.
Errores al inicio de la transacción
201 Transacción cancelada por el usuario.
202 La tarjeta deslizada por el usuario no coincide con la pedida.
203 La tarjeta deslizada no es válida.
204 La tarjeta deslizada está vencida.
205 Transacción original inexistente.
206 No hay transacciones en el lote.
Errores al cerrar la transacción
301 El POS no pudo comunicarse con el host.
302 El POS no pudo imprimir el ticket.

PRISMA Medios de Pago Pagina 28 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Anexo 2
Resumen de nombres de comandos

Nombre Descripción
TES Test de conexión
VEN Venta
ANV Anulación de venta
DEV Devolución
AND Anulación de devolución
CIE Cierre
ULT Ultima transacción
ULC Ultimo cierre
IMT Reimpresión de ultima transacción
IMC Reimpresión de ultimo cierre
TAR Obtención de tabla de tarjetas
PLA Obtención de tabla de planes

PRISMA Medios de Pago Pagina 29 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Anexo 3
Códigos de respuesta de Host.

Cod Descripción Observaciones

Operación aprobada, emitir cupón (cargo o
00 APROBADA (authno)
ticket).
Solicitar autorización telefónica, en caso de ser
01 PEDIR AUTORIZACION aprobada, cargar el código obtenido y dejar la
operación en OFFLINE.
02 PEDIR AUTORIZACION Idem punto anterior.
Verificar parámetros del sistema, código de
03 COMERCIO INVALIDO
comercio mal cargado
04 CAPTURAR TARJETA Denegada, capturar la tarjeta.
05 DENEGADA Denegada.
07 RETENGA Y LLAME Denegada, llamar al Centro de Autorizaciones.
APROBADA PEDIR
08
IDENT.
Operación aprobada, emitir cupón (cargo o
11 APROBADA
ticket).
Verificar el sistema, transacción no reconocida
12 TRANSAC. INVALIDA
en el sistema.
Verificar el sistema, error en el formato del
13 MONTO INVALIDO
campo importe.
14 TARJETA INVALIDA Denegada, tarjeta no corresponde.
19 REINICIE OPERACIÓN
Denegada, registro no encontrado en el archivo
25 NO EXISTE ORIGINAL
de transacciones.
Verificar el sistema, error en el formato del
30 ERROR EN FORMATO
mensaje.
Denegada, excede cantidad de reintentos de
38 EXCEDE ING.DE PIN
PIN permitidos.
43 RETENER TARJETA Denegada, retener tarjeta.
Denegada, tarjeta inhibida para operar en
45 NO OPERA EN CUOTAS
cuotas.
46 TARJETA NO VIGENTE Denegada, tarjeta no está vigente aún.
47 PIN REQUERIDO Denegada, tarjeta requiere ingreso de PIN.
Denegada, excede cantidad máxima de cuotas
48 EXCEDE MAX. CUOTAS
permitida.
ERROR FECHA Verificar el sistema, error en formato de fecha de
49
VENCIM. expiración (vto)
Denegada, el monto de ENTREGA ingresado
ENTREGA SUPERA
50 está fuera de los límites permitidos.Verifique el
LIMIT
monto ingresado.
PRISMA Medios de Pago Pagina 30 de 33
Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

FONDOS
51 Denegada, no posee fondos suficientes.
INSUFICIENTES
53 CUENTA INEXISTENTE Denegada, no existe cuenta asociada.
54 TARJETA VENCIDA Denegada, tarjeta expirada.
Denegada, código de identificación personal es
55 PIN INCORRECTO
incorrecto.
56 TARJ. NO HABILITADA Denegada, emisor no habilitado en el sistema.
Verificar el sistema, transacción no permitida a
57 TRANS. NO PERMITIDA
dicha tarjeta.
Verificar el sistema, transacción no permitida a
58 SERVICIO INVALIDO
dicha terminal.
Denegada, excede límite remanente de la
61 EXCEDE LIMITE
tarjeta.
Denegada, excede límite remanente de la
65 EXCEDE LIM. TARJETA
tarjeta.
Solicitar autorización telefónica, en caso de ser
LLAMAR AL EMISOR –
76 aprobada, cargar el código obtenido y dejar la
ERROR – DESC. PROD.
operación en OFFLINE.
ERROR PLAN/CUOTAS
Denegada, cantidad de cuotas inválida para el
77 – ERROR
plan seleccionado.
RECONCILIACIÓN
APROBADA – LOTE NO Operación aprobada, emitir cupón (cargo o
85
ENCONTRADA ticket).
APROB. CLIENTE
88
LLAME
Denegada, número de terminal no habilitado por
89 TERMINAL INVALIDA
el Emisor.
Solicitar autorización telefónica, en caso de ser
91 EMISOR FUERA LINEA aprobada, cargar el código obtenido y dejar la
operación en OFFLINE.
Denegada. Error en mensaje. Envíe
94 NRO. SEC. DUPLICAD nuevamente la transacción incrementando en
uno el system trace de la misma.
Diferencias en la conciliación del cierre, envíe
95 RE-TRANSMITIENDO
Batch Upload.
ERROR EN SISTEMA – Mal funcionamiento del sistema. Solicitar
96
MENSAJE INVALIDO autorización telefónica.
El host responde este codgo cuando la captura
COMP NO DISPONILE de lote no esta disponible. EL terminal podrá
BB
INTENTE MAS TARDE seguir operando pero no será posible efectuar el
cierre de lote.
Denegada, cualquier otro código no
xx RECHAZADA (codnum)
contemplado en tabla.

PRISMA Medios de Pago Pagina 31 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Anexo 4
Vending
En el caso de operar en terminales Vending se suprime la impresión de cupón y
se incorpora la tarjeta genérica “VVI”, con la cual el POS reconoce la tarjeta con
la cual se está pagando, dependiente de la tarjeta que se desliza.
En este caso el comando de venta es el siguiente:

Nombre del comando:

“VEN”

Parámetros de entrada:

Posición Formato Largo Descripción

0 N 12 Monto. Los dos últimos dígitos son los decimales
12 N 12 Número de factura. En caso de no corresponder
se completará con “0”
24 N 2 Cantidad de cuotas. Alineado a derecha, relleno
con “0”.
26 N 3 Código de tarjeta. “VVI”
29 N 1 Código de plan. Alineado a derecha, relleno con
“0”. En caso de no corresponder, deber ir en
blanco.
30 N 12 Monto de propina. Los dos últimos dígitos son
decimales. En caso de no corresponder se
completará con “0”
42 N 15 Código de comercio. En caso de no
corresponder deberá ir en blanco.
57 A 23 Nombre de comercio. En caso de no
corresponder deberá ir en blanco.
80 A 23 Cuit del comercio. En caso de no corresponder
deberá ir en blanco.
103 A 1 Line mode. \x01 si la trx es online y ‘\x00’ si la
transacción es offline

PRISMA Medios de Pago Pagina 32 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al
 Especificaciones Técnicas y Funcionales

Parámetros de retorno:

Posición Formato Largo Descripción

0 N 2 Código de respuesta del host. El valor “00”
significa aprobado.
2 A 32 Mensaje de respuesta. Alineado a izquierda,
relleno con blancos.
34 N 6 Código de autorización. Relleno con “0” en caso
de no corresponder.
40 N 7 Número de cupón. Relleno con “0” en caso de
no corresponder.
47 N 3 Número de lote. Alineado a derecha, relleno con
“0”.
50 A 26 Nombre del cliente leído de la banda. Relleno
con blanco en caso de no corresponder.
76 N 6 Primeros 6 dígitos de la tarjeta. Relleno con “0”
en caso de no corresponder.
82 N 4 Últimos 4 dígitos de la tarjeta. Relleno con “0” en
Caso de no corresponder.
86 A 10 Fecha de la transacción (“DD/MM/AAAA”)
96 A 8 Hora de la transacción (“HH:MM:SS”)
104 N 8 Terminal id

PRISMA Medios de Pago Pagina 33 de 33

Gerencia de Negocios Red LaPos
1. Confi
denci
al