Netpay

Introducción SDK.

Integración con SDK y Smart PinPad.

Este tipo de integraciones va enfocada para clientes que tienen una aplicación móvil y requieren integrarse en la misma terminal. Esta integración es muy sencilla de realizar, ya que solo se requiere incorporar la librería y acceder a los métodos correspondientes. De esta forma, la aplicación móvil se comunicará con la aplicación de Smart PinPad y se podrá proceder a realizar las ventas de tu negocio.

Diagrama de Integración SDKDiagrama de Integración SDK

Diagrama de Integración SDK

Antes de empezar.

1. Requisitos.
2. Instalación de Smart PinPad DEV.
3. Login.
4. Configuración de la terminal (opcional).
5. Actualizar Launcher Smart (opcional).
6. Ambiente Sandbox.

1. Requisitos.

• Contar con una terminal Smart. Si no cuenta con una, revisar con el equipo comercial con el que se puso en contacto.

• Contar con tarjetas para realizar las pruebas ( tarjetas con NIP, sin NIP, debito y crédito).
Nota: Se pueden utilizar tarjetas propias ya sean canceladas o vencidas ( Se trabaja en un ambiente de pruebas con Dummys que simulan una transacción; Sin embargo si se utilizan tarjetas con NIP tener cuidado de ingresar el correcto ya que esa validación si la realiza y puede ocasionar el bloqueo de la tarjeta).

• Terminal Smart en modo debug, solo para integraciones.

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

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

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

• Incorporar la librería y acceder a los métodos correspondientes en la aplicación móvil.

• Nivel mínimo de API admitido 22 (Android 5.1 Lollipop).

• Versiones de Android soportadas en la terminal:

Nombre código

Número de versión

Nivel de API

Lollipop

5.1-5.1.1

22

Marshmallow

6.0-6.0.1

23

Nougat

7.0-7.1.2

24-25

Oreo

8.0-8.1

26-27

2. Instalación de la SmartPinPad 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 aplicaciones, actualizarlas, actualizar versión del S.O. de la terminal, ver el estatus de los componentes, entre otras cosas.

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

Al seleccionar la versión "1.2.8_20210203" 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”.

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

4. Configuración de la terminal (opcional).

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.

Habilitar la configuración de propina en el menú de la terminal.

Esta opción puede ser utilizada cuando el cliente implementó en su método de pago el uso de la propina.

Habilitar las siguientes opciones en la terminal.
Esta opcion puede ser habilitada de manera opcional ya que puede servir de apoyo al comercio para validar transacciones en la terminal, reimpresión de ticket o si se requiere realizar cortes de caja.

  • Menú de restaurante:
    Esta configuración permite habilitar las siguientes opciones en la pantalla inicial de NetPay:
  1. Calibrar
  2. Transacciones
  3. Totales
  4. Cierre
  5. Acerca de

📘

Nota

Las opciones habilitadas por default en la terminal son las siguientes:

  • Meses sin intereses: Esta opción permite tener habilitadas las banderas de MSI dependiendo las que el cliente valla a implementar ( 3, 6 , 9 , 12 y 18 Meses)
  • Cierre Automático: Esta opción ayuda a que cuando la terminal llegue aprox. a 450 transacciones se realice un corte automático, el cual permitirá que las transacciones no se queden guardadas en la terminal y por ende se quede sin memoria.
  • Token Registrado: Este apartado solo es informativo para esta integración y no tiene impacto si muestra "Registrado" o "N/A" ya que este apartado es para la generación de token de acceso para otro tipo de integración por API.

Regresar con la flecha de retorno.

La aplicación regresará a la pantalla de NetPay.

5. Actualizar Launcher Smart (opcional).

Si instalaste tu aplicación propia y no se visualiza como icono en la pantalla principal de la Smart PinPad es recomendable tener la última versión de la aplicación "Launcher Smart" debido a que permitirá poder visualizar la aplicación propia de la empresa como icono antes y después que haya sido validado y certificado por NetPay.

Primero debemos ir al Market place y realizar una búsqueda.

La búsqueda será específicamente de la aplicación de "Launcher Smart" y después de la búsqueda procederemos a presionarla como se indica en la imagen para ver mas información de la aplicación.

Al realizar el paso anterior veremos mas información de la aplicación se deberá presionar la opción de Actualizar para tener la última versión y esperar a que se descargué.

Finalmente se instala y ya nos indicará que esta en funcionamiento y podremos regresar a la pantalla principal a visualizar nuestras aplicaciones como iconos.

6. 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:
http://nubeqa.netpay.com.mx:3334

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.

Updated 5 months ago


Que sigue...

Pasos a seguir para integrar el SDK de NetPay.

Smart SDK.

Introducción SDK.


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.