Dispositivos de pago

Descripción general

Los dispositivos de pago son los lectores de tarjetas y las terminales que tu restaurante usa para cobrar con tarjetas de crédito y débito a través de Katalyst. Se configuran en el Back Office (oficina administrativa) y se vinculan a las tabletas del POS, a los quioscos y al cobro de cara al comensal, para que cada vez que se deslice, se inserte o se pase una tarjeta sin contacto, el cobro pase por el hardware y el procesador de pagos correctos.

Los dispositivos de pago funcionan junto con:

• La configuración de procesamiento de pagos del restaurante (qué procesador usas: CardConnect, NMI, Paynt, etc.)
• Los dispositivos móviles (iPads con licencia que ejecutan el POS, el quiosco o el KDS)
• Los centros de ingresos (qué áreas del comedor pueden usar qué terminales)

Con una configuración correcta, el personal puede cobrar sin errores de "dispositivo no configurado", la terminal puede pedir propina cuando así se configure y los recibos de tarjeta se imprimen como se espera.

Dispositivos de pago vs. dispositivos móviles

En Katalyst son dos cosas distintas. Confundirlos es una causa común de problemas de configuración.

• Creas los dispositivos de pago con un nombre y un número de serie (ID de la terminal).
• Asignas un dispositivo de pago predeterminado en cada dispositivo móvil para que ese iPad sepa qué lector usar para los pagos con tarjeta.

Consulta también Printing.md para ver cómo los dispositivos móviles manejan las impresoras de recibos y la función de servidor de impresión.

Procesadores de pagos compatibles

Cada dispositivo de pago está vinculado a un proveedor que debe coincidir con la configuración de procesamiento de tarjetas de tu restaurante.

Tu equipo de cuenta activa el procesador en la configuración de formas de pago. No puedes mezclar proveedores en un mismo dispositivo de pago: el proveedor del dispositivo debe coincidir con el procesador de tarjetas activo del restaurante para ese centro de ingresos.

Qué incluye el registro de un dispositivo de pago

Cuando agregas o editas un dispositivo de pago en el Back Office, configuras lo siguiente:

Identidad y estado

Dónde se puede usar

Cuando el POS carga los dispositivos de un centro de ingresos, muestra los dispositivos activos asignados a ese centro de ingresos (o los dispositivos que no están limitados a ninguno).

Tipo de conexión (configuración)

Las configuraciones de quiosco normalmente solo muestran dispositivos de pago cloud al iniciar sesión.

Propinas en la terminal

Si Ask for tips está activado, el monto cobrado puede incluir la propina seleccionada en el dispositivo.

Vincular dispositivos de pago al POS y al quiosco

Dispositivo de pago predeterminado (dispositivo móvil)

Cada registro de dispositivo móvil puede tener un default payment device (dispositivo de pago predeterminado):

1. Crea y activa el dispositivo de pago en el Back Office.
2. Abre el dispositivo móvil (licencia del POS) de ese iPad.
3. Configura default payment device con la terminal correcta.
4. Guarda. Las apps conectadas reciben una actualización para que el iPad use ese lector.

Si falta el dispositivo de pago predeterminado:

• Los pagos con tarjeta desde ese iPad pueden fallar con "PAYMENT DEVICE IS NOT SET" (dispositivo de pago no configurado) o "WRONG PAYMENT DEVICE" (dispositivo de pago incorrecto)
• El cobro en el quiosco no puede completar pagos con tarjeta

Tipo de cobro (dispositivo móvil)

Configura el tipo de cobro en el dispositivo móvil según cómo se usa ese iPad (dispositivo de mano del mesero vs. estación fija de cara al comensal).

Al momento del pago

Cuando el personal cobra con tarjeta, el sistema envía el pago al procesador usando el número de serie de la terminal (identificador del dispositivo). El dispositivo seleccionado debe:

• Estar activo
• Coincidir con el proveedor del restaurante
• Estar permitido para el centro de ingresos de la cuenta
• Ser el predeterminado del dispositivo móvil (o haberse elegido explícitamente en el flujo de pago, según la versión del POS)

Crear un dispositivo de pago (paso a paso)

Antes de empezar

1. El procesamiento de tarjetas está configurado en las formas de pago del restaurante (IDs de comercio, claves de API, etc.).
2. Tienes el número de serie / HSN de la terminal, que te da el procesador o que viene en la etiqueta del dispositivo.
3. Sabes qué centros de ingresos deben usar este lector.

1. Agrega el dispositivo en el Back Office

• Ve a los dispositivos de pago del restaurante.
• Crea un dispositivo nuevo.
• Ingresa el title y el serial number (obligatorios, a menos que uses flujos con código de registro para proveedores específicos).
• Selecciona el provider (debe coincidir con tu procesador de tarjetas).
• Activa active.
• Asigna revenue centers si el lector no se usa en todo el local.
• Configura el tipo de conexión en la configuración si tu implementación usa nube o Bluetooth.
• Activa ask for tips si los comensales deben dejar la propina en el lector.

2. Prueba la conexión (CardConnect / Bolt)

En los restaurantes con CardConnect, el Back Office puede hacer ping a un dispositivo por su número de serie para confirmar que:

• Las credenciales de la Bolt API son válidas
• La terminal responde en la red

Si el ping falla, verifica el número de serie, la red y las credenciales del procesador antes de empezar a usarla.

3. Vincúlalo a cada iPad del POS

• Para cada licencia de dispositivo móvil que se use para cobrar:
  • Configura default payment device con esta terminal (o con la correcta para cada estación).
  • Confirma el checkout type (tipo de cobro): estándar o de cara al comensal.

4. Verifica en el salón

• Inicia sesión en el POS en ese iPad.
• Haz un pago de prueba con tarjeta por un monto pequeño (o usa el modo de capacitación si está disponible).
• Confirma la aprobación, la solicitud de propina (si está activada) y la impresión del recibo.

Licencias de dispositivos móviles (contexto)

Los dispositivos de pago no reemplazan las licencias de dispositivos móviles. El flujo típico es:

1. Genera una licencia en el Back Office para un iPad de POS, quiosco o KDS.
2. El personal ingresa la licencia en el dispositivo para activarlo.
3. Asigna el dispositivo de pago predeterminado, la impresora predeterminada y, opcionalmente, el servidor de impresión en el registro de ese dispositivo móvil.

Desactivar la licencia de un dispositivo móvil cierra las sesiones en ese iPad. Desactivar un dispositivo de pago detiene los cargos con tarjeta nuevos en esa terminal, pero no desactiva el iPad.

Pagos con tarjeta, lotes y liquidación

Pagos con tarjeta en las cuentas

Los pagos con tarjeta exitosos guardan:

• El tipo de tarjeta y los últimos cuatro dígitos
• Las propinas (desde el POS o desde la terminal si Ask for tips está activado)
• El dispositivo de pago utilizado

Estos datos alimentan los reportes, los cortes de caja (propinas con tarjeta de crédito) y la conciliación.

Liquidación por lotes (Paynt)

En las implementaciones con Paynt, las transacciones con tarjeta pueden quedar en un lote abierto hasta que se ejecuta el cierre de lote (a menudo de forma programada). Los lotes sin liquidar afectan cuándo aparecen los fondos en los reportes del procesador. Revisa el portal de tu procesador para conocer los tiempos de liquidación.

Captura diferida

Algunos proveedores (NMI, Paynt) admiten la captura diferida: se autoriza ahora y se captura después. El comportamiento depende de la configuración del procesador y de si el pago usó flujos sin contacto o con token que requieren captura inmediata.

Tarjetas de regalo y de lealtad en los lectores

En las configuraciones de CardConnect con la opción de deslizar activada, se puede usar el mismo número de serie del dispositivo de pago para leer tarjetas de regalo al deslizarlas cuando el flujo de pago requiere un dispositivo. Si tu procesador no permite deslizar, el personal ingresa el número de la tarjeta manualmente.

Las funciones de lealtad y de tarjetas de regalo dependen tanto de la configuración de las formas de pago como de las capacidades del proveedor.

Relación con otras funciones

Solución de problemas comunes con dispositivos de pago

"Payment device is not set" / "Wrong payment device"

Revisa:

• Que el dispositivo móvil tenga asignado un default payment device
• Que el dispositivo de pago esté activo
• Que el proveedor del dispositivo de pago coincida con el procesador de tarjetas del restaurante
• Que la app del POS haya actualizado la configuración del restaurante (vuelve a iniciar sesión si es necesario)

"Payment device unable to connect" / "Can't connect to the device"

Revisa:

• Que la terminal esté encendida y en la misma red que exige el procesador
• Que el número de serie coincida con el dispositivo físico (sin errores de escritura)
• CardConnect: ejecuta la prueba de Bolt ping desde el Back Office
• Que las credenciales del procesador (ID de comercio, claves de API) sean válidas en la configuración de formas de pago
• Que las reglas del firewall o de la VLAN permitan la comunicación entre la terminal y la nube

"Need to choose payment device" / "Need to select payment device"

Revisa:

• Que el flujo de pago requiera un dispositivo (para deslizar) pero no se haya indicado ninguno: asigna uno predeterminado en el dispositivo móvil o selecciona el dispositivo en el POS
• Para deslizar tarjetas de regalo, confirma que usas CardConnect y que la opción de deslizar está disponible

Las propinas no aparecieron en el pago

Revisa:

• Que Ask for tips esté activado en el registro del dispositivo de pago
• Que estén configurados los porcentajes de propina predefinidos del cobro del restaurante
• Que el proveedor haya devuelto el monto de la propina desde la solicitud en la terminal

La tarjeta funciona en un iPad pero no en otro

Revisa:

• Que el default payment device de cada dispositivo móvil apunte al lector correcto
• Que el centro de ingresos de la cuenta permita el centro de ingresos asignado a ese dispositivo
• Que solo una estación use un lector a la vez si el procesador bloquea el dispositivo por sesión

El dispositivo no aparece en el quiosco

Revisa:

• Que el dispositivo de pago esté activo
• Que el tipo de conexión sea cloud (el quiosco solo muestra dispositivos en la nube)
• Que el dispositivo esté vinculado como default payment device del dispositivo móvil del quiosco

Los pagos se aprueban pero con el centro de ingresos o el comercio equivocado

Revisa:

• La asignación de centro de ingresos del dispositivo vs. el centro de ingresos de la cuenta
• Las credenciales de procesamiento de tarjetas a nivel de centro de ingresos vs. a nivel de restaurante

Un dispositivo de pago desactivado sigue apareciendo en el POS

Revisa:

• El POS puede guardar en caché la lista de dispositivos hasta que se actualice; el personal debe cerrar sesión y volver a iniciarla
• Confirma que el dispositivo esté inactivo en el Back Office y que el predeterminado del dispositivo móvil se haya cambiado a una terminal nueva

Lista de verificación de configuración (terminal nueva)

• Procesador de tarjetas configurado en las formas de pago del restaurante
• Dispositivo de pago creado con el title, el serial number y el provider correctos
• Dispositivo marcado como active
• Centros de ingresos asignados (si está limitado)
• Ask for tips configurado correctamente
• Conexión probada (ping o transacción de prueba)
• Cada dispositivo móvil del POS o del quiosco tiene el default payment device correcto
• El checkout type corresponde a la estación (estándar o de cara al comensal)
• Pago de prueba y recibo verificados en el salón

Lista de verificación de la operación diaria

• Terminales encendidas antes del servicio
• El iPad de cada estación con la sesión iniciada y mostrando el lector esperado
• Pagos fallidos revisados (problema de conexión vs. tarjeta rechazada)
• Al final del día: lotes y liquidación revisados según tu procesador (sobre todo con Paynt)
• Hardware nuevo registrado en el Back Office antes del servicio si se cambian terminales

Glosario

Esta guía refleja el funcionamiento del producto en la plataforma Katalyst POS. Los nombres de los procesadores, los modelos de terminal y las etiquetas de los menús del Back Office en tu implementación pueden variar. Comunícate con tu equipo de cuenta y con tu procesador de pagos para obtener los IDs de comercio, las credenciales y los pasos de vinculación del hardware específicos de tu sucursal.