Conoce los módulos, roles y flujos de la app nativa de cobros para terminales SmartPOS
🚧 Early Release — Beta
Este producto está en acceso temprano. Los parámetros, estructuras de respuesta y comportamientos pueden cambiar sin previo aviso. No uses esta versión en producción sin coordinarlo previamente con el equipo de integraciones de Kushki.
La Kushki ONE Payment App es la aplicación nativa que corre directamente en las terminales SmartPOS (Sunmi P2 SE, Sunmi P3). Su propósito es doble: permite al operador de caja procesar pagos con tarjeta de forma autónoma, y al administrador del comercio consultar ventas, propinas y reportes sin salir del dispositivo.
El operador ingresa el monto y el cliente presenta su tarjeta por NFC, chip o banda magnética. La terminal envía la solicitud de autorización a través de Kushki hacia la red de la tarjeta. El resultado, Aprobado o Rechazado, se muestra en pantalla y queda registrado automáticamente en la Lista de Ventas.Cada transacción aprobada genera:
Un Ticket # único de 18 dígitos, que sirve como referencia tanto en la terminal como en el portal Kushki.
Un comprobante imprimible con copia para el cliente y copia para el comercio.
Un registro disponible para envío por correo electrónico, de forma individual o como reporte consolidado.
Los rechazos también quedan registrados
Las transacciones rechazadas aparecen en la Lista de Ventas con estado Rechazado y sin Ticket # asignado. Eso permite al administrador auditar los intentos fallidos.
Las funcionalidades de la app se habilitan en dos capas, y conviene entender la diferencia antes de buscar una opción que no aparece.
Nivel
Quién lo controla
Qué define
Kushki
El equipo de Kushki, durante la activación de tu terminal
Si la funcionalidad está disponible para tu comercio, y sus límites máximos
Terminal
El administrador del comercio, desde Configuración
Cómo se comporta la funcionalidad en el día a día
Si una opción no aparece en Configuración
Significa que aún no está habilitada a nivel de Kushki para tu comercio. El administrador no puede activarla desde la terminal: contacta a tu account manager.
Por ejemplo, las propinas requieren que Kushki las habilite primero. Una vez habilitadas, el administrador decide desde la terminal si son por porcentaje o monto fijo y qué tres valores rápidos se ofrecen al cliente.
Dos roles usan la app de forma distinta. Conocer la diferencia evita que el operador acceda a configuraciones que no le corresponden.
Rol
Acceso típico
Guías relevantes
Operador de caja
INICIO, Lista de Ventas
Procesa un cobro · Devoluciones · Pago Dividido
Administrador
Configuración, Resumen de Ventas, Gestión de Usuarios
Configuración del terminal · Consulta tus transacciones · Auth & Capture
El acceso de administrador no tiene restricciones internas
Un operador con Acceso de Administrador puede modificar cualquier parámetro del terminal, incluyendo deshabilitar los controles de devolución. Asigna ese nivel solo a personal de confianza.
Procesa un cobro
Empieza con el flujo principal: ingresa el monto, presenta la tarjeta y gestiona el resultado.
Configuración del terminal
Ajusta usuarios, propinas, recibos y devoluciones antes de empezar a operar.
