Manual TBK - 05 - 01 - 2024

Descargar como pdf o txt
Descargar como pdf o txt
Está en la página 1de 60

Manual de Integración

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

Version Cambio Responsable Fecha

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.

Las transacciones y operaciones soportadas por la solución de autoservicio son:

• Operaciones con tarjetas banda, chip y contactless (Sin Contacto).


• Ventas débito (Redcompra).
• Ventas crédito (con posibilidad de cuotas) soportando con PIN.
• Ventas crédito sin PIN por un monto menor o igual al que establece la banca nacional como el límite
• para este tipo de transacciones.
• Reversas
• Cierre de terminal
• Carga de llaves
• Polling (mensaje de conexión entre la caja y el POS)
• Inicializaciones (descarga de parámetros y aplicativo desde Maxstore)
Especificaciones del producto
Módulos de dispositivos
Esquema del módulo de dispositivo IM30

Módulo Características técnicas

Procesador AP ARM Cortex-A53


CPU
Procesador SP ARMv7-M

Sistema operativo Linux

SDRAM LPDDR3 de 1 GB o 2 GB
Memoria
EMMC de 8 GB

Pantalla TFT a color de 5” 1280 x 720 píxeles


Monitor
pantalla táctil capacitiva

El volumen máximo de al me-


nos 80 dB a 10 cm es com-
Audio Altavoz incorporado patible con WAV, WMA, RAW
y MP3 el audio se sincroniza
con el vídeo
Bluetooth (opcional, disponible en ciertas configuraciones
de productos)

Comunicaciones inalámbricas Wi-Fi (opcional, disponible en ciertas configuraciones de


productos)

Módulo celular 4G (No disponible a la fecha)


USB tipo A (host)
USB tipo C (OTG)
2 RS232 (RJ45)
Ethernet (RJ45)
Gato auxiliar
Puertos externos
Puerto HDMI
Esclavo MDB
Maestro MDB y puerto personalizado ejecutivo (encabeza-
do de 20 pines)
E/S digital (cabezal de 6 pines)
7 a 48 VCC (E/S digital)
7 a 48 VDC (esclavo MDB)
Fuente de alimentación De 12 a 48 VCC (RS232)
19 a 30 VAC (Ejecutivo)
Ranura para tarjeta 0 a 1 ranura para tarjeta SIM micro SIM (3FF) (dependien-
SIM do de la configuración del producto)
Lector de tarjetas de banda Lectura bidireccional de triple
magnética pista
Compatible con ISO7816
Lector de tarjetas inteli-
EMV2000 L1 y L2
Lectores de tarjetas gentes
Cumple con PBOC3.0
lee las tarjetas ISO14443 Tipo
Lector de tarjetas sin
A/B lee las tarjetas Mifare lee
contacto
dispositivos NFC
Temperatura -20°C ~ 70°C
Entorno operativo
Humedad 5% ~ 95% (sin condensación)
Componentes, interfaz y puertos
Esquema del módulo de dispositivo IM30

2
9
3 10
4 11

12
5 13
6 14

15
7

1. Antena 4G (opcional) 9. Puerto USB tipo A


2. Módulo 4G y ranuras para tarjetas SAM/SIM 10. Puerto USB tipo C
3. RS232-B (host) 11. Botón de servicio
4. RS232-A (dispositivo) 12. Botón de reinicio
5. Puerto auxiliar (micrófono y altavoz) 13. LED indicador de estado
6. Puerto Ethernet 14. Puerto HDMI
7. Puerto de E/S digital 15. Puerto esclavo MDB
8. Puerto maestro ejecutivo y MDB
RS232
Es un protocolo para la comunicación en serie. Los dos puertos RJ45 del IM30, etiquetados como RS232-A y RS232-B,
utilizan este protocolo y tienen los siguientes pines:

RJ45 Pinout (RS232-A) Cash register

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.

RJ45 Pinout (RS232-B) COM

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

Pinout USB (tipo-A)


Puerto USB tipo A - USB Pinout (tipo-C)

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

2 MDB PWR GND

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.

Señal Anclar Aplicación

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.

Esta función aún no es compatible actualmente.


MDB status LED
El terminal tiene un LED de estado MDB en la parte posterior que muestra el estado en estado activo.

Descripción Estado

Estado inactivo, lista para usar Verde

Fuera de servicio Rojo

Haz tu elección y/o presenta tu tarjeta Amarillo intermitente


para pago o revalorización
Transacción en curso Amarillo

Transacción exitosa, venta en progreso o Verde intermitente


revalorización aprobada
Transacción denegada sigue la indicación Rojo intermitente
en pantalla

Power/ Digital I/O


Las señales digitales de entrada y salida se pueden utilizar para interactuar directamente con una CPU para realizar
funciones personalizadas. El IM30 tiene un puerto de I/O digital personalizado de 6 pines que se puede programar para
aceptar una variedad de entradas o emitir una señal de control específica.
Digital I/O Pinout

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 terminal cuenta con dos botones en la parte trasera. Uno


para servicio y otro para resetear el terminal.
Instalación de la tarjeta SAM/SIM
El IM30 está disponible en múltiples configuraciones que tienen un número variable de ranuras para tarjetas SAM y SIM
disponibles para su uso. La tarjeta de comunicación GPRS con el sistema de autorización será provista por Transbank.

Montajes de tarjetas SAM

Sin ranuras para tarjetas

Ranura para tarjeta SIM

Módulo 4G (destacado con


tramado azul)
Ranuras para tarjetas SIM y SAM

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.

Pantalla táctil (destacado con tramado azul)

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.

Cámara frontal (destacado con tramado azul)

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.

Cámara de escaneo de código y LED indicador de posición


(destacado con tramado azul y verde respectivamente)

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.

Lector de tarjetas de banda magnética (destacado con


tramado azul)

Lector de tarjetas de banda magnética

• Lectura de triple pista


• Lectura bidireccional
• Ranura para lector de tarjetas iluminada con un indicador LED RGB
• Ciclo de vida de más de 500k lecturas
• Cumple con ISO/IEC 7810, ISO/IEC7811 partes 1-6 e ISO 7813
• Uso del lector de tarjetas: Deslice la tarjeta a través de la ranura del lector de tarjetas de arriba a abajo o de abajo
hacia arriba con la banda magnética orientada hacia el cuerpo del dispositivo Lector de tarjetas inteligentes (delinea-
do en azul). Asegúrese de que la tarjeta esté completamente insertada en el lector de tarjetas mientras escanea la
tarjeta.
Lector de tarjetas con chip
El IM30 tiene un lector de tarjetas inteligentes magnético ubicado en la parte inferior del dispositivo.

Lector de tarjetas inteligentes (destacado con tramado


azul)

Lector de tarjetas inteligentes

• Lee tarjetas síncronas y asincrónicas de 1,8 V, 3 V y 5 V


• Ranura para lector de tarjetas iluminada con un indicador LED RGB
• Ciclo de vida de más de 500k lecturas
• Cumple con ISO/IEC 7810:2003, ISO/IEC 7816 y EMVCo L1 y L2
• Uso del lector de tarjetas: Inserte la tarjeta completamente en el lector con los contactos metálicos hacia arriba y
hacia el dispositivo. Asegúrese de que la tarjeta esté completamente insertada en el lector de tarjetas mientras esca-
nea la tarjeta.
Lector de tarjetas sin contacto
El IM30 tiene un lector de tarjetas sin contacto con una antena de RF ubicada en su cara frontal. El área de lectura para
este lector de tarjetas corresponde aproximadamente a la mitad superior de la pantalla táctil en la parte frontal del dispo-
sitivo.

Lector de tarjetas sin contacto (tarjeta sin contacto desta-


cado con tramado azul)

Lector de tarjetas sin contacto

• Soporta ISO14443 Tipo A/B


• Uso del lector de tarjetas: El lector de tarjetas sin contacto lee tarjetas y dispositivos colocados aproximadamente
paralelos al área indicada en la Figura 23:lector de tarjetas de contacto (tarjeta sin contacto delineada en azul) desde
una distancia de 0 a 4 cm. Para obtener los mejores resultados, colóquela lo más cerca posible de la pantalla y cen-
tre la tarjeta sobre el área indicada.
Detector de proximidad
El IM30 tiene un detector de proximidad óptico ubicado cerca de la parte inferior derecha de su cara frontal.

Detector de proximidad (emisor óptico en azul, receptor en


verde)

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.

Indicador de estado LED (resaltado en azul)

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.

Dimensiones del dispositivo (mm)

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

Soporte de montaje (cara orientada Dimensiones del soporte


hacia el exterior) de montaje
Dimensión de la placa de montaje
El IM30 esta diseñado para ser montado horizontal y vertical de acuerdo a las necesidades de cada comercio, sin embar-
go Transbank recomienda utilizar la posición vertical. Además para facilitar la instalación del equipo se puede utilizar una
placa de montaje según las siguientes especificaciones.

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.

Fijación del soporte de montaje a la placa de montaje

El montaje de los tornillos 4xM4 debe realizarse con un torque de fuerza


de 0,3 Nm a máx. 0,4 Nm. 0,8Nm ±0,2Nm
Instalación de la unidad IM30
Después de asegurar el soporte de montaje a la placa de montaje, inserte la unidad IM30 a través de la parte frontal de la
placa de montaje en el soporte de montaje. A continuación, aplique un par de 1,2 ± 0,2 Nm a los cuatro tornillos M4 para
asegurar el IM30 al soporte de montaje a través de sus cuatro puntos de montaje internos.

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.

Caja con Conexión USB:

Opción 1: Requiere un cable USB tipo C a tipo A.

Cable USB tipo C a tipo A

Opción 2: Requiere un cable RS232A o RS232B – Serial y conversor USB – Serial

Conversor USB Ð SERIAL Cable RS232A o RS232B Ð SERIAL


Transacciones y diagramas de secuencia
Transacción de Venta:
El comando de Venta 200 enviado por la caja solicitando la ejecución de una venta hacia el POS, como parámetro se
envía el monto, número de ticket o boleta, tipo de impresión (0=Parámetros de impresión, 1=Voucher formateado), y el
parámetro que indica si el POS envía mensajes indicando el estado de la transacción.

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.

Una vez recibida la respuesta, la caja calcu-


la el LRC (especificado más adelante en el
protocolo de comunicación) del mensaje y lo
compara con el
recibido, si coinciden la caja envía un ACK
al POS dando por finalizado el comando, en
caso contrario envía un NAK, y vuelve a
esperar la respuesta del POS.
Transacción de cierre

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.

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

Transacción de inicialización: Indica la acción


Respuesta de Inicialización: Utilizado para conocer el resultado de la acción.

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

Req. (Inicialización (P-F)) Req. Inicialización

ACK/NAK Respuesta

Req. (Inicialización (P-F))

ACK/NAK

Resultado Inicialización

ACK/NAK

Resp. Result Inicialización

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>.

Para el calcular el LRC considerar lo siguiente:

LRC de comando que se recibe de Tótem:


<DATA><ETX>

LRC de comando de respuesta hacia el Tótem:


<STX><DATA><ETX>

Ejemplo. Calcular el LRC del siguiente comando: 0200|123|<LRC>

Transforma el siguiente valor a hexadecimal “0200|123|”, este valor queda:


30 32 30 30 7C 31 32 33 7C

Se ejecuta la siguiente operación.


( ( ( ( ( ( ( (30 XOR 32) XOR 30) XOR 30) XOR 7C) XOR 31) XOR 32) XOR 33) XOR 7C)

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

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando Valor hexa 0x02

Comando 4 Valor 0200

Separador de campo 1 Valor “|” hexa 0x7c

Monto 9 Valor numérico

Separador de campo 1 Valor “|” hexa 0x7c


Número Ticket/Boleta 20 Valor alfanumérico. Se requiere enviar un
valor o en su defecto un cero “0”.
Separador de campo 1 Valor “|” hexa 0x7c

Campo Impresión 1 Indica si entrega voucher formateado


(1=Envía Voucher, 0=No envía Voucher).
Separador de campo 1 Valor “|” hexa 0x7c
Enviar Mensajes 1 Indica si el POS debe enviar mensajes de
estatus de la transacción (1=Envía Mensa-
jes, 0=No envía mensajes).
En caso de no ir este campo POS asume
valor “1”

<ETX> 1 Indica Fin de comando Valor Hexa 0x03


<LRC> 1 Byte resultado de la operación XOR del
mensaje
0210 - Respuesta transacción de venta

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando Valor hexa 0x02

Comando 4 Valor 0210

Separador de campo 1 Valor “|” hexa 0x7c

Código respuesta 2 Valor numérico

Separador de campo 1 Valor “|” hexa 0x7c


Código de comercio 12 Valor numérico
Separador de campo 1 Valor “|” hexa 0x7c

Terminal ID 8 Valor alfanumérico


Separador de campo 1 Valor “|” hexa 0x7c
Número ticket/boleta 20 Valor alfanumérico
Separador de campo 1 Valor “|” hexa 0x7c
Código autorización 6 (maxímo) Valor alfanumérico, (Opcional)
Separador de campo 1 Valor “|” hexa 0x7c
Monto 9 (Máximo) Valor numérico
Separador de campo 1 Valor “|” hexa 0x7c
Últimos 4 dígitos tarjeta 4 Valor numérico
Separador de campo 1 Valor “|” hexa 0x7c
Número operación 6 (Máximo) Correlativo de transacción del terminal
Separador de campo 1 Valor “|” hexa 0x7c
Tipo de tarjeta (crédito/debito) 2 CR=crédito
DB=debito
Separador de campo 1 Valor “|” hexa 0x7c
Fecha contable 6 Valor ASCII. Se utiliza si es tarjeta debito, (opcional)
Separador de campo 1 Valor “|” hexa 0x7c
Número de cuenta 19 Valor ASCII. Se utiliza si es tarjeta debito
Separador de campo 1 Valor “|” hexa 0x7c
Abreviación tarjeta 2 Ejemplo: VI=VISA MC=Mastercard Etc…
Separador de campo 1 Valor “|” hexa 0x7c
Fecha transacción 8 Formato DDMMAAAA
Separador de campo 1 Valor “|” hexa 0x7c
Hora transacción 6 Formato HHMMSS
Separador de campo 1 (opcional) Valor “|” hexa 0x7c
Campo impresión Variable (opcional) Campo depende si la caja requiere voucher formateado
Separador de campo 1 (opcional) Valor “|” hexa 0x7c
Ejemplos:
Venta con cuotas

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>

Venta sin cuotas

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

0270 - Solicitud de venta


Habilitar previamente la función de multicódigo (Previa gestión con Transbank para la habilitación de los productos)

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando valor hexa 0x02

Comando 4 Valor 0270

Separador de campo 1 Valor “|” hexa 0x7c

Monto 9 Valor numérico

Separador de campo 1 Valor “|” hexa 0x7c


Número ticket/boleta 20 Valor alfanumérico.
Separador de campo 1 Valor “|” hexa 0x7c

Campo impresión 1 Indica si entrega voucher formateado


(1=Envía voucher, 0=No envía voucher).
Separador de campo 1 Valor “|” Hexa 0x7c
Enviar mensajes 1 Indica si el POS debe enviar mensajes de
estatus de la transacción (1=Envía Mensa-
jes, 0=No envía mensajes).
En caso de no ir este campo POS asume
valor “1”

Separador de campo 1 Valor “|” hexa 0x7c


Comercio prestador 12 Valor que indica el código de comercio del
prestador.
<ETX> 1 Indica fin de comando valor hexa 0x03
<LRC> 1 Byte resultado de la operación XOR del
mensaje

Requerimiento:
<STX>0270|25000|123456|1|0|597001600402<ETX><LRC>
0271 – Respuesta Solicitud de venta

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando Valor Hexa 0x02

Comando 4 Valor 0271

Separador de campo 1 Valor “|” hexa 0x7c

Código respuesta 2 Valor numérico

Separador de campo 1 Valor “|” hexa 0x7c


Código de comercio 12 Valor numérico
Separador de campo 1 Valor “|” hexa 0x7c

Terminal ID 8 Valor alfanumérico


Separador de campo 1 Valor “|” hexa 0x7c
Número Ticket/Boleta 20 Valor alfanumérico
Separador de campo 1 Valor “|” hexa 0x7c
Monto 9 (Máximo) Valor numérico
Separador de campo 1 Valor “|” hexa 0x7c
Últimos 4 Dígitos Tarjeta 4 Valor numérico
Separador de campo 1 Valor “|” Hexa 0x7c
Número Operación 6 (Máximo) Correlativo de transacción del terminal
Separador de campo 1 Valor “|” Hexa 0x7c
Tipo de Tarjeta (Crédito/De- 2 CR=crédito
bito) DB=debito
Separador de campo 1 Valor “|” hexa 0x7c
Fecha Contable 6 Valor ASCII. Se utiliza si es tarjeta débito,
(Opcional)
Separador de campo 1 Valor “|” hexa 0x7c
Número de Cuenta 19 Valor ASCII. Se utiliza si es tarjeta débito
Separador de campo 1 Valor “|” hexa 0x7c
Abreviación Tarjeta 2 Ver tabla de abreviación de tarjetas
Separador de campo 1 Valor “|” hexa 0x7c
Fecha transacción 8 Formato DDMMAAAA
Separador de campo 1 Valor “|” hexa 0x7c
Hora tansacción 6 Formato HHMMSS
Separador de campo 1 Valor “|” hexa 0x7c
Comercio prestador 12 Valor que indica el código de comercio del
prestador.
Separador de campo 1 Valor “|” hexa 0x7c
Campo impresión Variable (opcional) Campo depende si la caja requiere vou-
cher formateado
Separador de campo 1 Valor “|” hexa 0x7c
Tipo cuota 2 (opcional) Campo correspondiente al tipo de cuota.
Depende si comercio cuenta con el pro-
ducto Cuotas contratado.

Valores:
00 = sin cuota (valor por default)
01 = cuota normal
03 = cuota contado
04 = n cuotas

Separador de campo 1 (opcional) Valor “|” hexa 0x7c


Número cuota 2 (opcional) Campo correspondiente al número de
cuota. Depende si comercio cuenta con el
producto Cuotas contratado.
Valores:

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:

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando


Valor Hexa 0x02
Comando 4 Valor 0250

Separador de campo 1 Valor “|” Hexa 0x7c

Campo Impresión 1 Indica si entrega voucher


formateado
<ETX> 1 Indica Fin de comando Valor
Hexa 0x03
<LRC> 1 Byte resultado de la
operación XOR del mensaje

0260 – Respuesta:

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando Valor Hexa 0x02

Comando 4 Valor 0260

Separador de campo 1 Valor “|” Hexa 0x7c

Código Respuesta 2 Valor Numérico

Separador de campo 1 Valor “|” Hexa 0x7c


Código de comercio 12 Valor Numérico
Separador de campo 1 Valor “|” Hexa 0x7c

Terminal ID 8 Valor Alfanumérico


Separador de campo 1 Valor “|” Hexa 0x7c
Número Ticket/Boleta 20 Valor alfanumérico. Se
requiere enviar un valor o en
su defecto un cero “0”.
Separador de campo 1 Valor “|” Hexa 0x7c
Código Autorización 6 (Máximo) Valor Alfanumérico
Separador de campo 1 Valor “|” Hexa 0x7c
Monto 9 (Máximo) Valor Numérico
Separador de campo 1 Valor “|” Hexa 0x7c
Últimos 4 Dígitos Tarjeta 4 Valor Numérico
Separador de campo 1 Valor “|” Hexa 0x7c
Número Operación 6 (Máximo) Correlativo de Transacción
del Terminal
Separador de campo 1 Valor “|” Hexa 0x7c
Tipo de Tarjeta 2 CR=Crédito
(Crédito/Débito) DB=Debito
Separador de campo 1 Valor “|” Hexa 0x7c
Fecha Contable 6 Valor ASCII. Se utiliza si es
tarjeta Debito
Separador de campo 1 Valor “|” Hexa 0x7c
Número de Cuenta 19 Valor ASCII. Se utiliza si es
tarjeta Debito
Separador de campo 1 Valor “|” Hexa 0x7c
Abreviación Tarjeta 2 Ejemplo: VI=VISA
MC=Mastercard
Etc…
Separador de campo 1 Valor “|” Hexa 0x7c
Fecha Transacción 8 Formato DDMMAAAA
Separador de campo 1 Valor “|” Hexa 0x7c
Hora Transacción 6 Formato HHMMSS
Separador de campo 1 (opcional) Valor “|” Hexa 0x7c
Campo Impresión Variable (Opcional) Campo depende si la caja
requiere voucher
formateado
Separador de campo 1 (opcional) Valor “|” Hexa 0x7c
Tipo cuota 2 (opcional) Campo correspondiente al
tipo de cuota. Depende si
comercio cuenta con el
producto Cuotas contratado.
Valores:
00 = sin cuota (valor por
default)
01 = cuota normal
03 = cuota contada
04 = n cuotas
Separador de campo 1 (opcional)
Separador de campo 1 (opcional) Valor “|” Hexa 0x7c
Número cuota 2 (opcional) Campo correspondiente al
número de cuota. Depende si
comercio cuenta con el
producto Cuotas contratado.
Valores:
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

Ejemplo:

Ultima Venta con Cuotas

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>

Ultima Venta sin Cuotas

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>

0900 - Solicitud mensajes intermedios desde el POS para una venta:

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando valor hexa 0x02

Comando 4 Valor 0900

Separador de campo 1 Valor “|” hexa 0x7c

Código respuesta 2 Valor numérico (ver tabla 1)

<ETX> 1 Indica fin de comando valor hexa 0x03


<LRC> 20 Byte resultado de la operación XOR del
mensaje

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

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando valor hexa 0x02

Comando 4 Valor 0500

Separador de campo 1 Valor “|” hexa 0x7c

Campo impresión 1 Indica si entrega voucher formateado

<ETX> 1 Indica fin de comando valor hexa 0x03


<LRC> 1 Byte resultado de la operación XOR del
mensaje

0510 - Respuesta cierre

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando valor hexa 0x02

Comando 4 Valor 0510

Separador de campo 1 Valor “|” hexa 0x7c

Código respuesta 2 Valor numérico

Separador de campo 1 Valor “|” hexa 0x7c


Código de comercio 12 Valor numérico
Separador de campo 1 Valor “|” hexa 0x7c
Terminal ID 8 Valor alfanumérico
Separador de campo 1 (opcional) Valor “|” Hexa 0x7c
Campo impresión Variable (opcional) Campo depende si la caja requiere vou-
cher formateado
<ETX> 1 Indica fin de comando valor hexa 0x03
<LRC> 1 Byte resultado de la operación XOR del
mensaje

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

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando Valor Hexa 0x02

Comando 4 Valor 0800

<ETX> 1 Indica Fin de comando Valor Hexa 0x03

<LRC> 1 Byte resultado de la operación XOR del


mensaje

0810 - Respuesta carga de llaves

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando Valor Hexa 0x02

Comando 4 Valor 0810

Separador de campo 1 Valor “|” Hexa 0x7c

Código Respuesta 2 Valor Numérico

Separador de campo 1 Valor “|” Hexa 0x7c

Código de comercio 12 Valor Numérico

Separador de campo 1 Valor “|” Hexa 0x7c

Terminal ID 8 Valor Alfanumérico

<ETX> 1 Indica Fin de comando Valor Hexa 0x03

<LRC> 1 Byte resultado de la operación XOR del


mensaje

Ejemplo:
Requerimiento:
<STX>0800<ETX><LRC>
Respuesta:
<STX>0810|00|597029414300|70000537<ETX><LRC>
0100 - Solicitud polling

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando valor hexa 0x02

Comando 4 Valor 0100

Separador de campo 1 Valor “|” hexa 0x7c

Campo impresión 1 Indica si entrega voucher formateado

<ETX> 1 Indica fin de comando valor hexa 0x03


<LRC> 1 Byte resultado de la operación XOR del
mensaje

Respuesta polling

DATO LARGO COMENTARIO

<ACK> 1 Comando recibido OK


Valor hexa 0x06

Ejemplo:
Requerimiento:
<STX>0100<ETX><LRC>
Respuesta:
<ACK>
0070 - Solicitud ejecutar inicialización

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando valor hexa 0x02

Comando 4 Valor 0070

<ETX> 1 Indica fin de comando valor hexa 0x03

<LRC> 1 Byte resultado de la operación XOR del


mensaje

Respuesta ejecutar inicialización

DATO LARGO COMENTARIO

<ACK> 1 Comando recibido OK


Valor hexa 0x06

Ejemplo:
Requerimiento:
<STX>0070<ETX><LRC>
Respuesta:
<ACK>
0080 – Solicitud respuesta de Inicialización

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando valor hexa 0x02

Comando 4 Valor 0080

<ETX> 1 Indica fin de comando valor hexa 0x03

<LRC> 1 Byte resultado de la operación XOR del


mensaje

1080 - Respuesta de inicialización

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando valor hexa 0x02

Comando 4 Valor 1080

Separador de campo 1 Valor “|” hexa 0x7c

Código respuesta 2 Valor numérico

Separador de campo 1 Valor “|” hexa 0x7c

Fecha transacción 8 Formato DDMMAAAA

Separador de campo 1 Valor “|” hexa 0x7c

Hora transacción 6 Formato HHMMSS

<ETX> 1 Indica fin de comando valor hexa 0x03

<LRC> 1 Byte resultado de la operación XOR del


mensaje

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:

Transacción venta débito (redcompra) Transacción venta crédito sin cuotas

Cantidad de caracteres máximos permitidos:


- Ancho: 40
- Largo: 19
Transacción venta crédito cuota normal Duplicado última venta crédito

Cantidad de caracteres máximos permitidos:


- Ancho: 40
- Largo: 19

Transacción venta crédito 2CSI Transacción venta crédito 3CSI

Cantidad de caracteres máximos permitidos:


- Ancho: 40
- Largo: 24
Reporte de cierre del terminal Transacción Venta en Promoción

Cantidad de caracteres máximos permitidos: Cantidad de caracteres máximos permitidos:


- Ancho: 40 - Ancho: 40
- Largo: 18 - Largo: 29

Comprobante Promoción

Cantidad de caracteres máximos permitidos:


- Ancho: 40 - Largo: 36 (no considera voucher de venta)
permitidos:

- Ancho: 40

- Largo: 36 (no considera voucher de venta)


Códigos de respuesta
Aprobado 00

Rechazado 01

Autorizador no responde 02

No existe transacción para anular 05

Tarjeta no soportada 06

Transacción cancelada 07

Error lectura tarjeta 09

Monto menor al mínimo permitido 10

No existe venta 11

Transacción no soportada 12

Modo Multicomercio no activo 78

Modo Venta Normal no Activo 79

Solicitando ingreso de clave 81

Enviando transacción al autorizador 82

Selección menú crédito/Redcompra 83

Opere tarjeta 84

Selección de cuotas 85

Ingreso de cuotas 86

Aceptar consulta cuotas 88

Confirmación de cuotas 87

Inicialización exitosa 90

Inicialización fallida 91

Consultando cuota al autorizador 93

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

Tabla abreviación procesamiento de tarjetas:

TARJETA ABREVIACIÓN

FALLBACK F

BANDA B

CHIP E

CTLS (SIN CONTACTO) C


Ejemplo

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.

Para cambiar de “prestador” (Multicódigo) el flujo sería el siguiente:


Datos de Comunicación:
Para las pruebas de implementación se cuenta con las siguientes IP´s y Puertos:

Datos Transaccionales:
IP: 200.10.12.16
Puerto: 4100 *Pendiente de confirmación

Datos Para Inicialización:


https://rest.digitalizacion.qa.transbank.cl:12048/p-market-api/v1/ (por confirmar)

Glosario
Término Definición

LCD Pantalla de cristal líquido

MDB Bus Multidrop

USB Bus serie universal

RS232 Estándar recomendado 232

Ram Memoria de acceso aleatorio

CPU Unidad Central de Procesamiento

Gnd Tierra

Contenido del producto

Artículo Cantidad

Terminal de pago desatendida IM30 1

Soporte de montaje IM30 1

Tuercas M4 4

Tornillos M4 4

Guía de configuración rápida de IM30 1


www.transbankdevelopers.cl

También podría gustarte