Cómo personalizar la pantalla de bienvenida de tu terminal Point Smart con SDK

Para personalizar la pantalla de bienvenida de la terminal Point Smart con el SDK de Mercado Pago, debes autenticarte con el Access Token, identificar el Device ID de la terminal, enviar la configuración de pantalla de bienvenida y verificar la respuesta. Para hacerlo, debes tener una cuenta y aplicación de Mercado Pago, una terminal Point Smart vinculada y un entorno de desarrollo proparado.

Así, el negocio puede mostrar mensajes personalizados por sucursal o turno de atención sin tocar físicamente la terminal.

Este artículo explica cómo configurar esa pantalla de bienvenida desde el entorno de desarrollo, qué requisitos previos se necesitan y qué parámetros se pueden modificar.

¿Qué es el SDK de Mercado Pago para Point Smart?

El SDK de Mercado Pago es un kit de desarrollo que permite integrar y personalizar las funciones de la terminal Point Smart directamente desde el sistema punto de venta (PDV) de un negocio.

A través de este kit, los desarrolladores pueden controlar distintos aspectos de la experiencia en la terminal: desde el flujo de cobro hasta los elementos visuales que aparecen en pantalla.

La terminal Point Smart corre sobre Android y expone una API local que permite enviar instrucciones desde el PDV hacia el dispositivo, lo que da margen para ajustar la pantalla de bienvenida sin necesidad de modificar el sistema operativo del equipo.

Esta capacidad es especialmente útil para cadenas de tiendas, franquicias o negocios con múltiples terminales que necesitan mantener una imagen consistente en todos sus puntos de cobro.

Requisitos previos antes de comenzar

Para personalizar la pantalla de bienvenida, es necesario tener listo un conjunto de elementos antes de escribir una sola línea de código. Omitir alguno de estos pasos puede generar errores de autenticación o de conexión con la terminal.

Cuenta y aplicación en Mercado Pago

Se necesita una cuenta activa en Mercado Pago con acceso al panel de desarrolladores. Desde ahí se debe crear una aplicación nueva, al seleccionar la opción "Pagos en persona", que es la que habilita las funciones específicas para terminales Point.

Una vez creada la aplicación, el sistema genera tres credenciales esenciales: el Access Token, la clave secreta de webhook y el número de serie de la terminal, que aparece en la etiqueta trasera del dispositivo.

Terminal Point Smart vinculada

La terminal debe estar encendida, conectada a internet (ya sea por WiFi o por los datos 4G incluidos en el dispositivo) y vinculada a la misma cuenta de Mercado Pago desde la que se realizará la integración.

Si aún no se ha realizado este proceso, puedes seguir el paso a paso en este artículo: Cómo configurar la terminal Point Smart 2.

Entorno de desarrollo preparado

El SDK de Mercado Pago está disponible para Android e iOS desde el panel de desarrolladores. Para este flujo específico de personalización de pantalla, la integración se realiza del lado del servidor (backend), al enviar instrucciones a la terminal a través de la API de Point.

Se recomienda tener instalado el lenguaje de programación preferido (Python, Node.js, PHP o Java) y haber configurado las variables de entorno con las credenciales de la aplicación.

Paso a paso para personalizar la pantalla de bienvenida

Una vez que se tienen todos los requisitos en orden, el proceso de personalización se divide en cuatro etapas concretas. Cada una depende de la anterior, por lo que conviene seguirlas en orden.

Paso 1: autenticarse con el Access Token

Toda comunicación con la API de Mercado Pago debe incluir el Access Token en el encabezado de autorización. Este token identifica la aplicación y autoriza las instrucciones que se envían hacia la terminal. La autenticación se configura una sola vez en el entorno y aplica a todas las llamadas posteriores.

Nunca se debe exponer este token en código del lado del cliente ni en repositorios públicos; siempre debe gestionarse desde el servidor.

Paso 2: identificar el Device ID de la terminal

Antes de enviar instrucciones a una terminal específica, es necesario obtener su Device ID. Este identificador único se consulta mediante un endpoint de la API que devuelve la lista de terminales vinculadas a la cuenta. Se debe guardar este valor para los siguientes pasos.

Paso 3: enviar la configuración de pantalla de bienvenida

Con el Device ID en mano, se puede enviar la instrucción de personalización. La API de Point acepta una petición que define el contenido visual a mostrar en la pantalla de bienvenida.

Los parámetros configurables incluyen el texto principal, un subtexto o descripción, y la duración en segundos durante la cual se mostrará ese mensaje antes de que la terminal vuelva a su estado de espera.

El cuerpo de la solicitud (en formato JSON) debe incluir los campos de texto que se desean mostrar, por ejemplo:

Los textos deben ser breves y directos, ya que la pantalla de la terminal tiene un espacio visual limitado. Se recomienda no superar las 30 palabras entre título y subtítulo.

Paso 4: verificar la respuesta y gestionar errores

Si la solicitud es exitosa, la API devuelve un código HTTP 200 junto con un objeto que confirma que la instrucción fue recibida por la terminal. Si la terminal no está conectada o el Device ID es incorrecto, se recibirá un error 404 o 422. En ese caso, conviene verificar el estado de conexión del dispositivo antes de reintentar.

Para negocios con múltiples terminales, este proceso puede automatizarse al iterar sobre la lista de Device IDs obtenida en el Paso 2 y enviar la misma configuración a cada dispositivo en secuencia.

Buenas prácticas para la pantalla de bienvenida

No todas las configuraciones generan el mismo impacto. Hay decisiones de contenido que hacen que la pantalla de bienvenida cumpla mejor su función, tanto desde la experiencia del cliente como desde la operación del negocio.

El texto de bienvenida debe responder al contexto del punto de cobro: no es lo mismo una cafetería con un mensaje de "Gracias por tu preferencia" que una farmacia que muestra el nombre de la sucursal para orientar a los clientes. Adaptar el mensaje al tipo de negocio y al momento del día mejora la percepción del servicio.

También conviene evitar incluir precios, promociones o información que cambie con frecuencia directamente en la pantalla de bienvenida, ya que su actualización requiere una nueva llamada a la API.

Para contenido dinámico, Mercado Pago ofrece otras opciones dentro del flujo de cobro. Puedes explorar más sobre las posibilidades de la terminal en el artículo sobre el Smart Launcher y el rediseño de tu terminal Point.

Tu terminal Point Smart, lista para dar una mejor bienvenida

Personalizar la pantalla de bienvenida de la terminal Point Smart es un ajuste técnico con impacto directo en la experiencia del cliente: refuerza la identidad del negocio desde el primer contacto visual y permite diferenciar cada punto de cobro dentro de una operación más amplia. El proceso, una vez configurado en el entorno de desarrollo, puede replicarse y automatizarse para todas las terminales del negocio.

Si todavía no cuentas con una terminal Point Smart o estás evaluando actualizar el equipo de cobro, en Mercado Pago hay opciones pensadas para distintos tipos y tamaños de negocio. Conoce la terminal Point Smart y empieza a cobrar con todas sus herramientas disponibles.