Manual TBK - 05 - 01 - 2024
Manual TBK - 05 - 01 - 2024
Manual TBK - 05 - 01 - 2024
IM30 - Paxstore
POS Autoservicio
Versión 0.1.1 – Julio 2023
Manual de integración
Índice
Introducción 1 pag
Especificaciones del producto 2 pag
Modulos del dispositivo 3, 4 pag
Componentes, interfaz y puertos 5-11 pag
Instalacion de tarjeta SAM/SIM 12 pag
Pantalla táctil 13 pag
Cámara frontal 14 pag
Cámara de escaneo de código 15 pag
Lector de tarjetas de banda magnética 16 pag
Lector de tarjetas con chip 17 pag
Lector de tarjetas sin contacto 18 pag
Detector de proximidad 19 pag
Indicador led de estado 20 pag
Instalación del producto 21 pag
Soporte de montaje 22 pag
Dimensión de la placa de montaje 23 pag
Instalación del soporte de montaje 24 pag
Instalación de la unidad IM30 25 pag
Cables y comunicación 26 pag
Transacciones y diagramas de secuencia 27-37 pag
Comandos 38-49 pag
Vouchers 50-52 pag
Códigos de respuesta 53-55 pag
Venta multicomercio 55 pag
Glosario 56 pag
Contenido del producto 56 pag
Control de cambios
Christian Rojas
1.0 Primer manual integración Octubre 2022
Patricio Fritz
Introducción
El manual de integración tiene como objetivo explicar las funcionalidades que incorpora el nuevo dispositivo de
Autoservicio IM30 de la marca Pax para los integradores de Transbank. El POS cuenta con lectura de banda, chip por
contacto y sin contacto, permitiendo realizar transacciones bancarias de Crédito y Débito.
Nuestro terminal de pago IM30 dispone de la tecnología necesaria para atender las necesidades de comercios para
modelos de operación sin la presencia de dependientes, fácil de instalar con un uso simple e intuitivo para sus clien-
tes. Está preparado para resistir entornos de trabajo interiores y exteriores pudiendo soportar un amplio rango de
temperatura, repeler la entrada de polvo y agua, resistir impactos físicos y descargas electroestaticas.
De este modo el comercio dispone de un equipo flexible que puede ser utilizado en múltiples aplicaciones y entornos
entregando una experiencia de compra enriquecida a sus clientes.
El diagrama que viene a continuación explica de forma general el funcionamiento del POS Autoservicio.
SDRAM LPDDR3 de 1 GB o 2 GB
Memoria
EMMC de 8 GB
2
9
3 10
4 11
12
5 13
6 14
15
7
Anclar Señal
1 POWER_IN
2 Rx
3 Tx
4 MDB_WAKEUP
5 Rts
6 Cts
7 Gnd
Puerto RJ45 (RS232-A)
8 Gnd
RJ45 de 8 polos, interfaz de alta velocidad (por defecto 115,2 kbps/conmutable hasta 921,6 kbps), blindado, protocolo de
enlace por hardware, máx. longitud del cable 100 cm.
Anclar Señal
1 POWER_OUT
2 Rx
3 Tx
4 MDB_WAKEUP
5 Rts
6 Cts
7 Gnd
Puerto RJ45 (RS232-B)
8 Gnd
RJ45 de 8 polos, interfaz de alta velocidad (predeterminada 115,2 kbps/conmutable hasta 921,6 kbps), blindada, protoco-
lo de enlace de hardware, máx. longitud del cable 100 cm, salida de tensión de alimentación controlada por software para
alimentar también componentes externos además de la comunicación.
Universal Serial Bus (USB)
IM30 posee un puerto USB tipo-A y tipo-C disponible para su uso, pueden aceptar una entrada de 5 V para energizar el
dispositivo.
USB-Host (tipo-A)
Señal Pin
Vin 1
D+ 2
D- 3
GND 4
N° N° Pin Señal
1 A1 Gnd
2 A2 Nc Puerto USB tipo A -
3 A3 Nc USB-OTG (tipo-C)
4 A4 VBUS
5 A5 USB_ID
6 A6 D+
7 A7 D- Señal Señal
8 A8 Nc
9 A9 VBUS A1 GND B1 GND
10 A10 Nc A2 NC B2 NC
11 A11 Nc
12 A12 Gnd A3 NC B3 NC
13 A13 Gnd
A4 VBUS B4 VBUS
14 A14 Nc
15 A15 Nc A5 USB_ID B5 USB_ID
16 A16 VBUS A6 D+ B6 D+
17 A17 USB_ID A7 D- B7 D-
18 A18 D+
A8 NC B8 NC
19 A19 D-
20 A20 Nc A9 VBUS B9 VBUS
21 A21 VBUS A10 NC B10 NC
22 A22 Nc
A11 NC B11 NC
23 A23 Nc
24 A24 Gnd A12 GND B12 GND
MDB- Slave
Multidrop Bus (MDB) es un protocolo de comunicación comúnmente utilizado en máquinas expendedoras. El IM30 tiene
un puerto esclavo MDB que puede comunicarse con un controlador de máquina expendedora y aceptar un voltaje de
entrada de 9 V a 42 V. MDB Master y MDB Slave para proporcionar dos conectores MDB separados con dos puertos de
comunicación separados. Se admiten los niveles MDB 1, 2 y 3.
Pin Señal
1 MDB PWR IN
3 MDB-Wakeup
4 MDB-Master Receive
Figure 8: MDB port
5 MDB-Master Transmit
6 MDB-Com Common
MDB-Master / Executive
El protocolo Executive (también conocido como protocolo BDV 001) es un protocolo de comunicación utilizado en la in-
dustria de las máquinas expendedoras en ciertos lugares de Europa. El IM30 tiene un conector personalizado de 20 pines
que funciona como un puerto maestro MDB, así como un puerto ejecutivo.
MDB_PWR_IN 1 MDB
Gnd 2 MDB
V_OUT (sin conmutar) 3 I/O and Switched voltage
Gnd 4 I/O and Switched voltage
MDB_MASTER_RX 5 MDB
MDB_MASTER_TX 6 MDB
Gnd 7 MDB
Gnd 8 MDB
EXE_MASTER_RX+ 9 EXE / Power input
EXE_MASTER_RX+ 10 EXE / Power input
Gnd 11 EXE / Power input
Gnd 12 EXE / Power input
DIGI_IN4_H 13 I/O and Switched voltage
20 pin connector (Amphenol 69168)
DIGI_OUT2_H 14 I/O and Switched voltage
DIGI_IN4_L 15 I/O and Switched voltage El IM30 tiene un conector especial de 20 pines
DIGI_OUT2_L 16 I/O and Switched voltage (Amphenol 69168) que funciona como puerto
master MDB y puerto Executive, y también está
MDB_WAKEUP 17 MDB disponible para I/O y voltaje conmutado.
V_OUT # (conmutado) 18 I/O and Switched voltage
EXE_PWR_L 19 EXE / Power input
EXE_PWR_N 20 EXE / Power input
MDB-Master
Esta función aún no es compatible actualmente
Executive
El protocolo Executive (también conocido como protocolo BDV 001) es un protocolo de comunicación utilizado en las
máquinas expendedoras.
Descripción Estado
Anclar Señal
1 DIGI_IN3
2 DIGI_IN2
3 DIGI_IN1
4 DIGI_OUT1
PWR-DIG I/O (WAGO 6pin)
5 Gnd
El terminal puede alimentarse mediante el co-
6 MDB_PWR_OUT nector PWR-DIG I/O (WAGO de 6 pines, enchufe
733_104). Este conector también habilita un puerto
de I/O digital.
Ethernet
IM30 tiene un puerto Ethernet 10/100 Base-T que puede usar para conectarse a una LAN cableada.
Ethernet puerto pinout
Anclar Señal
1 TX+
2 Tx-
3 RX+
4 Nc
5 Nc
6 Rx-
7 Nc Puerto Ethernet
8 Nc
AUX Jack:
El jack auxiliar es un término para una variedad de puertos analógicos generalmente hechos para transferir datos audiovi-
suales. El IM30 tiene un conector auxiliar de 3,5 mm que puede emitir una señal de audio estéreo y aceptar la entrada de
un micrófono.
Señal Pin
MIC 7
GND 2
AUDIO_LEFT 3
AUDIO_FEEDBACK 4
AUDIO_DETECT 5
AUDIO_RIGHT 6 Esquema de jack auxiliar
Botones:
El modelo disponible del IM30 tiene al menos 2 ranuras para tarjetas SAM de tamaño micro-SIM en el cuerpo principal del
dispositivo, como se ilustra en la Figura Montajes de tarjetas SAM. Estas dos ranuras para tarjetas normalmente están
ocultas debajo del módulo 4G descrito en la Figura Módulo 4G (destacado con tramado azul). Si el tornillo que sostiene el
módulo 4G en su lugar se afloja, se puede quitar del cuerpo principal del dispositivo haciendo palanca en la pestaña en el
lado derecho del módulo. Para instalar una tarjeta SAM en cualquiera de estas dos ranuras para tarjetas, abra el soporte
e inserte la tarjeta en la ranura con los contactos hacia abajo y el recortado en la esquina de la tarjeta en la parte superior
derecha, luego bloquee el soporte con la tarjeta dentro.
El módulo 4G está disponible en varias configuraciones, una configuración no tiene funcionalidad 4G y el módulo sim-
plemente sirve como cubierta para ranuras para tarjetas SAM (que se muestra en la Figura sin ranuras para tarjetas), la
configuración de otra, tiene 1 ranura para tarjetas SIM de tamaño micro-SIM (que se muestra en la Figura Ranura para tar-
jetas SIM), y una configuración tiene 2 ranuras para tarjetas SAM de tamaño micro-SIM además de la ranura para tarjetas
SIM (que se muestra en la Figura Ranuras para tarjetas SIM y SAM). Para instalar una tarjeta SIM o SAM en cualquiera
de estas ranuras en el módulo 4G, inserte una tarjeta en la ranura de la tarjeta con los contactos hacia arriba y la esquina
recortada de la tarjeta hacia adelante y hacia la derecha.
Pantalla táctil
El IM30 tiene una pantalla táctil capacitiva LCD de 5 pulgadas ubicada en su cara frontal.
La pantalla tiene una resolución de 1280 x 720 píxeles y está equipada con una retroiluminación LED ajustable. Esta
pantalla táctil funciona como la interfaz de usuario principal para el dispositivo, así como el mecanismo principal para
que el dispositivo muestre información a los usuarios. El brillo de la luz de fondo está controlado por software y se puede
ajustar para satisfacer las necesidades del usuario.
Cámara frontal
El IM30 tiene una cámara frontal ubicada en la parte superior de su cara delantera.
Esta cámara es de 2 megapíxeles (1616 x 1232) es capaz de capturar video o fotos de cualquier cosa que se enfrente a la
parte frontal de la unidad IM30. Su propósito principal es el reconocimiento facial en localidades donde tal función sería
útil.
Cámara de escaneo de código
El IM30 tiene una cámara de escaneo de código ubicada cerca de la esquina inferior derecha de su cara delantera.
Esta cámara de 0,3 megapíxeles (648 x 488) ubicada cerca de la parte inferior del IM30 está diseñada para leer códigos
1D o 2D comunes (como códigos de barras y códigos QR). La cámara está emparejada con un Indicador LED de posi-
ción que permite a los usuarios orientar sus cupones, tarjetas o dispositivos móviles para que el código se coloque en la
ubicación y distancia óptimas cuando la luz del LED ilumine directamente el código. El uso de la cámara de escaneo de
código quedará restringido a las aplicaciones implementadas por Transbank.
Lector de tarjetas de banda magnética
El IM30 tiene un lector de tarjetas de banda magnética ubicado en el lado derecho del dispositivo.
El sensor de proximidad detecta la luz en el espectro visible y está sintonizado para detectar objetos dentro de los 5 a 8
cm del sensor. Está destinado a realizar funciones como proporcionar una señal de activación al resto del dispositivo
cuando se detecta un usuario o calibrar la intensidad de la luz de backlight para que se ajuste al brillo de un entorno deter-
minado. el uso del detector de proximidad quedará restringido aplicaciones implementadas por Transbank.
Indicador led de estado
El IM30 tiene un indicador de estado RGB LED ubicado cerca de la parte inferior derecha de su cara frontal cerca del de-
tector de proximidad.
El funcionamiento del indicador de estado LED está controlado por software y depende de la configuración específica del
dispositivo. Puede mostrar una luz indicadora en rojo, verde o azul.
Instalación del producto
Dimensiones del dispositivo
El IM30 tiene las dimensiones físicas que se muestran en la Figura. Tenga en cuenta que varios cables se conectan
directamente a la parte posterior del dispositivo, por lo que se necesita una mayor holgura que la que se muestra para el
extremo posterior del dispositivo para instalar correctamente una unidad IM30.
El funcionamiento del indicador de estado LED está controlado por software y depende de la configuración específica del
dispositivo. Puede mostrar una luz indicadora en rojo, verde o azul.
Soporte de montaje
El IM30 está equipado con un soporte de montaje de plástico que permite fijarlo en su lugar en una placa de montaje.
105 32
146
85.5 4.0
108.7
118.1
R2.0
50.8
86.4
5.3
Estas dimensiones son las de un módulo de puerta estándar según lo definido por la Asociación Europea de Vending.
Los pernos M4 deben extruirse de la parte posterior de la placa de montaje para permitir que el soporte de montaje se
coloque en su lugar.
Instalación del soporte de montaje
El primer paso para instalar el IM30 como parte de un terminal de pago desatendido es asegurar el soporte de montaje
en la placa de montaje. La parte posterior de la placa de montaje debe tener cuatro pernos de pernos M4 que correspon-
dan a los cuatro puntos de montaje exteriores en el soporte de montaje. Deslice el soporte de montaje sobre los cuatro
pernos con él como se ilustra, conecte el soporte de montaje a la placa de montaje, luego use cuatro tuercas M4 para
asegurarlo en su lugar.
Inserción de la unidad IM30 en la parte frontal de la placa de montaje. Asegurar la unidad IM30 en su lugar con los cuatro
tornillos M4
Cables y comunicación
La caja requiere tener disponible una puerta serial RS232A, RS232B, USB tipo A (Host) o un puerto USB tipo C (OTG) para
la conexión del POS. Transbank recomienda utilizar conexión USB para asegurar estabilidad de la comunicación.
La comunicación con Transbank puede ser LAN, GPRS (No disponible a la fecha) o Wifi, por lo que requiere un punto de
red disponible, además de un enchufe con 220 Volts para alimentación del terminal IM30.
El POS solicita confirmar monto, operar tarjeta, ingreso de clave, y envía solicitud al autorizador, luego si la transacción es
aprobada, guarda la transacción y envía la respuesta a la caja, incluyendo código de aprobación, numero de operación y
datos de impresión.
(Para venta crédito, ofrece opción de cuotas y en modo sin contacto, si es mayor al monto establecido por la banca nacio-
nal como límite pedirá el PIN)
Excepciones:
• No se permiten transacción con tarjetas no bancarias.
• No se permiten transacciones con firma.
El POS al enviar una transacción genera automáticamente una reversa. Esta reversa se mantendrá vigente hasta que el
POS valide la respuesta del autorizador:
Si el terminal de venta recibe respuesta de validación, la reversa será borrada del POS.
En caso de que el POS no reciba la respuesta se enviará la transacción de reversa al autorizador.
Descripción:
La caja envía el requerimiento y espera como respuesta ACK/NAK, en caso de que llegue un NAK, debe reintentar el envío
del requerimiento 2 veces. Si recibe un ACK debe esperar la respuesta de la transacción.
El POS solicita los datos al usuario, y envía requerimiento al autorizador, en caso de ser aprobada, se guarda en Batch y se
envía respuesta a la caja. En caso de ser rechazada se envía respuesta a la caja indicando el estado de rechazo.
La caja al recibir la respuesta envía un ACK al POS si el mensaje está correcto, o un NAK para el caso en que el LRC no
corresponda.
El POS al recibir el ACK desde la caja vuelve al inicio a esperar un nuevo comando, para el caso que recibe un NAK vuelve
a enviar la respuesta 2 veces más.
Datos última venta
Comando enviado por la caja solicitando al POS los datos de la última venta guardada en memoria, teniendo como dato
relevante en la respuesta el número de ticket o boleta.
Este comando debe ser utilizado por la caja para el caso en que no recibe respuesta al comando de venta, y validará el
campo ticket o boleta contra el número de ticket asignado al cobro de la transacción, en caso de que los números compa-
rados sean distintos, la caja debe reintentar el cobro ejecutando nuevamente de la transacción de venta, para el caso en
que coincidan, significa que el cobro ya fue realizado.
Excepciones:
Al momento de ejecutar un cierre se borran todas las transacciones almacenadas en memoria del Terminal POS. Si al
recibir el comando última venta, no existe en memoria del POS, se envía la respuesta a la caja indicando el error
(ver Códigos de Respuesta).
Descripción:
La caja envía el requerimiento y espera como
respuesta ACK, Si recibe un ACK la caja debe
esperar la respuesta del POS, en caso de
recibir un NAK debe
reintentar enviando el comando 2 veces.
Esta es una transacción administrativa que se debe ejecutar diariamente o como mínimo una vez a la semana. Esta tran-
sacción es gatillada por la caja, y no recibe parámetros, el POS ejecuta la transacción de cierre contra la caja, enviando
como parámetro el tipo de impresión (0=Parámetros de impresión, 1=Voucher formateado). Como respuesta a la caja se
enviará un aprobado o rechazado (ver Códigos de Respuesta), y los datos de impresión del voucher para el caso en que
fuera aprobado.
Excepciones:
Para el cierre no se solicita tarjeta supervisora.
Descripción:
La caja envía el requerimiento y espera como respuesta ACK/NAK, en caso de que llegue un NAK, debe reintentar el envío
del requerimiento 2 veces. Si recibe un ACK debe esperar la respuesta de la transacción.
El POS envía requerimiento al autorizador, en caso de ser aprobada se ejecuta un reinicio del contador de transacciones
en el autorizador y se envía respuesta a la caja. En caso de ser rechazada se envía respuesta a la caja indicando el estado
de rechazo.
La caja al recibir la respuesta envía un ACK al POS si el mensaje está correcto, o un NAK para el caso en que el LRC no
corresponda.
El POS al recibir el ACK desde la caja vuelve al inicio a esperar un nuevo comando, para el caso que recibe un NAK vuelve
a enviar la respuesta 2 veces más.
Transacción carga de llaves
Transacción de venta:
Esta transacción permite al aplicativo de caja del comercio requerir y cargar nuevas llaves Working Key, desde Transbank.
Su uso debe ser limitado como prueba de comunicación IP para validar conectividad hacia el exterior.
POS
Descripción:
La caja envía el requerimiento y espera como respuesta ACK/NAK, en caso de que llegue un NAK, debe reintentar el envío
del requerimiento 2 veces. Si recibe un ACK debe esperar la respuesta de la transacción.
El POS envía requerimiento al autorizador, en caso de ser aprobada, se guarda nueva llave y se envía respuesta a la caja.
La caja al recibir la respuesta envía un ACK al POS si el mensaje está correcto, o un NAK para el caso en que el LRC no
corresponda.
El POS al recibir el ACK desde la caja vuelve al inicio a esperar un nuevo comando, para el caso que recibe un NAK vuelve
a enviar la respuesta 2 veces más.
Transacción de inicialización.
Esta es una transacción administrativa que se utiliza para cargar los parámetros y aplicativo en el terminal de autoservi-
cio de Transbank. Es usada por los técnicos al realizar la instalación de los equipos en el comercio. Previo a la ejecución
de esta transacción, es necesario realizar una transacción de cierre. Debido a que la transacción de Inicialización tiene
un tiempo superior a una venta normal y el tiempo en que el POS queda fuera de comunicación con la caja es variable, se
dividió en 2 comandos:
Posterior a la ejecución del comando de Inicialización, el módulo de auto atención del comercio enviará un comando “Po-
lling” para saber si el POS está activo o no. Una vez que se encuentre activo (enviando como respuesta un ACK) el módulo
de auto atención enviará el comando: respuesta de Inicialización donde se responderá si la acción fue exitosa o no. En
caso de que la inicialización no fuera exitosa el POS podrá seguir realizando ventas sin los parámetros actualizados.
CAJA Maxstore
ACK/NAK Respuesta
ACK/NAK
Resultado Inicialización
ACK/NAK
ACK/NAK
Descripción:
La caja envía el requerimiento y espera como respuesta ACK/NAK, en caso de que llegue un NAK, debe reintentar el envío
del requerimiento 2 veces.
El POS envía requerimiento a Transbank, y realiza el proceso de actualización. Una vez terminada la conexión con Trans-
bank, guarda fecha y hora además guarda un parámetro indicando éxito o fracaso de la inicialización.
Posterior a la inicialización (reinicio del POS) la caja enviará un comando polling para saber si el POS se encuentra activo
o no. Si el POS está disponible responde un ACK.
La caja al recibir un ACK, envía el comando al POS solicitando la respuesta de la inicialización, requerimiento y espera
como respuesta ACK/NAK, en caso de que llegue un NAK, debe reintentar el envío del requerimiento 2 veces.
Para el caso en que llegue un ACK, debe esperar la respuesta del POS indicando el resultado de la inicialización, si el cál-
culo el LRC está correcto envía un ACK, en caso contrario un NAK.
El POS al recibir el ACK vuelve al inicio a esperar un nuevo comando, para el caso que recibe un NAK vuelve a enviar la
respuesta 2 veces más.
Mensajes intermedios
Los mensajes intermedios permiten a la caja interactuar con mensajes propios del integrador en que el dispositivo IM30
entrega la oportunidad que la caja muestre sus mensajes por pantalla.
Descripción:
La caja envía el requerimiento y espera como respuesta ACK/NAK, en caso de que llegue un NAK, la caja debe reintentar
el envío del requerimiento 2 veces. Si recibe un ACK debe esperar la respuesta de la transacción.
El POS solicita los datos al usuario, y envía requerimiento al autorizador, en caso de ser aprobada, se guarda en bvatch y
se envía respuesta a la caja. En caso de ser rechazada se envía respuesta a la caja indicando el estado de rechazo.
Mientras el POS solicita datos al usuario, envía mensajes indicando a la caja en que instancia de la transacción se en-
cuentra. Estos mensajes solo se envían si la caja lo indica en comando de venta.
La caja al recibir la respuesta envía al POS un ACK si el mensaje está correcto, o un NAK para el caso en que el LRC no
corresponda.
El POS al recibir el ACK de la caja vuelve al inicio a esperar un nuevo comando, para el caso que recibe un NAK vuelve a
enviar la respuesta 2 veces más.
Diagramas de secuencia de polling
La caja envía el requerimiento y espera como respuesta ACK, Si recibe un ACK indica que el POS está funcionando y listo
para recibir un comando.
CAJA POS
Requerimiento (Pooling)
Polling
Respuesta (ACK)
Descripción:
En caso de no recibir el ACK, indica existe algún tipo de problema con la comunicación entra la caja y el POS, y debe rein-
tentar enviando el comando de polling al menos 3 veces.
Especificación de protocolo de comunicación
La comunicación a través de una puerta serial RS232A o RS232B tiene velocidades que van desde los 1200 Bps hasta
115200 Bps (8N1). La velocidad inicial del POS es de 19200 Bps 8N1.
La comunicación a través del puerto USB, esta con velocidad de 115200 Bps (8N1). Si cambia el tipo de comunicación de
serial a USB, quedara saeteada automáticamente a la velocidad anteriormente descrita.
Esquema de comunicación:
Flujo de comunicación:
ACK: Lo envía el POS o la caja como aviso de recepción OK (valor Hexa 0x06).
NAK: Lo envía el POS o la caja cuando el LRC calculado no corresponde al enviado (valor Hexa 0x15).
Timeout1: Es el tiempo de espera del ACK o NAK para reintentar él envió del requerimiento por la caja y la respuesta des-
de el POS.
El formato para los requerimientos y respuestas: <STX><DATA><ETX><LRC>.
LRC: Es un byte que se concatena luego del <FIN COMANDO>, y que se calcula realizando un XOR byte a byte del mensa-
je, el cual consta de: <DATA> + <FIN COMANDO>.
Desglose:
(30 XOR 32)
( (30 XOR 32) XOR 30)
( ( (30 XOR 32) XOR 30) XOR 30)
( ( ( (30 XOR 32) XOR 30) XOR 30) XOR 7C)
( ( ( ( (30 XOR 32) XOR 30) XOR 30) XOR 7C) XOR 31)
( ( ( ( ( (30 XOR 32) XOR 30) XOR 30) XOR 7C) XOR 31) XOR 32)
( ( ( ( ( ( (30 XOR 32) XOR 30) XOR 30) XOR 7C) XOR 31) XOR 32) XOR 33)
( ( ( ( ( ( ( (30 XOR 32) XOR 30) XOR 30) XOR 7C) XOR 31) XOR 32) XOR 33) XOR 7C)
Comandos
0200 - Solicitud transacción de venta
Requerimiento:
<STX>0200|10000|123456|1|0<ETX><LRC>
Respuesta:
<STX>0210|00|597033311777|V1700005||395561|000010000|1679|000054|CR|||VI|2610
2018|145117| COMPROBANTE DE VENTA CON PIN PAGO EN CUOTAS
TARJETA DE CREDITO Pruebas IM30 Desa Huerfanos 770 Piso 8
Santiago 597033311777-P20.1A1 FECHA HORA TERMINAL26/10/18
14:51:17 V1700005 NUMERO DE TARJETA B-VI************1679
TOTAL: $ 10.000NUMERO DE CUOTAS: 02TIPO DE CUOTAS: CUOTAS
SIN INTERESVALOR CUOTA 1: $ 5.000VALOR CUOTA 2: $ 5.000NUMERO DE
BOLETA: NUMERO DE OPERACION: 000054CODIGO DE AUTORIZACION:
395561 GRACIAS POR SU COMPRA ACEPTO PAGAR SEGÚN
CONTRATO CON EMISOR |01|03|5000|CUOTAS SIN INTERES<ETX><LRC>
Requerimiento:
<STX>0200|2500|123456|1|0<ETX><LRC>
Respuesta: <STX>0210|00|597033311777|V1700005|123456|718190|000002500|1679|000057|CR|||V
I|26102018|160635| COMPROBANTE DE VENTA CON PIN TARJETA DE CREDITO
Pruebas IM30 Desa Huerfanos 770 Piso 8 Santiago
597033311777-P20.1A1 FECHA HORA TERMINAL26/10/18 16:06:35
V1700005 NUMERO DE TARJETA B-VI************1679
TOTAL: $ 2.500NUMERO DE BOLETA: 123456NUMERO DE OPERACION:
000057CODIGO DE AUTORIZACION: 718190 GRACIAS POR SU
COMPRA ACEPTO PAGAR SEGUN CONTRATO CON EMISOR<ETX><LRC>
Multicódigo
Requerimiento:
<STX>0270|25000|123456|1|0|597001600402<ETX><LRC>
0271 – Respuesta Solicitud de venta
Valores:
00 = sin cuota (valor por default)
01 = cuota normal
03 = cuota contado
04 = n cuotas
02 = 2 cuotas
03 = 3 cuotas
xx = xx cuotas
Separador de campo 1 (opcional) Valor “|” hexa 0x7c
Monto cuota 12 (máximo) opcional Campo correspondiente al monto de
cuota. Depende si comercio cuenta con el
producto cuotas contratado.
Separador de campo 1 (opcional) Valor “|” hexa 0x7c
Glosa tipo cuota 30 (máximo) Campo correspondiente a la glosa del tipo
de cuota. Depende si comercio cuenta con
el producto cuotas contratado.
<ETX> 1 Indica fin de comando valor hexa 0x03
<LRC> 1 Byte resultado de la operación XOR del
mensaje
0250 - Datos Última Venta
Habilitar previamente la función de multicódigo (Previa gestión con Transbank para la habilitación de los productos)
Solicitud:
0260 – Respuesta:
Ejemplo:
Requerimiento:
<STX>0250|1<ETH><LRC>
Respuesta:
<STX>0260|00|597033311777|V1700005||389169|000005360|1679|000055|CR|||VI|2610
2018|145255| COMPROBANTE DE VENTA CON PIN TARJETA DE CREDITO
Pruebas UX100 Desa Huerfanos 770 Piso 8 Santiago
597033311777-U18.1A1 *** DUPLICADO *** FECHA HORA
TERMINAL26/10/18 14:52:55 V1700005 NUMERO DE TARJETA
B-VI************1679 TOTAL: $ 5.360NUMERO DE BOLETA:
NUMERO DE OPERACION: 000055CODIGO DE AUTORIZACION: 389169
GRACIAS POR SU COMPRA ACEPTO PAGAR SEGUN CONTRATO CON EMISOR
|00|00||<ETX><LRC>
Requerimiento:
<STX>0250|1<ETX><LRC>
Respuesta:
<STX>0260|00|597029414300|70000537|00000000000000123456|590724|000100000|0972
|000009|CR|||VI|25012016|173440| COMPROBANTE DE VENTA CON PIN
TARJETA DE CREDITO Huerfanos 770 Piso 8 Santiago
597029414300 -RS 15.13 FECHA HORA TERMINAL25/01/16 17:34:40
70000537 NUMERO DE TARJETA VIXXXXXXXXXXXX0972
TOTAL: $ 100.000NUMERO DE BOLETA: 123456NUMERO DE
OPERACION: 000009CODIGO DE AUTORIZACION: 590724 GRACIAS POR SU
COMPRA ACEPTO PAGAR SEGUN CONTRATO CON EMISOR <ETX><LRC>
Respuesta:
<STX>0271|00|597001600402|ANDRO107|123456|831679|000026001|2383|000039|CR|||AX|25112020|145
014|597001600403|**************************************** AVISO DE PREMIO
**************************************** PRUEBA TITULO LAGO
597001600403 25/11/2020 PEL3DTHMONTO
FELICITACIONES USTED SE HA GANADO XYX
H2H PEL 3 - PREMIO COMIENZA Y TERMINA CON - PEL 3 H2H XYX
EQUIVALENTES A : 1500 CODIGO DEL PREMIO 831679-00014340
ESTE VALOR SERA ABONADO EN SU ESTADO DE CUENTA SIGUIENTE O SUBSIGUIENTE
COMPROBANTE DE VENTA PAGO EN CUOTAS TARJETA DE CREDITO PRUEBA
TITULO LARGO Multicomercio Paraiso Springfield 597001600402-P20.
1V1 597001600403 FECHA HORA TERMINAL25/11/20 14:50:14 ANDRO107
NUMERO DE TARJETA C-AX***********2383 AMEX A000000025010402TOTAL:
$ 26.001NUMERO DE CUOTAS : 06TIPO DE CUOTAS : CUOTAS SIN INTERESMONTO CUOTA :
$ 4.336TASA INTERES : 0,00%NUMERO DE BOLETA: 123456NUMERO DE OPERACION:
000039CODIGO DE AUTORIZACION: 831679 GRACIAS POR SU COMPRA
ACEPTO PAGAR SEGUN CONTRATO CON EMISOR TRANSACCION PREMIADA
CODIGO DEL PREMIO :00014340 |04|06|4336|CUOTAS SIN INTERES<ETX><LRC>
Nota: Este comando es enviado desde el POS hacia la caja, siempre y cuando el parámetro en comando Venta lo indique.
El POS no espera una respuesta desde la caja, por lo tanto, no tiene reintentos de envío para este comando.
Respuesta:
<STX>0900|80<ETX><LRC>
0500 - Solicitud cierre
Nota: Para el cierre se considera una operación con los montos totales, no se discrimina por código prestador.
Ejemplo:
Requerimiento:
<STX>0500|0<ETX><LRC>
Respuesta:
<STX>0510|00|597029414300|70000537<ETX><LRC>
0800 - Solicitud carga de llaves
Ejemplo:
Requerimiento:
<STX>0800<ETX><LRC>
Respuesta:
<STX>0810|00|597029414300|70000537<ETX><LRC>
0100 - Solicitud polling
Respuesta polling
Ejemplo:
Requerimiento:
<STX>0100<ETX><LRC>
Respuesta:
<ACK>
0070 - Solicitud ejecutar inicialización
Ejemplo:
Requerimiento:
<STX>0070<ETX><LRC>
Respuesta:
<ACK>
0080 – Solicitud respuesta de Inicialización
Ejemplo:
Requerimiento:
<STX>0080<ETX><LRC>
Respuesta:
<STX>1080|90|27022016|120628<ETX><LRC>
Vouchers
Los voucher serán generados por el POS para los casos en que la caja lo indique en el comando de venta, así como tam-
bién para los duplicados y cierres.
Cada línea contendrá 40 caracteres, los que se concatenan en un solo buffer que será enviado en campo de impresión en
la respuesta transacciones de venta y cierre. La caja al recibir este buffer debe considerar que cada 40 caracteres confor-
man una línea de impresión.
En relación con el largo del Voucher, este dependerá del tipo de transacción a imprimir
Ejemplos referenciales:
Comprobante Promoción
- Ancho: 40
Rechazado 01
Autorizador no responde 02
Tarjeta no soportada 06
Transacción cancelada 07
No existe venta 11
Transacción no soportada 12
Opere tarjeta 84
Selección de cuotas 85
Ingreso de cuotas 86
Confirmación de cuotas 87
Inicialización exitosa 90
Inicialización fallida 91
Nota: Toda transacción cuyo código de respuesta, en el POS, sea distinto de “0” será considerada como un rechazo. Por
secreto bancario el detalle de la causa del rechazo no será entregado al comercio.
Tabla abreviación de tarjetas soportadas:
TARJETA ABREVIACIÓN
VISA VI
MASTERCARD MC
AMEX AX
DINERS DC
MAGNA MG
DEBITO (REDCOMPRA) DB
TARJETA ABREVIACIÓN
FALLBACK F
BANDA B
CHIP E
Venta multicomercio
Para la implementación de la venta del producto de Multicomercio se incorpora el comando 270. Para la utilización de
dicho producto se debe haber contactado previamente con el encargado de integración de Transbank para el soporte
transaccional del mismo. Si se desea realizar una venta Multicomercio se debe enviar en el comando de venta el valor del
comercio prestador con la cual se realizará la transacción. Es necesario realizar una “transacción de cierre” cada vez que
se cambie de “Prestador”, con este cierre se actualizarán los productos asociados al prestador.
Datos Transaccionales:
IP: 200.10.12.16
Puerto: 4100 *Pendiente de confirmación
Glosario
Término Definición
Gnd Tierra
Artículo Cantidad
Tuercas M4 4
Tornillos M4 4