Host to Host Pinpad Wifi

Protocolo de mensajería

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.

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 de seguridad para una red WI-FI: Cambiar regularmente la contraseña de red WI-FI

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

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

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.

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();
} 

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.

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.

Flujo de venta detallado

Diagrama

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.

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.

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

Diagrama Inicialización y conexión al PINPAD

Flujo de ejecución de comandos al PINPAD

Manejo de contexto

Descripción de comandos

0100 - Comando Lectura de tarjeta

Igual al Retail estándar vx805

0200 - Comando Requerimiento de venta/anulación

Igual al Retail estándar vx805

0400 - Comando Requerimiento de reversa

Igual al Retail estándar vx805

0500 - Comando Requerimiento de validación/actualización

Igual al Retail estándar vx805

0520 - Comando Requerimiento de validación respuesta de transacción

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

Nota: No despliega glosa en pantalla del PINPAD ni actualiza parámetros

Respuesta

0560 - Comando Requerimiento de validación respuesta de transacción

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

Timeout de espera por comando 560 de 125seg, ya que hay hasta 4 interacción con el usuario

Respuesta

0600 - Solicitud comando Cierre batch

Igual al Retail estándar vx805

0700 - Validación comando Cierre batch

Igual al Retail estándar vx805

1100 - Comando despliegue mensaje

Con este comando la caja puede mostrar en pantalla del pinpad algunos mensajes predefinidos.

Requerimiento

Respuesta

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

Requerimiento

Respuesta

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

Respuesta

ISES - Comando Inicio de Sesión Caja- PINPAD

Este comando permite abrir una sesión con el PINPAD desde la Caja.

Requerimiento

Respuesta

FSES - Comando Fin de Sesión Caja – PINPAD

Este comando permite cerrar una sesión con el PINPAD desde la Caja.

Requerimiento

Respuesta

VOUC - Comando Solicitud Impresión Voucher Caja – PINPAD

Requerimiento

Respuesta

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

Respuesta

REST - Comando Reset Socket Caja – PINPAD

Comando permite a la Caja realizar un reset al socket del PINPAD.

Requerimiento

Respuesta

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

Requerimiento

Respuesta

0000 - Comando TEST PINPAD – Caja

Comando enviado desde el PINPAD hacia la Caja para mantener el socket abierto.

Requerimiento

Respuesta

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

Requerimiento

Respuesta

Otros datos

Tabla de marcas de tajetas

Tabla de tipo de tarjeta

Tabla de códigos de respuesta de comandos

Tabla de códigos de mensajes de despliegue en PINPAD