| Tabla de Contenido |
|
|
Descubre los conceptos básicos, la arquitectura y los modos de operación de nuestra solución omnicanal de pagos presenciales.
Kushki ONE está disponible exclusivamente para comercios en 🇲🇽 México, 🇨🇱 Chile y 🇵🇪 Perú.
1. ¿Qué es Kushki One?
Kushki One es la solución de pagos presenciales (Card Present) de Kushki. Permite a los comercios aceptar pagos con tarjeta física a través de terminales SmartPOS, tanto de manera autónoma como integrada con sistemas externos como POS, ERPs o aplicaciones propias.
Su arquitectura está pensada para adaptarse a distintos modelos de negocio: desde el uso manual directo en el terminal hasta integraciones técnicas complejas vía API.
2. Componentes principales
2.1 Terminales SmartPOS
Kushki One opera sobre terminales Android de la línea Sunmi, específicamente:
- Sunmi P3: terminal portátil de alta gama con impresora integrada.
- Sunmi P2 SE: terminal compacto para operaciones más ligeras.
Estas terminales cuentan con pantalla táctil, conectividad Wi-Fi y 4G, lector de chips ICC, banda magnética MCR y NFC para pagos sin contacto.
2.2 Aplicación de pago Kushki One Payment App (Atom)
Es la aplicación nativa instalada en las terminales. Desde ella, es posible:
- Realizar ventas, autorizaciones y capturas directamente.
- Gestionar devoluciones.
- Consultar el historial de transacciones con filtros.
- Revisar reportes de cierre (Sales Summary).
- Configurar propinas y ajustes locales de la terminal.
2.3 Kushki One Connect (API de integración)
Es la capa de integración que permite a sistemas externos (POS, ERP, apps del comercio) enviar instrucciones a la terminal sin que el operador deba ingresar manualmente los montos. Se comunica mediante peticiones HTTP REST.
3. Modos de operación
El comportamiento de la terminal depende del modo en que esté configurada:
| Modo | Descripción |
|---|---|
| Standalone (Autónomo) | El operador usa la terminal como una calculadora avanzada. Ingresa los montos manualmente, selecciona el tipo de pago y opera de forma completamente independiente. No requiere integración con sistemas externos. |
| Semi-integrado | La pantalla de la terminal queda bloqueada en "Esperando llamada". Un sistema externo (POS o software del comercio) envía las instrucciones de cobro vía API. El operador solo interactúa con la terminal para presentar la tarjeta o confirmar el monto. |
4. Arquitectura general
Kushki One se apoya en dos servicios en la nube que trabajan en conjunto:
| Servicio | Función |
|---|---|
| Console TMS | Sistema de gestión de terminales (DMS) accesible por el equipo interno de Kushki. Desde aquí se configuran los comercios, se gestionan los templates de terminales y se monitorea el estado de los dispositivos. |
| Cloud TMS | Servicio intermediario que recibe las peticiones del Console TMS y las reenvía a las terminales físicas. También expone la API de Kushki One Connect para las integraciones semi-integradas. |
La información de los comercios (nombre, ID, credenciales, configuración de diferidos, etc.) se origina en la Consola de Kushki y se replica al DMS para que las terminales puedan operar correctamente.
5. Operaciones disponibles
La Kushki ONE Payment App soporta el ciclo completo de una transacción de venta presente:
| Operación | Descripción |
|---|---|
| Venta | Cobro en un solo paso. Admite propina, cuotas comercio, cuotas emisor y cashback. |
| Autorización | Reserva el cupo en la tarjeta para un posterior cobro. |
| Captura | Cobra un monto previamente autorizado. |
| Re-autorización | Modifica el monto autorizado o extiende el plazo para aplicar la captura. |
| Devolución | Retorna el dinero de una venta. El sistema ejecuta internamente un void o un refund según el momento de ejecución. |
| Post Propina | Ingresa un monto de propina posterior a la autorización de la transacción. |
| División de cuenta | Divide un monto total en múltiples pagos secuenciales (iguales o desiguales). Útil en restaurantes. |
6. Flujo completo de una transacción
El siguiente flujo describe la interacción entre todos los componentes desde que se inicia una intención de cobro hasta recibir la respuesta:
Diagrama: Flujo completo de una transacción en Kushki One
- Generación de la solicitud: El sistema de caja del comercio (POS) genera la solicitud enviando el monto a cobrar vía API hacia el ecosistema de pagos.
- Decisión y Enrutamiento: Kushki ONE Connect recibe la solicitud y toma una decisión de enrutamiento basándose en la configuración que haya elegido el comercio; de esta manera, enruta la petición hacia el dispositivo físico, ya sea a través de la Nube o mediante la Red Local.
- Recepción en la terminal y captura de datos: Kushki ONE Connect envía la petición de cobro a la Terminal SmartPOS. La terminal recibe la petición, muestra el monto a pagar en pantalla y lee la tarjeta del cliente.
- Procesamiento de la transacción: Una vez leídos los datos, la terminal envía la información hacia Kushki, quien se encarga finalmente de procesar la transacción financiera.
Preguntas frecuentes (FAQ)
¿Kushki One reemplaza los métodos de pago online que ya tengo?
No. Kushki One es una solución exclusiva para pagos presenciales (Card Present). Si tu negocio opera con pagos en línea (Card Not Present), ambas soluciones coexisten de forma independiente.
¿Necesito una integración técnica para usar Kushki One?
No necesariamente. En modo Standalone, el operador puede usar la terminal directamente sin ninguna integración. La integración técnica es necesaria solo si quieres que un sistema externo (como un POS o software de caja) controle el flujo de cobro.
¿Qué pasa si la terminal pierde conexión a internet?
Depende del modo de operación. En Standalone, la terminal puede operar en modo offline con capacidades limitadas. En modo Semi-integrado, la pérdida de conexión interrumpe la comunicación con el sistema externo. Para detalles técnicos de conectividad, consulta el artículo de arquitectura de red.