2. Configuración inicial de la terminal.

📘

Nota.

Una vez recibida la terminal, es necesario responder el correo donde se recibió la documentación e incluir el número de serie de la misma, el cual podrás encontrar abajo en la parte trasera.

Antes de empezar.

a) Requisitos
b) Instalación de la Smart PinPad DEV
c) Login
d) Configuración de la terminal
e) Activación del inicio automático
f) Botones fisicos de navegación
g) Salida de la aplicación
h) Botón "Configurar respuesta del servicio"
i) Revisión de compatibilidad de certificados SSL
j) Ambiente Sandbox
k) Funcionalidades especiales

a) Requisitos

• Contar con una terminal Smart. Si no cuenta con una, revisar con el equipo comercial que está encargado de tu integración (Para corroborar que la terminal se encuentre en el ambiente de pruebas es importante que se comunique con el equipo de integraciones o con su comercial para que validen que la terminal se encuentre en las condiciones necesarias para realizar pruebas.).

• Descargar y configurar la aplicación Smart PinPad DEV para el ambiente sandbox.

• Solicitar al equipo de Integraciones de NetPay las credenciales de prueba.

• Terminal con acceso a Internet para recibir y procesar peticiones de cobro.

• Desarrollar un API REST (local o a través de internet) para el envío de la petición de venta, cancelación o reimpresión hacia la terminal para procesar el pago.

• El servicio debe estar funcionando siempre que se requiera realizar cobros con la terminal ya que es ahí donde se enviará la respuesta de la operación.

• La terminal debe poder alcanzar el servicio en todo momento para poder realizar el flujo completo de una transacción.

• En caso de que la terminal indique que no puede enviar la respuesta al servicio, se debe verificar inmediatamente si el servicio está funcionando correctamente para poder realizar el flujo correcto de una transacción.
• Se recomienda que el punto de venta tenga implementado un log para recibir la respuesta de la Smart.

Durante este proceso se recomienda

• Es importante tomar en cuenta que es necesario comunicarse con el equipo de NetPay cuando se presente alguna anomalía o falla en la terminal para que se pueda revisar y no les afecte en el proceso de integración desde la fase de pruebas hasta la parte productiva.
• Pueden comunicarse con su comercial correspondiente o el equipo de integraciones para validar que la terminal esta correctamente ambientada.

b) Instalación de la Smart PinPad DEV

Ingresar a Netpay Market, esta aplicación se encuentra en la pantalla principal de la terminal.

📘

Nota.

La terminal punto de venta Smart ofrece una tienda de aplicaciones (Netpay Market), la cuál te permitirá instalar y actualizar aplicaciones, ver el estatus de los componentes, actualizar versión del firmware del S.O. de la terminal, entre otras cosas.

Buscar la aplicación “Smart PinPad DEV”, la versión de pruebas más actualizada en tienda es la 1.3.6, posteriormente se selecciona y se presiona el botón verde “OBTENER”.

Al seleccionar la versión 1.3.9.2.p.p_20230203 de Smart PinPad DEV se mostrará la siguiente pantalla indicando el peso de la aplicación. Posteriormente presionamos el botón verde “INSTALAR”.

Una vez inicie la descarga, la barra inferior nos indicará el avance de la descarga.

Al término de la instalación, el botón cambiará de mensaje de "PAUSA" a “ABIERTO”.

❗️

ERROR 13

Quizás en tu proceso de instalación de la Smart PinPad te topes con un error 13, este error es común y tiene solución, por favor lea los siguientes pasos.

Este error aparece cuando tienes instalada la App de Pagos y quieres instalar la Smart PinPad o viceversa, solo puedes tener una app al mismo tiempo, ya que comparten los mismos datos y ocasiona conflictos de compatibilidad.

En este caso es necesario solicitar apoyo al equipo de NetPay para que se desinstale la aplicación y se pueda realizar la instalación de la app solicitada, no intente desinstalar la app, ya que puede ocasionar problemas en algunos escenarios.

c) Login

Ingresar a la versión de Smart PinPad en el ícono del escritorio.

Se mostrará la pantalla de “Bienvenido a Netpay Smart”, posteriormente ingresar Store ID y Password de prueba proporcionados por el equipo de Integraciones. Presionar el botón “Iniciar”.

Este paso lo debemos realizar para poder indicar con qué Store ID se estará trabajando. Se debe realizar un único login, el cual mostrará la pantalla en blanco con la leyenda de “NetPay”.

d) Configuración de la terminal

La aplicación cuenta con un menú oculto de configuración. Para acceder a él, bastará dejar presionado por dos segundos en la parte inferior derecha para que nos aparezca el menú de configuración de la terminal.

Detalle de la Configuración

• Operativa de venta.
• Configuración de venta.
• Seguridad
• Tipo de conexión.
• Botón "Configurar respuesta del servicio".

📘

Nota.

La configuración básica para que la terminal tenga conexión con el punto de venta es activando la opción "Web" y configurando la URL de la respuesta del servicio en el botón de "Configurar respuesta del servicio".

Operativa de venta

Configuración de venta

Seguridad

Tipo de conexión

e) Activación del inicio automático

📘

Nota

Esta configuración aplica solamente para las versiones de la SmartPinPad DEV 1.3.2 o posteriores.

Para esta integración al activar la opción Web como se menciona anteriormente en el inciso d) , se activara el inicio automático de la aplicación Smart PinPad que permitirá abrir la aplicación de SmartPinPad Dev de forma automática cuando la terminal se reinicie o se encienda nuevamente.

Cuando se reinicia o se enciende la terminal, el inicio automático de la Smart PinPad se queda en modo de espera en el inicio del launcher durante unos 25 segundos aproximadamente, esperando a que la terminal termine el proceso de carga de los demás servicios y aplicaciones, así como se muestra en la siguiente imagen, esto para que al momento de levantar la aplicación funcione correctamente.

📘

Nota.

Antes de que se levante de manera automática la Smart PinPad, recomendamos no realizar ninguna acción ya que esto puede ocasionar problemas al momento de que se inicia la aplicación.

Una vez que pasan los 25 segundos, se levanta la aplicación de manera automática y ya se puede utilizar la aplicación sin problema.

f) Bloqueo de botones fisicos de navegación

📘

Nota

Esta configuración aplica solamente para las versiones de la SmartPinPad DEV 1.3.2 o posteriores.

De igual manera al activar la opción Web y activar Bloquear botones de navegación, así como se muestra en la siguiente imagen, los botones físicos de navegación se bloquearan, esta es una función opcional que si se requiere activar se deben tener las dos opciones seleccionadas, de lo contrario no se bloquearan los botones de navegación.

Los botones físicos de navegación son los botones táctiles que se encuentran en la parte baja de la terminal, como lo indica la flecha en la siguiente imagen.

📘

Nota

Para habilitar la opción Bloquear botones de navegación, se debe de tener activada la opción WEB, de lo contrario no se podrá seleccionar ésta opción, así como se muestra a continuación.

g) Salida de la aplicación

📘

Nota

Esta configuración aplica solamente para las versiones de la SmartPinPad DEV 1.3.2 o posteriores.

Si el usuario requiere salir de la aplicación tendrá que dejar presionado los dos botones ocultos al mismo tiempo agregados en la pantalla principal, el primero se encuentra en las palabras de NetPay (cuadro rojo) y el segundo se encuentra en la parte baja de lado izquierdo (cuadro verde), como se muestra en la siguiente imagen.

Una vez dejado presionado los botones, se muestra el mensaje de confirmación para salirse de la aplicación, en el cual daremos aceptar, como se muestra en la siguiente imagen.

Otras formas de salir de la aplicación.

Opcion1: Ingresar a las opciones del menú oculto y presionar el botón de salir

Opción 2: Activando la opción de menú restaurante se habilitara en el menú de la parte superior izquierda las operativas.

Al momento de dar aceptar nos mandará al inicio del launcher y se activaran nuevamente los botones físicos de navegación en la terminal.

📘

Nota

Cuando se activa la opción web por primera vez, para que la configuración del inicio automático de la aplicación y el bloqueo de botones físicos de la terminal sean efectuados, se debe regresar a la pantalla principal de NetPay por medio de la flecha de retorno.

Si el usuario se sale de la aplicación ya sea presionando aceptar en el mensaje de confirmación o por otra forma, al momento de volver abrirla los cambios quedan efectuados y se puede seguir utilizando de manera habitual.

La aplicación regresará a la pantalla NetPay.

h) Botón "Configurar respuesta del servicio"

Como última opción en la pantalla de Configuraciones se mostrará en la parte inferior el botón "Configurar respuesta del servicio" en la cual debemos proceder a presionar para llevar a cabo la configuración.

Se desplegará una nueva pantalla solicitando la información del End Point de regreso al servidor con la información de las transacciones.

• Ingresa ip o dns: Colocar tu dominio.

Ejemplo: Ingresando DNS y puerto.

Ejemplo: Ingresando IP y puerto.
http://192.31.48.151:8081

• Ingresa el path: Ruta del servicio que va a consumir la terminal.

Por ejemplo si tu URL es la siguiente:

https://netpay.mx:8081/ejemplo-de-servicio/v1/respuesta

Se dividiría de la siguiente forma:

Ingresa el path: /ejemplo-de-servicio/v1/respuesta

Si la información ingresada es correcta y el servicio responde según los requisitos, nos aparecerá un mensaje indicando que la información ha quedado almacenada de manera exitosa.

Presionar el botón de "Aceptar" del mensaje Dato Guardado con éxito

📘

Nota.

Al momento de guardar por primera vez la url del servicio de respuesta dentro de la configuración de la app, la terminal enviará el siguiente JSON hacia el servicio:

{
  "folioNumber":"",
  "internalNumber":"",
  "tableId":"",
  "listOfPays":[],
  "tipTotalAmount":"",
  "totalAmount":""
}

Al ser consumido el servicio

• Debe regresar un HTTP Status Code 200.
• El verbo HTTP devuelto debe ser POST.
• Al consumir el servicio, el body debe de contener el JSON con los siguientes parámetros. (El mensaje dentro del parámetro message puede contener cualquier texto y el parámetro code debe regresar un 00).

{
    "code": "00",
    "message": "Recibido"
}

Posteriormente presionar la flecha de regreso hasta que se muestre la pantalla principal de la Smart PinPad (Pantalla en blanco con el encabezado de Netpay).

📘

Nota.

Cuando se envié una petición de venta, cancelación o reimpresión a la terminal, la aplicación de Smart PinPad DEV siempre debe de estar abierta y posicionada en la pantalla inicial.

📘

Nota.

Verificar que la información ingresada en la configuración de respuesta sea la correcta ya que de lo contrario no se estaría recibiendo la información de la operación al punto de venta.

Posibles errores
En caso de que no se ingrese una URL valida, se mostrará el mensaje de "La smartpos no se ha podido conectar al servidor con los datos ingresados".

Al presionar "Más detalles" te mostrará el motivo por el cual esta desplegando el error al ingresar el URL del servicio de regreso.

i) Revision de Compatibilidad de Certificados SSL

Actualmente, el certificado ISRG ROOT X1, ya no es compatible con versiones de Android 7 e inferiores; y eso presenta una complicación al momento de realizar la integración por API.

Enlaces a información relacionada.

Comunicado Oficial Lets Encrypt de incompatibilidad de ISRG ROOT X1 incompatible para Android 7 e inferior: https://letsencrypt.org/2020/12/21/extending-android-compatibility.html

https://letsencrypt.org/2023/07/10/cross-sign-expiration.html

Revisión del Certificado.

Existen páginas que nos ayudan a validar el certificado SSL del dominio que tenemos, por ejemplo Qualys, esta plataforma ayuda a dar recomendaciones de compatibilidad, seguridad, etc. y asigna una calificación en base a los datos analizados.

Aquí encontraremos en el apartado "Additional Certificates (is supplied)" un valor llamado Issuer, que nos indica el tipo de certificado del dominio.

Este certificado de Lets Encrypt es gratuito, por lo que en este tipo de certificados se recomienda estar al tanto de los comunicados oficiales para determinar su vigencia y compatibilidad con las diferentes versiones de Android como por ejemplo este certificado de tipo ISRG ROOT X1 que dejo de funcionar a inicios del 2024 por políticas de seguridad de Android y aplicó para versiones 7.0 e inferiores, con el paso del tiempo ira abarcando más versiones de incompatibilidad por lo que es importante realizar las validaciones necesarias para evitar una interrupción en sus servicios web internos de su sistema.

Enlace.

https://www.ssllabs.com/ssltest/index.html

Soluciones o Alternativas.

Compartiremos algunas opciones disponibles para solucionar el problema anterior:

• Validar si el proveedor de hosting del sistema del comercio maneja alguna alternativa del certificado Lets Encrypt ISRG ROOT X1 u otro tipo de certificado compatible con Android 5.1, 6.0, 7.0 o 7.1.2
• Adquirir un certificado SSL de otro proveedor de pago, ya que con estos certificados no se han presentado reportes de incompatibilidad hasta el momento.
• Instalar un certificado manual en los dispositivos Android 7.0 e inferiores (no recomendable ya que las fuentes/foros no son confiables).
• Cambio o reemplazo a Android 7.1.2 (no recomendable ya que en algún punto volverá a pasar, puesto que, con el paso del tiempo, los diferentes sistemas operativos como Android dan de baja el soporte y compatibilidad a este tipo de su certificado, que en su mayoría son gratuitos).

j) Ambiente Sandbox

Se cuenta con un ambiente de Desarrollo para realizar las pruebas de integración y certificación en un ambiente controlado donde ningún cobro será real.

SANDBOX URL BASE:
https://api-154.api-netpay.com

Para cambiar entre ambientes únicamente debes cambiar la url base, configurar los accesos de cada ambiente y en caso de que se requiera cambiar entre versiones de aplicación.

🚧

Importante.

Considerar que en caso se usar una tarjeta con NIP este debe de ser ingresado correctamente ya que la terminal si valida que sea el correcto y en caso de ingresar incorrectamente podría ocasionar que se haga un bloqueo de la tarjeta.

k) Funcionalidades especiales

La configuración de Menú Restaurante la pueden activar desde el menú oculto(previamente se menciona en los puntos anteriores como acceder a el) y al activar esta opción permite habilitar las siguientes opciones en la pantalla inicial de NetPay:

Menú restaurante:

• Calibrar
• Transacciones
• Totales
• Cierre
• Acerca de

Seleccionar el botón superior izquierdo.

Se mostrará las opciones.

Opción 1 Calibrar.

Opción 2 Totales, se muestra dos opciones "TOTALES" y "DETALLES".

Al seleccionar la opción "TOTALES".

Al seleccionar la opción "DETALLES.

Seleccionar la transacción deseada y presionar el icono de tres puntos se mostrará el botón de "Reimprimir"

La terminal mostrará la generación del ticket.

Opción 3 Cierre.

Al presionar el botón de "Aceptar" se mostrará el desglose del corte realizado.

Opción 4 Acerca de.

🚧

Nota

Si durante el proceso de configuración ocurre alguna situación o falla, les recomendamos que se comuniquen con el equipo de integraciones o con su comercial para corroborar que la terminal se encuentre en el ambiente de pruebas para que validen que la terminal se encuentre en las condiciones necesarias para realizar pruebas.