Manual 1

Manual de comandos
Pinpad Host Wifi

TRANSBANK – Comercio
Versión Manual 2.4

(Julio 2019)
PINPAD VERIFONE VX680
VERSIÓN 18.2
Transbank S.A. Manual de comandos pinpad Host ver. 18.2 - WIFI
CONTENIDOS
CONTROL DE VERSIONES ........................................................................................ 4

1 INTRODUCCIÓN................................................................................................. 5
1.1 OBJETIVOS. .................................................................................................... 5
1.2 AUDIENCIA ..................................................................................................... 5
2 PROTOCOLO DE MENSAJERÍA SEGÚN TIPO DE COMUNICACIÓN ........................ 6
2.1 SEGURIDAD TLS 1.2......................................................................................... 6
2.2 SEGURIDAD EN LA RED WI-FI DEL COMERCIO ........................................................... 6
2.3 ARCHIVOS IMPLEMENTACIÓN TLS .......................................................................... 7
2.4 PROTOCOLO DE COMUNICACIÓN TCP/IP .................................................................. 8
2.5 DIAGRAMA GENÉRICO DE SECUENCIA DE COMANDOS .................................................. 10
2.6 FLUJO DE VENTA DETALLADO .............................................................................. 12
2.7 FLUJO EJECUCIÓN DE REVERSA A SOLICITUD DE LA CAJA .............................................. 15
2.8 DIAGRAMA INICIALIZACIÓN Y CONEXIÓN AL PINPAD ................................................. 16
2.9 FLUJO DE EJECUCIÓN DE COMANDOS AL PINPAD ...................................................... 17
2.10 MANEJO DE CONTEXTO ..................................................................................... 18
3 DESCRIPCIÓN DE COMANDOS ......................................................................... 19
3.1 COMANDO VENTAS .......................................................................................... 19
3.1.1 0100 - Comando Lectura de tarjeta ........................................................... 19
3.1.2 0200 - Comando Requerimiento de venta/anulación .................................... 19
3.1.3 0400 - Comando Requerimiento de reversa ................................................ 19
3.1.4 0500 - Comando Requerimiento de validación/actualización ......................... 19
3.1.5 0520 - Comando Requerimiento de validación respuesta de transacción ......... 19
3.1.6 0560 - Comando Requerimiento de validación respuesta de transacción ......... 24
3.2 COMANDO CIERRE BATCH .................................................................................. 31
3.2.1 0600 - Solicitud comando Cierre batch ....................................................... 31
3.2.2 0700 - Validación comando Cierre batch .................................................... 31
3.3 1100 - COMANDO DESPLIEGUE MENSAJE................................................................ 31
3.4 CONN - COMANDO CONEXIÓN PINPAD – CAJA ...................................................... 32
3.5 ECHO - COMANDO ECHO CAJA – PINPAD ............................................................. 33
3.6 ISES - COMANDO INICIO DE SESIÓN CAJA- PINPAD ................................................ 34
3.7 FSES - COMANDO FIN DE SESIÓN CAJA – PINPAD .................................................. 35
3.8 COMANDO IMPRESIÓN VOUCHER ......................................................................... 36
3.8.1 VOUC - Comando Solicitud Impresión Voucher Caja – PINPAD ...................... 36
3.8.2 REIM - Comando Solicitud Reimpresión Último Voucher PINPAD – Caja .......... 37
3.9 REST - COMANDO RESET SOCKET CAJA – PINPAD .................................................. 38
3.10 LKEY - COMANDO CARGA DE LLAVE PINPAD – CAJA ................................................ 39
3.11 0000 - COMANDO TEST PINPAD – CAJA ............................................................. 40
3.12 CLSB - COMANDO CIERRE BATCH PINPAD – CAJA .................................................. 41
4 ANEXOS ........................................................................................................... 42
4.1 TABLA DE MARCAS .......................................................................................... 42
4.2 TABLA DE TIPO DE TARJETA ................................................................................ 42
4.3 TABLA DE CÓDIGOS DE RESPUESTA DE COMANDOS ..................................................... 42
4.4 TABLA DE CÓDIGOS DE MENSAJES DE DESPLIEGUE EN PINPAD ...................................... 43
Junio 2019 Confidencial Página 2 de 43

CONFIDENCIALIDAD
La información contenida en este documento es

propiedad de Transbank y sólo puede ser utilizada por
quienes Transbank autorice expresamente y para los
fines que aquí se describen.

Control de versiones
NÚMERO FECHA AUTOR DESCRIPCIÓN DE CAMBIOS

DE
VERSIÓN
1.0 29/04/2013 Sebastián  Versión inicial.
González V.
1.1 30/08/2013 Sebastián  Se modifica nombre de comandos WIFI: CONN,
González V. ECHO, ISES, FSES, VOUC, REIM, REST, LKEY.
1.2 10/09/2013 Sebastián  Se agrega la opción ‘MP’ en tabla 3.14 Tabla Tipo
González V. Tarjeta, con la finalidad de que el PINPAD
despliegue el menú de elección de tipo de
tarjeta.
 Se completa información en el comando ‘Carga
de llaves PINPAD (LKEY)’.
1.3 16/09/2013 Sebastián  En “Tabla Tipo Tarjeta”, donde dice ‘MP’ se
González V. reemplaza por ‘Null (Vacío)’.
 Se agrega comando TEST ‘0000’.
 Se agrega comentario en comando ‘LKEY’
1.4 07/10/2013 Sebastián  En el comando ‘REIM’ se agrega especificación
González V. para activar el comando con [ENTER] + [5]
1.5 06/12/2013 Rodrigo  Se incorpora el comando 0520/0530 para la
León validación de la respuesta de la transacción
1.6 17/02/2014 Rodrigo  Se incorpora el comando 1100/1110 para el
León despliegue de mensajes en el PINPAD junto con
la tabla de códigos y mensajes permitidos.
 Se incorpora el comando CLSB para gatillar una
solicitud de cierre batch desde la caja.
1.7 17/08/2015 Elias  Se igual el comando 530 incorporando todos los
Brehme comandos del 510
 Se agrega nuevo valor en la tabla de mensajes a
desplegar con comando 1100.
1.8 01/01/2017 Elias  Mejora en descripción de campos
Brehme
1.9 14/08/2018 Christian  Se incorpora información de manejo de
Cobo excepción. En caso de algún problema con el
comando se debe abortar la transacción y
reversar (comando 400)
2.0 06/12/2018 Christian  Se incorpora el nuevo comando 560/570
Cobo
2.1 13/12/2018 Christian  Se realiza una revisión del documento.
Cobo
2.2 19/03/2018 Christian  Se incorpora recomendaciones de seguridad TLS
Cobo e información sobre los archivos necesarios para
TLS. (Pág. 6 y 7)
2.3 05/06/2019 Christian  Se incorpora información más detallada de cómo
Cobo implementar TLS. (Pág.7 y 8)
2.4 04/07/2019 Rafael Vivas  Se corrige el ejemplo del flujo de reversa
solicitada desde caja. pág. 17.

1 Introducción
1.1 Objetivos.
Este documento describe la forma de operar, la funcionalidad y el detalle de la mensajería

de un PINPAD TRANSBANK mediante protocolo TCP/IP.
La aplicación del PINPAD, supone la existencia de un ECR inteligente (por ejemplo una caja
registradora) que enviará los requerimientos al PINPAD, para que este los procese y
entregue los resultados cuando corresponda.
1.2 Audiencia
Para entender completamente este documento es necesario tener conocimientos

transaccionales y conocer las funciones implementadas habitualmente en los PINPAD usados
en las transacciones bancarias.

2 Protocolo de mensajería según tipo de comunicación
2.1 Seguridad TLS 1.2
SSL (Secure Sockets Layer) o Capa de Conexiones Seguras. Es un protocolo que hace uso de certificados
digitales para establecer comunicaciones seguras a través de red. Desde el 2015 ha sido sustituido por
TLS (Transport Layer Security) el cual está basado en SSL y son totalmente compatibles.
2.2 Seguridad en la Red WI-FI del Comercio
En el caso de que la red del Comercio requiera usar conexiones por WI-FI se exige que la red sea una red
cifrada *WPA2-PSK (AES).
Recomendaciones se seguridad para una red WI-FI:
1) Cambiar regularmente la contraseña de red WI-FI

Al cambiar regularmente la contraseña de red WI-FI evita que terceras personas puedan
hacer uso de la red del comercio.
2) Configurar la red WI-FI como “No visible”

Al ocultar la red WI-FI se evita que personas externas al comercio puedan encontrar e
intentar acceder a la red del comercio.
Ahora cada vez que se intente conectar un nuevo dispositivo, será necesario colocar
primero la *SSID, para posteriormente ingresar la contraseña
3) Registrar y restringir las conexiones por MAC

Al tener habilitadas las conexiones por MAC, se especifica que equipos pueden hacer
uso de la red WI-FI, evitando que cualquier otro equipo haga uso de la red del comercio.
4) Restringir el acceso a la “Configuración del Router” desde WI-FI

Al restringir el acceso a la configuración del Router desde conexiones WI-FI se evita que
desde dispositivos WIFI se pueda acceder a esta configuración y se modifiquen sus
parámetros.
5) Monitorear regularmente las conexiones WI-FI

Los Router actuales permiten conocer los dispositivos que están conectados a la red WI-
FI. Es recomendable monitorear para poder evitar algún dispositivo que esté conectado
sin autorización.
*WPA2-PSK (AES): Sistema de protección para redes inalámbricas WI-FI. Es el último estándar de encriptación WI-FI y AES es el
más reciente algoritmo de cifrado.
*SSID: Difusión de un SSID de red. Un SSID es el nombre público de una red de área local inalámbrica (WLAN) que sirve para
diferenciarla de otras redes inalámbricas en la zona. SSID es el nombre de la red que se especifica al configurar la red WI-Fi.

2.3 Archivos implementación TLS
La implementación de TLS realizada es la de autenticación mutua two-way, es decir el PinPad valida a la

caja y a la inversa.
Para implementar TLS entre el Pinpad vx680 y la caja del comercio se requieren de los siguientes
archivos:
Certificados TLS del Pinpad:
1.- Certificado cliente:

"client.PEM”: Certificado con el que se presenta al Servidor.
2.- Llave de validación del certificado de cliente:

"client.key”: Necesario para validar que el certificado cargado es el que corresponde.
3.- Certificado para validar el servidor:

"CA.PEM”: Para validar el certificado del Servidor.
Certificados TLS del Servidor (Caja del Comercio):
1.- Certificado servidor:

"server.PEM”: Certificado con el que se presenta al cliente.
2.- Llave de validación del certificado de servidor:

"server.key": Llave privada usada para firmar.
3.- Certificado para validar el cliente:

"CAClient.PEM": Para validar el certificado del cliente.

2.4 Implementación TLS
Se debe cifrar el canal de comunicación con la versión más reciente del protocolo de
comunicación TLS.
Se debe usar la autenticación doble (Two-way TLS) para darle mayor seguridad a proceso.
La siguiente figura muestra el protocolo de enlace TLS utilizando un almacén de confianza.
El cliente tiene la CA del certificado del servidor en su almacén de confianza.

Durante el protocolo de enlace TLS, el cliente compara la CA certificado en su almacén de confianza con
el envío del certificado desde el servidor para verificar la identidad del servidor.
El servidor tiene la CA del certificado del cliente en su almacén de confianza.

Durante el protocolo de enlace TLS, el servidor compara la CA en su almacén de confianza con el envío
del certificado del cliente para verificar la identidad del cliente.

Dependiendo del lenguaje o plataforma, se debe especificar la ubicación de los “Almacenes de

Certificados” (KeyStore y TrustStore).
Dependiendo del lenguaje o plataforma se crea un KeyStore para el certificado y la llave privada del
Servidor y un TrustStore para el “Certificado CA” del Pinpad.
//Especificamos el KeyStore que contiene el certificado del Servidor y la llave privada

KeyStore keyStore = KeyStore.getInstance("JKS");
keyStore.load(new FileInputStream("server/serverKeyStore.jks"),"servpass".toCharArray());
KeyManagerFactory kmf = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());

kmf.init(keyStore, "servpass".toCharArray());
//Especificamos el TrustStore que contiene el Certificado CA del cliente

KeyStore trustedStore = KeyStore.getInstance("JKS");
trustedStore.load(new FileInputStream("server/serverTrustedCerts.jks"),"servpass".toCharArray());
TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());

tmf.init(trustedStore);
//Creamos la instancia TLS

SSLContext sc = SSLContext.getInstance("TLSv1.2");
TrustManager[] trustManagers = tmf.getTrustManagers();
KeyManager[] keyManagers = kmf.getKeyManagers();
sc.init(keyManagers, trustManagers, null);
//se crea el socket que se usara para la comunicación

SSLServerSocketFactory ssf = sc.getServerSocketFactory();
serverSocket = (SSLServerSocket) ssf.createServerSocket(port);
try {
//Esperamos que el PINPAD se conecte
Socket aClient = serverSocket.accept();
System.out.println("client accepted");
aClient.setSoLinger(true, 1000);
aClient.setSoTimeout(10 * 1000);
//Leemos lo enviado desde el PINPAD

BufferedReader input = new BufferedReader(new InputStreamReader(aClient.getInputStream()));
String recibido = input.readLine();
System.out.println("Recibido " + recibido);
//Enviamos ACK al Pinpad

PrintWriter output = new PrintWriter(aClient.getOutputStream());
output.println("0004ACK ");
output.flush();
//Enviamos Comando al Pinpad

output.println("0025CONN|00|01|Texto línea 1|");
output.flush();
} catch (Exception e) {
e.printStackTrace();
}
Ejemplo de cómo indicar los certificados de los socket SSL en JAVA

2.5 Protocolo de comunicación TCP/IP
Este protocolo permite la comunicación entre un ECR (Electronic Cash Register) y un

PINPAD a través de una red que soporte el protocolo TCP/IP. Es importante tener en
consideración el control de errores sobre las funciones de TCP/IP para asegurar que cada
uno de los mensajes llegue al destinatario y hacer gestión sobre los reintentos cuando sea
necesario. El siguiente diagrama ejemplifica la construcción de los comandos en el protocolo
TCP/IP.
Donde:
 LARGO_DATA: 4 bytes indicando el largo del mensaje, sin incluir estos 4 bytes.
 DATA: Es el mensaje que se quiere enviar.
2.6 Diagrama genérico de secuencia de comandos
El diagrama que se describe corresponde a la generalización del comportamiento de cada

uno de los comandos.
Figura 2 – Secuencia de comandos Caja a PINPAD

Figura 3 – Secuencia de comandos PINPAD a Caja

2.7 Flujo de venta detallado
Figura 4 – Secuencia detallada de comandos de una venta/anulación

Comando Comando
0100 0110
Inicio
Comando 200 Comando 210
Requerimiento Respuesta
SPDH SPDH
NO
Comando Comando La respuesta
0500 0510 esta correcta?
NO
Flag Terminal
SI Reversa
(Comando
0400)
SI
Imprimir SI Aprobado? NO Desplegar Continua con el flujo

Voucher Mensaje de ejecución de
reversa a solicitud de
caja
Diagrama de flujo detallado de comandos de una venta
Ejemplo de venta:
0100|00|N|N|N|12100|CL|CR||0|0|
0110|00|2017111611350940|01|||||5197||MASTERCARD|MC|N| 4
0200|12100|0||0|0|2017111611350940|00|597044440001|S4HOST2HOST3DES1||||17111611361100
000000000754||0123456789ABCDEF|||||5197| v
0210|00|2017111611350940|0737|9.12S4HOST2HOST3DES1
171116113517FO00050000B000000000000012100P1Q0123456789ABCDEFa000000000000000000000000
00NU1711161136110000000000075400000000000000000CL0000000d597044440001e00h0010050081G3
F3308F4S0t74 0000000000000000326-478-322 15.30C
6-E051-I152-O0180152171116B8738FEAC1697887380000669B8C9262000000800000152000000012100
0000000000000014A78003040000716800000000000000FF-P0100224403020002
E0F8C826478322RA00000000410109-A1EL20212223242526272829VI0 6MC0 67DC0
6AX012345OTTP06TR01TE0 TM0 TC12TD12TJ12TH12T812T90
-B41205240-C2100-P000000000000-I0-J0-K000W0161111005CR 0000-
4F552D8E65F6056E543A481CDD07D2525E2D7347C32D2CA5756F176482684949FD0443BCB1235018CC0CD
DC7C0EA41BF| (
0500|2017111611350940|513|9.12S4HOST2HOST3DES1

171116113521FO00000005B000000000000012100D4EF600979
BGA1B5296BH0D9C83C5A59B574F7AF35145C606D5D4ID5879B9816C5A304236AB90B081A60A0P1Q012345
6789ABCDEFS0
T0000000000W0161111005CRCMC0000a00000000000003000000000000NU1711161136110000000000075
400000000000000000CL0000000d597044440001e00g
APROBADOh0010050081ptS4HOST2HOST3DES16-E051-I1529-A1EL20212223242526272829VI0 6MC0
67DC0 6AX012345OTTP06TR01TE0 TM0 TC12TD12TJ12TH12T812T90
-B11205243-C0000-P100000800000|
0510|00|2017111611350940|597044440001|S4HOST2HOST3DES1|0 |0000|600979
B|12100||00||5197|001005008|CREDITO||************5197|MC|171116|113521||||||||1|1|1|1
|0|05|CR|0|0|0000|SIN CUOTAS|||||||0000|||0000|||0000|||005|
APROBADO|N||0|1||001005008|Y|||
NOTA: Si por algún motivo el pinpad responde un comando en un formato que no

corresponde (tipo de dato erróneo, largo incorrecto, separador incorrecto o faltante,
etcétera) la caja debe solicitar reversa según el “flujo de ejecución de reversa a
solicitud de la caja” detallado a continuación. Posteriormente se debe iniciar un
nuevo flujo de venta.

2.8 Flujo ejecución de reversa a solicitud de la caja
La caja no tuvo respuesta de algún comando o no tuvo respuesta de un mensaje SPDH en

vuelo, por lo tanto no pudo terminar una venta que inicio, luego no sabe si está aprobada o
rechazada, en este caso debe solicitar una reversa al pinpad.
Reversa solicitada por la caja
Ejemplo de reversa:
0400|2019062813081650|
0410|00|2019062813081650|0643|9.07S4CAJAHOST000010
190628130853FT00000000B000000000000650000P1Q0123456789ABCDEFa000000150000000000000000
00NU2019062813091100100100000100000000000000000CL0000000d597044440001e00h0010030051G3
F27A500S0t74 0000000000000000326-018-973 18.21P
6-E071-I152-O0180152190628236E485C1DC23FC81980067116EE3A5C000000800000152000000650000
0000000000000110A04001220000000000000000000000FF-P0101221F03020002
00080826018973A00000000410109-A1EL20252627 VI123456MC123456DC
AX123456OTTP06TR1 TE0 TM0 TC12TD12TJ12TH12T812T90
-B41205240-C2100-P000000000000-I0-J1-K000-M1W0161111005CR 0000|
0500|2019062813081650|643|9.07S4CAJAHOST000010
190628130853FT00000000B000000000000650000P1Q0123456789ABCDEFa000000150000000000000000
00NU2019062813091100100100000100000000000000000CL0000000d597044440001e00h0010030051G3
F27A500S0t74 0000000000000000326-018-973 18.21P
6-E071-I152-O0180152190628236E485C1DC23FC81980067116EE3A5C000000800000152000000650000
0000000000000110A04001220000000000000000000000FF-P0101221F03020002
00080826018973A00000000410109-A1EL20252627 VI123456MC123456DC

AX123456OTTP06TR1 TE0 TM0 TC12TD12TJ12TH12T812T90

-B41205240-C2100-P000000000000-I0-J1-K000-M1W0161111005CR 0000|
0510|00|2019062813081650|597044440001|S4CAJAHOST000010|||265404
B|650000||00||0003|001003005|CREDITO||************0003|
|190628|130853||||||||1|1|1|1|0|05|CR|0|0|0000|SIN
CUOTAS|||||||0000|||0000|||0000|||000|REVERSA APLICADA|N||0|1||001003005|Y|||
2.9 Diagrama Inicialización y conexión al PINPAD
Inicialización y Conexión Pinpad
inicio
Inicializando
Inicializando EMV
Contacless
Inicializando WiFi No
Inicialización
OK
No
No No
Espera Evento
Tecla
Reiniciar Pinpad
Si Tecla ENTER Menú Cambios

Ingreso RUT y Ingreso Ok Si Si
+8 Administración Configuración
Clave Técnico
Si
Envía Comando
No
CONN
Conect OK No
No
No
Reiniciar Pinpad
Espera Evento
Tecla
Tecla ENTER Menú Cambios

Ingreso RUT y Ingreso Ok Si Si
+8 Administración Configuración
Si Clave Técnico
Si
Espera Comandos
Figura 5 – Diagrama inicialización y conexión.

2.10 Flujo de ejecución de comandos al PINPAD
Figura 6 – Flujo comandos al pnipad.

2.11 Manejo de contexto
Figura 7 – Manejo de contexto

3 Descripción de comandos
3.1 Comando ventas
3.1.1 0100 - Comando Lectura de tarjeta
Igual al Retail estándar vx805 versión 4.0
3.1.2 0200 - Comando Requerimiento de venta/anulación
3.1.3 0400 - Comando Requerimiento de reversa
3.1.4 0500 - Comando Requerimiento de validación/actualización
3.1.5 0520 - Comando Requerimiento de validación respuesta de transacción1
Este comando es un homologo al 500, donde caja entrega el mensaje spdh al pinpad, pero
el pinpad cuando la transacción está aprobada oculta el mensaje en pantalla, si la
transacción es rechazada se comporta igual al comando 510.
Al finalizar la transacción caja debe enviar comando 1100 al pinpad con el mensaje que se
requiere desplegar en pantalla (Aprobado).
REQUERIMIENTO
DATO LARGO COMENTARIO VALOR
POR
DEFECTO
LARGO_DATA 4 Valor numérico
(0000 -> 9999)
Indicando el largo del mensaje, sin incluir estos 4 bytes
Comando 4 Valor 0520
Separador de campo 1 Hexa 0x7c
Indicador de 16 Valor alfanumérico
contexto Formato aaaammddhhmmssmm
Largo mensaje 4 Valor Numérico
Mensaje SPDH 2048 Valor alfanumérico (máximo)
1 No despliega glosa en pantalla del PINPAD ni actualiza parámetros

RESPUESTA
POR
DEFECTO
(0000 -> 9999)
Código Respuesta 2 Valor numérico
De acuerdo a Tabla de códigos de respuesta de
comandos
contexto Formato aaaammddhhmmssmm
Código de 12 Valor alfanumérico
comercio
Terminal ID 16 Valor Alfanumérico
Campo “t” mensaje SPDH
Número 20 Valor alfanumérico
Ticket/Boleta Campo “S” mensaje SPDH
Empleado 4 Valor alfanumérico
Campo “T” mensaje SPDH
Código 8 Valor Alfanumérico (máximo)
Autorización Campo “F” mensaje SPDH
Monto 18 Valor numérico (máximo)
Campo “B” mensaje SPDH
Monto vuelto 18 Valor numérico (máximo)
Numero de Cuotas 2 Valor numérico
Del campo “W” mensaje SPDH
Monto Cuota 14 Valor numérico
Últimos 4 Dígitos 4 Valor Numérico
Tarjeta
Número Operación 6 Correlativo de transacción del terminal
(máximo)
Glosa Tipo de 7 Valor alfanumérico (máximo)
Tarjeta Valor de glosa en Tabla tipo de tarjeta de acuerdo “Tipo
de tarjeta” del campo “W” mensaje SPDH

Fecha Contable 6 Valor alfanumérico

Se utiliza sólo si es transacción de Debito
Del campo “a” mensaje SPDH
Número de Cuenta 19 Valor alfanumérico
Número de tarjeta enmascarado para incluir en el
voucher Campo “E” mensaje SPDH
Abreviación de la 2 Valor alfanumérico
tarjeta Del campo “W” mensaje SPDH
Fecha Transacción 6 Formato AAMMDD
Del encabezado mensaje SPDH
Hora Transacción 6 Formato HHMMSS
Del encabezado mensaje SPDH
Campo Impresión 8192 Campo depende si la caja requiere
voucher formateado (máximo)
Transacción 1 Valor numérico
premiada Posición 1, campo “f” mensaje SPDH
(1: Entrega Pto. de Venta)
(2: Entrega Diferida)
(3: Devolución al Tarjeta Habiente)
Tipo promoción 1 Valor numérico
Posición 2, campo “f” mensaje SPDH
Código promoción 8 Valor alfanumérico
Posición 3-10, campo “f” mensaje SPDH
Nombre promoción 21 Valor alfanumérico
Glosa vale premio 62 Valor alfanumérico
Texto vale premio 27 Valor alfanumérico
Flag permite 1 Valor numérico 0
cuotas Del campo “W” mensaje SPDH
Flag de gracia 1 Valor numérico 0
Flag C2C 1 Valor numérico 0
Flag NCuotas 1 Valor numérico 0


Flag máximo de 2 Valor numérico 00
cuotas Del campo “W” mensaje SPDH
Tipo de menú 2 Valor alfanumérico
Indicador 1 Valor numérico
transacción con Del campo “W” mensaje SPDH
gracia
Tipo cuotas 1 Valor numérico
(1 : Normal)
(3 : C3C o C2C)
(4 : Cic o N-cuotas)
Tasa aplicada 4 Valor numérico
Solo se imprime en voucher si “Flag imprimir tasa = 1”
Glosa tipo cuota 30 Valor alfanumérico
(Glosa a imprimir en voucher)
Glosa tipo cuota 2 22 Valor alfanumérico
(Glosa que se despliega en PINPAD)
Glosa promoción 10 Valor alfanumérico
Id promoción 8 Valor alfanumérico
Flag imprimir tasa 1 Valor numérico 0
Periodo diferido 3 Valor numérico
Diferido 1 periodo 3 Valor numérico
Diferido 1 valor 4 Valor numérico
tasa Del campo “W” mensaje SPDH
cuota Del campo “W” mensaje SPDH


Número de 9 Valor alfanumérico (máximo)
secuencia Campo “i”. Sólo para anulaciones
transacción
original
Código respuesta 3 Valor Numérico
Transbank
Glosa respuesta 48 Valor alfanumérico (máximo)
Transbank Campo “g” mensaje SPDH
Flag transacción 1 Valor alfanumérico
con PIN (Y: Transacción autentificada con PIN)
(N: Transacción autentificada por firma)
Nombre 26 Valor alfanumérico
tarjetahabiente Sólo si “Flag transacción con PIN = N”
Flag tipo voucher 1 Valor numérico
(0: Venta con PIN, sin firma, sin glosa)
(1: Venta normal, con firma, con glosa)
(2: Venta con PIN, con firma, sin glosa)
(3: Venta normal, con firma, sin glosa)
Posición 8, subcampo “B” campo “9” mensaje SPDH
Flag modalidad 1 Valor alfanumérico
cuotas (0: Modalidad 3.1)
(1: Modalidad nuevas cuotas)
Glosa transacción 40 Valor alfanumérico (máximo)
afecta a ahorro (Se debe imprimir en el voucher cuando corresponda)
Número de 9 Valor numérico
secuencia
Flag mensaje 1 Valor alfanumérico
terminal (Y: El mensaje es terminal y NO se debe enviar el
mensaje SPDH de respuesta)
(N: Se debe enviar el mensaje SPDH de respuesta)
Largo mensaje 4 Valor numérico


Venta/Reversa
3.1.6 0560 - Comando Requerimiento de validación respuesta de transacción2
Este comando es un homologo al 540, donde la caja entrega el mensaje spdh al pinpad.
La diferencia es que el comportamiento definido para el pinpad con este comando es de
omitir la glosa de aprobado en pantalla.
La glosa que indica la aprobación de la transacción solo será mostrada en pantalla cuando el
pinpad reciba el comando 1100 desde la caja, este comando debe incluir el código del
mensaje que se requiere desplegar, para este caso Aprobado.
Cuando la caja requiera finalizar la aprobación de la transacción, una vez haya recibido el
comando 570 con el flag terminal en Y, debe enviar el comando 1100 con el código de
mensaje a mostrar en el pinpad.
REQUERIMIENTO
POR
DEFECTO
<STX> 1 Indica inicio de comando Valor Hexa 0x02 STX
Comando 4 Valor 0560 0560
Separador de campo 1 Hexa 0x7c |
contexto Id entregado por el pinpad por cada
transacción
Largo mensaje 4 Valor Numérico
Nombre Comercio 40 Valor Alfanumérico
Campo paramétrico en caja enviado al
pinpad
Dirección Comercio 40 Valor Alfanumérico
pinpad
Comuna Comercio 40 Valor Alfanumérico
pinpad
Puede ser comuna o ciudad
<ETX> 1 Indica Fin de comando Valor Hexa 0x03 ETX
2 No despliega glosa en pantalla del PINPAD ni actualiza parámetros

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

mensaje
Timeout de espera por comando 560 de 125seg, ya que hay hasta 4 interacción con el usuario
RESPUESTA
DATO LARGO COMENTARIO VALOR POR
DEFECTO
<STX> 1 Indica inicio de comando Valor Hexa 0x02 STX
Comando 4 Valor 0570 0570
Código Respuesta 2 Valor numérico
PinPad En caso de rechazo se debe desplegar en el punto de
venta:
RECHAZO PINPAD - <XX> : <GLOSA>
comandos
Indicador de contexto 16 Valor alfanumérico
Id entregado por el pinpad por cada transacción
Código de comercio 12 Valor numérico
Código del comercio entregado por TBK y configurado en
la caja, se imprime en voucher
Terminal ID 16 Valor Alfanumérico
Dirección lógica entregada por TBK y configurada en la
caja, se imprime en voucher
Número Ticket/Boleta 20 Valor alfanumérico
Campo opcional, si viene se imprime en voucher si no
viene se omite el campo
Empleado 4 Valor alfanumérico
Campo opcional, si viene se imprime en voucher si no
viene se omite el campo
Código Autorización 8 Valor Alfanumérico (máximo)
Código de autorización de la transacción enviado por
TBK ejemplo: |AB 12 C3|
Se imprime lo que viene en el voucher
Monto 18 Valor numérico (máximo)
Monto total autorizado (incluye el monto de la venta,
propina, vuelto y donación según sea el caso)
Se imprime en voucher
Monto vuelto 18 Valor numérico (máximo)
Vuelto seleccionado por cliente, solo aplica en debito
Numero de Cuotas 2 Valor numérico
Cantidad de cuotas de la transacción (para ventas sin
cuotas se informa “00”)
Monto Cuota 14 Valor numérico
Si el monto informado es vacío || o |0| caja debe omitir
la línea completa en el voucher.
Se imprime en voucher si viene el campo


Últimos 4 Dígitos 4 Valor Numérico
Tarjeta No se imprime
Número Operación 9 Correlativo de transacción del terminal
También conocido como número de secuencia este
campo se debe imprimir en voucher de venta y
anulación.
Glosa Tipo de Tarjeta 7 Valor alfanumérico (máximo)
Valor de glosa en Tabla tipo de tarjeta
Fecha Contable 6 Valor alfanumérico
Se utiliza sólo si es transacción de Debito
Caja no debe formatear (ej: DDAAMM), simplemente
debe transferir el valor al voucher (XX/XX/XX)
Número de Cuenta 19 Valor alfanumérico
Número de tarjeta enmascarado para incluir en el
voucher
Abreviación de la 2 Valor alfanumérico
tarjeta Valor a imprimir en el voucher
Fecha Transacción 6 Formato AAMMDD
Valor a imprimir en el voucher
Hora Transacción 6 Formato HHMMSS
Valor a imprimir en el voucher
Campo Impresión 8192 Campo depende si la caja requiere voucher
formateado (máximo)
En el comando 510 no se envía el voucher
En el comando 550 se envía voucher siempre
Transacción premiada 1 Valor numérico
|1|: transacción premiada
En este caso caja debe imprimir voucher PEL además del
de venta
||: transacción sin premio
Tipo promoción 1 Valor numérico
|1|: Entrega Pto. de Venta
|2|: Entrega Diferida
|3|: Devolución al Tarjeta Habiente
Código promoción 8 Valor alfanumérico
Valor a imprimir en el voucher premiado
Nombre promoción 21 Valor alfanumérico
Valor a imprimir en el voucher de premio
Glosa vale premio 62 Valor alfanumérico
Texto vale premio 27 Valor alfanumérico
Flag permite cuotas 1 Valor numérico 0
Campo informativo de la configuración del comercio
Flag de gracia 1 Valor numérico 0


Flag NCuotas 1 Valor numérico 0
Flag máximo de cuotas 2 Valor numérico 00
Tipo de menú 2 Valor alfanumérico
Indicador del tipo de menú por el cual se realizó la
transacción
|CR| : CRÉDITO
|DB| : DÉBITO PREPAGO
|NB| : NO BANCARIA
Valor de tipo en Tabla tipo de tarjeta
Una venta hecha como debito puede ser autorizada
como prepago
Indicador transacción 1 Valor numérico
con gracia Indicador de modalidad de la transacción
|0| transacción sin mes gracia
|1| transacción con mes gracia
Tipo cuotas 1 Valor numérico
|0| Sin cuotas
|1| Cuotas normales
|3| C3C o C2C
|4| CIC o N-cuotas
Tasa aplicada 4 Valor numérico
Solo se imprime en voucher si “Flag imprimir tasa = 1”
Glosa tipo cuota 30 Valor alfanumérico
Glosa a imprimir en voucher
Si el campo informado viene vacío “||” caja debe omitir
la línea en el voucher.
Glosa tipo cuota 2 22 Valor alfanumérico
Glosa que se despliega en pinpad
Glosa promoción 10 Valor alfanumérico
Id promoción 10 Valor alfanumérico
Flag imprimir tasa 1 Valor numérico 0
|| o |0| no imprime tasa aplicada
|1| imprime tasa aplicada
Periodo diferido 3 Valor numérico
Periodo diferido seleccionado, valor a imprimir en
voucher
No utilizado
Diferido 1 valor tasa 4 Valor numérico
No utilizado

Diferido 1 valor cuota 14 Valor numérico

No utilizado
No utilizado
No utilizado
No utilizado
No utilizado
No utilizado
No utilizado
Número de secuencia 9 Valor alfanumérico (máximo)
transacción original También conocido como número de operación original
de la venta, No se está usando este campo, no se
imprime
Código respuesta 3 Valor numérico
Transbank Código de respuesta una vez finalizada la transacción.
Se debe desplegar en el punto de venta.
EJ: RESPUESTA TRANSBANK - <XXX> : <GLOSA>
Glosa respuesta 48 Valor alfanumérico (máximo)
Transbank Glosa que despliega el pinpad una vez finalizada la
transacción. Se debe desplegar en el punto de venta.
EJ: RESPUESTA TRANSBANK - <XXX> : <GLOSA>
Flag transacción con 1 Valor alfanumérico
PIN Y: Transacción autentificada con PIN
N: Transacción autentificada por firma
Nombre tarjetahabiente 26 Valor alfanumérico
Sólo imprimir si “Flag tipo voucher = 1, 2 ó 3”
Flag tipo voucher 1 Valor numérico
Según el número recibido se debe imprimir voucher con
o sin firma:
|0| = Sin firma

|1| o |2| o |3| = con firma
Cabeceras de los voucher:

Para ventas con crédito:
“VENTA CREDITO”
Para ventas con débito (siempre sin firma):
“VENTA DEBITO”
Para ventas con no bancaria:
“VENTA NO BANCARIA”
Para ventas con prepago (sin firma):
“VENTA PREPAGO”
Para anulaciones con crédito (sin firma):
“ANULACION CREDITO”
Para anulaciones con no bancaria (sin firma):
“ANULACION NO BANCARIA”

Flag modalidad cuotas 1 Valor alfanumérico 1

0: Modalidad 3.1 (No utilizado)
1: Modalidad cuotas 4.0
Glosa transacción 40 Valor alfanumérico (máximo)
afecta a ahorro Se debe imprimir en el voucher cuando sea distinta de
vacío
Campo 9, subcampo D
Número de secuencia 9 Valor numérico
No se está usando este campo, este no se imprime
También conocido como número de operación
Flag mensaje terminal 1 Valor alfanumérico
Y: El mensaje es terminal y NO se debe enviar el
mensaje SPDH de respuesta
N: Se debe enviar el mensaje SPDH de respuesta
Largo mensaje 4 Valor numérico

Venta/Reversa
Propina 18 Valor numérico
Monto Propina o Donación
Voucher de Rechazo 1024 Valor numérico
Cuando transacción es declinada por EMV se debe
imprimir un voucher especial.
Si este campo viene vacío no se imprime, si viene con
dato se imprime
Este voucher se imprime solo, sin voucher de venta
Voucher PEL 1024 Valor alfanumérico
Voucher de PEL si viene la caja debe imprimirlo, solo
una vez junto al voucher de venta
No se debe imprimir en duplicado
Este voucher se imprime junto al de venta
LABEL - EMV 32 Valor alfanumérico
Si el campo viene con datos caja debe incluirlo en el
voucher en la posición indicada
RID - EMV 32 Valor alfanumérico
Si el campo viene con datos caja debe incluirlo en el
voucher en la posición indicada
Modelo pinpad 6 Valor numérico
Caja debe incluirlo en el voucher ejemplo:
VX805
Campo obligatorio
Versión de pinpad 6 Valor numérico
Caja debe incluirlo en el voucher ejemplo:
12.34A
Campo obligatorio
Saldo Prepago 40 Valor alfanumérico (máximo)
Indica el saldo de una tarjeta de prepago la cual se debe
imprimir en voucher cuando es venta de prepago y
cuando viene el saldo.
Nota: El Pinpad agrega esa glosa al voucher tal como
viene en la mensajería.

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

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

3.2 Comando Cierre batch
3.2.1 0600 - Solicitud comando Cierre batch
Igual al Retail estándar vx805 version 4.0
3.2.2 0700 - Validación comando Cierre batch
Igual al Retail estándar vx805 version 4.0
3.3 1100 - Comando despliegue mensaje
Con este comando la caja puede mostrar en pantalla del pinpad algunos mensajes predefinidos.
REQUERIMIENTO
POR
DEFECTO
(0000 -> 9999)
Código mensaje 4 Valor Numérico
Revisar: Tabla de código de mensajes
Timeout mensaje 2 Valor Numérico
(00 -> 09)
RESPUESTA
POR
DEFECTO
(0000 -> 9999)
Código respuesta 2 Valor numérico
comandos

3.4 CONN - Comando Conexión PINPAD – Caja
Comando enviado desde el PINPAD a la Caja de modo de establecer la conexión. La caja

debe abrir un puerto de conexión el cual no debe ser cerrado en ningún momento.
REQUERIMIENTO
DATO LARGO COMENTARIO Requerido VALOR
POR
DEFECTO
(0000 -> 9999)
Indicando el largo del mensaje, sin incluir
estos 4 bytes
Comando 4 Valor ‘CONN’
Separador de 1 Hexa 0x7c
campo
Número Serial 15 Valor alfanumérico
Número serial del PINPAD
campo
Data 20 Valor alfanumérico Obligatorio
(TRANSBANK VER. 4.01A)
Identificador de la aplicación más la
versión de la aplicación
campo
RESPUESTA
POR
DEFECTO
LARGO_DATA 4 Valor numérico Obligatorio
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘CONN’ Obligatorio
campo
Código Retorno 2 Valor numérico Obligatorio
(00: Prompt de inicio)
(01: Glosa de rechazo)
campo
Número de 2 Valor numérico Obligatorio
Líneas (00 -> 99)
Cantidad de líneas de glosas a desplegar.
campo
Glosa 16 Valor alfanumérico Opcional
Glosa descripción de error.
campo

3.5 ECHO - Comando Echo Caja – PINPAD
Comando que permite a la Caja verificar que el PINPAD se encuentra conectado,

identificarlo por su número de serie y versión de aplicación.
REQUERIMIENTO
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘ECHO’ Obligatorio
campo
RESPUESTA
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘ECHO’ Obligatorio
campo
(00: OK, Prompt de inicio)
(01: NOK, Glosa de rechazo)
campo
Número Serial 15 Valor alfanumérico Obligatorio
Número serial del PINPAD
campo
Data 20 Valor alfanumérico Obligatorio
(TRANSBANK VER. 4.01A)
Identificador de la aplicación más la
versión de la aplicación
campo

3.6 ISES - Comando Inicio de Sesión Caja- PINPAD
Este comando permite abrir una sesión con el PINPAD desde la Caja.
REQUERIMIENTO
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘ISES’ Obligatorio
campo
RESPUESTA
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘ISES’ Obligatorio
campo
(00: OK)
(Otro: Error)
campo
Batería 3 Valor numérico Obligatorio
(000 -> 100)
Porcentaje de carga de batería.
campo

3.7 FSES - Comando Fin de Sesión Caja – PINPAD
Este comando permite cerrar una sesión con el PINPAD desde la Caja.
REQUERIMIENTO
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘FSES’ Obligatorio
campo
RESPUESTA
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘FSES’ Obligatorio
campo
(00: OK)
(Otro: Error)
campo

3.8 Comando Impresión Voucher
3.8.1 VOUC - Comando Solicitud Impresión Voucher Caja – PINPAD
REQUERIMIENTO CAJA
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘VOUC’ Obligatorio
campo
Time Out 5 Valor numérico Obligatorio
(00000 -> 99999)
Timeout del comando en milisegundos.
campo
Glosa 1 16 Valor alfanumérico Obligatorio
Glosa a desplegar primera línea en
pantalla.
campo
Glosa a desplegar segunda línea en
pantalla.
campo
Voucher a 4000 Valor alfanumérico Obligatorio
Imprimir Voucher separado por “\n” para nueva
línea, “\c” para corte de voucher
campo
RESPUESTA PINPAD
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘VOUC’ Obligatorio
campo
(00: Impresión OK)
(01: Error en la impresión)
campo

3.8.2 REIM - Comando Solicitud Reimpresión Último Voucher PINPAD – Caja
Comando enviado desde el PINPAD a la Caja de modo de que la caja envíe al PINPAD el
Voucher de la última venta. Para enviar este comando se debe presionar en el PINPAD
[ENTER] + [5].
REQUERIMIENTO PINPAD
POR
DEFECTO
(0000 -> 9999)
Comando 4 Valor ‘REIM’
RESPUESTA CAJA
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘REIM’ Obligatorio
campo
(00: Recibido OK)
(01: No existe impresión disponible)
campo
Time Out 5 Valor numérico Obligatorio
(00000 -> 99999)
Timeout del comando en milisegundos.
campo
Glosa a desplegar primera línea en
pantalla.
campo
Glosa a desplegar segunda línea en
pantalla.
campo
Voucher a 4000 Valor alfanumérico Obligatorio
Imprimir Voucher separado por “\n” para nueva
línea, “\c” para corte de voucher
campo

3.9 REST - Comando Reset Socket Caja – PINPAD
Comando permite a la Caja realizar un reset al socket del PINPAD.
REQUERIMIENTO CAJA
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 3 Valor ‘REST’ Obligatorio
campo
RESPUESTA PINPAD
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘REST’ Obligatorio
campo
(00: Recibido OK)
(01: Error Mensaje)
campo

3.10 LKEY - Comando Carga de Llave PINPAD – Caja
Comando ejecutado a través del menú del PINPAD, el cual permite solicitar a la caja una
‘Carga de llaves’ a la Caja. La transacción de carga de llaves debe ser construida tal como lo
define el manual de “Especificaciones Técnicas”.
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 3 Valor ‘LKEY’ Obligatorio
campo
RESPUESTA CAJA
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘LKEY’ Obligatorio
campo
(00: Recibido OK)
(01: Error en carga de llaves)
campo

3.11 0000 - Comando TEST PINPAD – Caja
Comando enviado desde el PINPAD hacia la Caja para mantener el socket abierto.
DATO LARGO COMENTARIO ReEquerido VALOR
POR
DEFECTO
Comando 4 Valor ‘0000’ Obligatorio
RESPUESTA CAJA
POR
DEFECTO
Comando 4 Valor ‘0000’ Obligatorio

3.12 CLSB - Comando Cierre Batch PINPAD – Caja
Comando ejecutado a través del menú del PINPAD, el cual permite indicar a la caja el envío
de una solicitud de ‘Cierre batch’.
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 3 Valor ‘CLSB’ Obligatorio
campo
RESPUESTA CAJA
POR
DEFECTO
(0000 -> 9999)
estos 4 bytes
Comando 4 Valor ‘CLSB’ Obligatorio
campo
(00: OK)
(Otro: Error)
campo

4 Anexos
4.1 Tabla de marcas
NOMBRE MARCA DE TARJETA ABREVIACIÓN DE TARJETA

VISA VI
MASTERCARD MC
DINERS DC
AMEX AX
MAGNA MG
PRESTO TP
MAS TM
CMR TC
RIPLEY TR
MAESTRO MT
ELECTRON EL
DEBITO DB
4.2 Tabla de tipo de tarjeta
CÓDIGO TIPO DE TARJETA GLOSA TIPO DE TARJETA

CR CREDITO
DB DEBITO
NB NO BANCARIA
Null (vacío) Se despliega Menú en PINPAD.
4.3 Tabla de códigos de respuesta de comandos
CÓDIGO DE RESPUESTA GLOSA

00 RESPUESTA OK
84 NO EXISTE CODIGO DE MENSAJE
86 ERROR DE LECTURA.
87 PINPAD SIN MASTER KEY
89 TRANSACCIÓN DECLINADA POR LA TARJETA CHIP
90 TARJETA NO PERMITIDA PARA EL MODO
SELECCIONADO
91 ERROR CANTIDAD DE CUOTAS
92 NO COINCIDE CON TARJETA DE PRIMER “TAPEO”
93 ERROR DE MONTO MÍNIMO
94 ERROR DE VALIDACIÓN MONTO VUELTO
95 ERROR ID DE CONTEXTO
96 NO COINCIDE LOS 4 ULTIMOS DIGITOS
97 LA TRANSACCIÓN NO PERMITE REVERSA
98 ERROR DE FORMATO DEL MENSAJE
99 CANCELACIÓN DEL COMANDO A TRAVÉS DE LA
TECLA [CANCEL] / TIMEOUT

4.4 Tabla de códigos de mensajes de despliegue en PINPAD
CÓDIGO MENSAJE GLOSA MENSAJE

0000 APROBADO
0001 ERROR INTERNO DE MENSAJERIA
0003 NIVEL DE BATERIA BAJO
0004 CANCELACION DE OPERACIÓN
0005 EMISOR NO DISPONIBLE
0006 TERMINAL NO DISPONIBLE
0007 NO HAY CONFIRMACION
0008 ERROR EN OPERACIÓN CON POS
0009 MAXIMO INTENTOS SUPERADOS CONEXIÓN
SWITCH SERVER
0010 CANCELACION DE OPERACIÓN
0011 MEDIOS DE PAGO NO DISPONIBLES
0014 ERROR INTERNO DE SISTEMA
0015 ERROR INTERNO DE SISTEMA
0018 TRANSACCION DE VENTA INEXISTENTE
0019 TRANSACCION ORIGINAL NO ES UNA
VENTA
0020 TRANSACCION ORIGINAL NO TERMINADA
0021 TRANSACCION PENDIENTE EMISOR
0022 MONTO A ANULAR MAYOR AL MONTO DE
VENTA
0023 MONTO A ANULAR DISTINTO AL MONTO DE
VENTA
0024 TARJETA NO PERMITIDA
0025 ERROR RESPUESTA TERMINAL
0026 ERROR RESPUESTA TERMINAL

Manual 1

Cargado por

Copyright:

Formatos disponibles

Manual 1

Cargado por

Información del documento

Descripción original:

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual 1

Cargado por

Copyright:

Formatos disponibles

Manual de comandos

Pinpad Host Wifi

Versión Manual 2.4

PINPAD VERIFONE VX680

CONTROL DE VERSIONES ........................................................................................ 4

Junio 2019 Confidencial Página 2 de 43

La información contenida en este documento es

Junio 2019 Confidencial Página 3 de 43

NÚMERO FECHA AUTOR DESCRIPCIÓN DE CAMBIOS

Junio 2019 Confidencial Página 4 de 43

Este documento describe la forma de operar, la funcionalidad y el detalle de la mensajería

Para entender completamente este documento es necesario tener conocimientos

Junio 2019 Confidencial Página 5 de 43

2 Protocolo de mensajería según tipo de comunicación

2.1 Seguridad TLS 1.2

2.2 Seguridad en la Red WI-FI del Comercio

Recomendaciones se seguridad para una red WI-FI:

1) Cambiar regularmente la contraseña de red WI-FI

2) Configurar la red WI-FI como “No visible”

3) Registrar y restringir las conexiones por MAC

4) Restringir el acceso a la “Configuración del Router” desde WI-FI

5) Monitorear regularmente las conexiones WI-FI

Junio 2019 Confidencial Página 6 de 43

2.3 Archivos implementación TLS

La implementación de TLS realizada es la de autenticación mutua two-way, es decir el PinPad valida a la

Certificados TLS del Pinpad:

1.- Certificado cliente:

2.- Llave de validación del certificado de cliente:

3.- Certificado para validar el servidor:

Certificados TLS del Servidor (Caja del Comercio):

1.- Certificado servidor:

2.- Llave de validación del certificado de servidor:

3.- Certificado para validar el cliente:

Junio 2019 Confidencial Página 7 de 43

2.4 Implementación TLS

La siguiente figura muestra el protocolo de enlace TLS utilizando un almacén de confianza.

El cliente tiene la CA del certificado del servidor en su almacén de confianza.

El servidor tiene la CA del certificado del cliente en su almacén de confianza.

Junio 2019 Confidencial Página 8 de 43

Dependiendo del lenguaje o plataforma, se debe especificar la ubicación de los “Almacenes de

//Especificamos el KeyStore que contiene el certificado del Servidor y la llave privada

KeyManagerFactory kmf = KeyManagerFactory.getInstance(KeyManagerFactory.getDefaultAlgorithm());

//Especificamos el TrustStore que contiene el Certificado CA del cliente

TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());

//Creamos la instancia TLS

//se crea el socket que se usara para la comunicación

//Leemos lo enviado desde el PINPAD

//Enviamos ACK al Pinpad

//Enviamos Comando al Pinpad

Ejemplo de cómo indicar los certificados de los socket SSL en JAVA

Junio 2019 Confidencial Página 9 de 43

2.5 Protocolo de comunicación TCP/IP

Este protocolo permite la comunicación entre un ECR (Electronic Cash Register) y un

2.6 Diagrama genérico de secuencia de comandos

El diagrama que se describe corresponde a la generalización del comportamiento de cada

Figura 2 – Secuencia de comandos Caja a PINPAD

Junio 2019 Confidencial Página 10 de 43

Figura 3 – Secuencia de comandos PINPAD a Caja