1. Kushki One App de Pagos
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • Códigos de error
    • Datos de prueba
    • Últimas novedades
  • Glosario de pagos
    • Glosario de pagos
  • Pagos únicos con tarjeta (Online)
    • Network Tokens
    • Funcionalidades por modelo de negocio
    • Marcas de tarjeta soportadas
    • Pagos en un paso
      • Cargo directo (sin token)
      • Códigos de error autenticación OTP
      • ¿Cómo funcionan los pagos con tarjeta?
      • Acepta un pago con tarjeta
      • Acepta pagos únicos con OTP
      • Códigos de error pagos únicos con tarjeta
    • Pagos en dos pasos
      • Recibe pagos con autorización y captura
      • ¿Cómo funcionan los pagos únicos con autorización y captura?
    • Pagos con Webpay Plus
      • Reserva fondos con Webpay Plus
    • Pagos con Apple Pay
      • Pruebas en Sandbox Apple Pay
      • Configuración de Apple Pay
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Introducción a 3DS
      • Integración 3DS API + librería kushki.js
      • Integración 3DS con librería kushki.js
      • Integración 100% API de 3DS
      • Códigos de error autenticación 3DS
  • Pagos recurrentes con tarjeta (Online)
    • Autentica tus suscripciones con 3DS
    • Apple Pay en Suscripciones
    • Suscripciones externas a Kushki
    • Acepta pagos one click con 3DS
    • Funcionalidades por modelo de negocio
    • Códigos de error en cargos recurrentes
    • Pagos calendarizados
      • Maneja tus cargos calendarizados
      • Crea un cargo recurrente
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
    • Pagos calendarizados con Webpay OneClick
      • Reserva fondos en recurrencias con Webpay OneClick
      • Recurrencias con Webpay OneClick
    • Pagos OneClick con Webpay OneClick
      • Pagos one click con Webpay OneClick
      • Reserva fondos en pagos one click con Webpay OneClick
    • Pagos OneClick
      • ¿Cómo funcionan los pagos OneClick con autorización y captura?
      • Recibe pagos OneClick con autorización y captura
      • Genera pagos one click
  • Pagos con tarjeta presente
    • Acepta pagos con tarjeta presente
    • Datos de prueba
    • Webhooks para tarjeta presente
    • Raw card-present API
      • Script de ejemplo para cifrar información
      • Acepta pagos
      • Intercambio de claves criptográficas
      • Preguntas frecuentes
      • Códigos de error para transacciones con tarjeta presente
    • Transacciones
      • Anula un pago
      • Transacciones
    • Kushki One
      • Autenticación y Cifrado de Requests
      • Realiza cobros con Kushki One
      • Formato de montos en Kushki ONE
      • Impresión en terminal SmartPOS
      • Catálogo Unificado de Errores — Kushki ONE Connect
      • Servicios asíncronos y webhooks
    • Kushki One App de Pagos
      • Procesa un cobro
      • Devoluciones y PreAuth & Capture
      • Pago Dividido en la terminal
      • Configuración del terminal
      • Consulta tus transacciones
  • Pagos con transferencias
    • Recibe transferencias bancarias
    • Consulta el estado de una transacción
    • Bancos y detalles de operación para pagos con transferencia bancaria
  • Pagos en efectivo
    • Acepta un pago en efectivo
    • Puntos de recaudo
    • Códigos de error para transacciones declinadas en efectivo
  • Dispersión de dinero
    • Transferencia bancaria
      • ¿Cómo funciona la dispersión por transferencia bancaria?
      • Códigos de error para dispersiones por transferencia
      • Dispersa a cuentas bancarias
  • Plugins
    • Shopify
      • Shopify
      • Operación del Plugin
    • Vtex
      • Guía de integración VTEX
  • Links de pago
    • Smartlinks
  • Formularios y botones de pago
    • Introducción
    • Kajita
      • Kajitas de pago
      • ¿Cómo funciona?
    • Botón de pago
      • Genera un botón de pago
      • ¿Cómo funciona el botón de pago?
  • Administración de sucursales
    • ¿Cómo realizar el onboarding de subcomercios vía API?
  • Notificaciones
    • Buenas prácticas
    • Consulta tus webhooks
    • Webhooks para pagos únicos
      • Webhook para pagos únicos con tarjeta
      • Webhook para pagos únicos con transferencia bancaria
      • Webhook para pagos únicos con efectivo
      • Webhook para pagos con Webpay Plus
    • Webhooks para pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
      • Webhook para pagos recurrentes con Webpay OneClick
    • Webhooks para dispersiones
      • Webhook para dispersión de dinero con transferencia
    • Webhooks para botón de pagos
      • Webhooks con Botón de pago
    • Webhooks para smartlinks
      • Webhooks con Smartlinks
    • Webhooks para devoluciones
      • Webhook para devoluciones
      • Webhook para contracargos
HomeMexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱
Colombia 🇨🇴Peru 🇵🇪
HomeMexico 🇲🇽Ecuador 🇪🇨Chile 🇨🇱
Colombia 🇨🇴Peru 🇵🇪
Status
Soporte / Support
Español
  • Español
  • English
  1. Kushki One App de Pagos

Procesa un cobro

Acepta pagos con tarjeta en modo semi-integrado desde tu terminal 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.
Este es el flujo principal del operador de caja. Desde la pestaña INICIO se elige la operación Venta, se ingresa el monto, el cliente elige cómo pagar y la terminal gestiona la autorización completa de forma autónoma, sin necesidad de ninguna acción adicional desde el sistema del comercio.
¿La cuenta se reparte entre varias personas?
Usa la operación Pago Dividido en lugar de Venta. Reparte el total en varios pagos consecutivos, cada uno con su propia tarjeta.

Antes de empezar#

Verifica esto primero
La terminal encendida y conectada a la red.
El operador con sesión iniciada usando su usuario personal.
Si aún no se crearon usuarios, revisa Gestión de usuarios.

Paso 1 — Ingresa el monto#

Desde la pestaña INICIO, toca Venta en el menú de operaciones. La terminal muestra el teclado numérico con el encabezado Venta. Ingresa el monto de la transacción y toca el botón de confirmación, el ícono de check azul.
Pantalla de ingreso de monto en la app
El monto se ingresa en la moneda de tu terminal
La moneda la configura Kushki por terminal durante la activación. La app la aplica automáticamente, con la cantidad de decimales que corresponde a tu país.

Paso 2 — Propina#

Paso condicional
Solo aparece si el comercio tiene propinas habilitadas. Si no aplica, la app pasa directamente al Paso 3. Las opciones disponibles se definen en Configuración de propinas.
La terminal presenta al cliente la pantalla ¿Agregar Propina?. El cliente elige entre las opciones preconfiguradas, selecciona Personalizado para ingresar un valor libre, o toca Sin Propina.
Pantalla de selección de propina
La propina se suma al subtotal para formar el total que se cobra a la tarjeta, y queda registrada como campo separado en el comprobante.

Paso 3 — Selección de cuotas#

Paso condicional
Solo aparece si tu comercio tiene cuotas habilitadas y el monto supera el umbral configurado. Si no aplica, la app pasa directamente al Paso 4.
La app muestra la pantalla Opciones de cuotas. El cliente o el operador elige entre:
OpciónDescripción
Pagar CompletoCobra el monto total en un solo cargo. Aparece seleccionado por defecto
X cuotasDivide el monto en cuotas, según las opciones habilitadas para tu comercio y el emisor de la tarjeta. La app calcula y muestra el valor de cada cuota
Pantalla de opciones de cuotas
Toca Confirmar para avanzar.

Paso 4 — Presentación de la tarjeta#

La terminal muestra la pantalla de espera de tarjeta con el monto confirmado y tres métodos de ingreso. El cliente presenta su tarjeta según prefiera.
MétodoDescripción
Contactless (NFC)El cliente acerca la tarjeta o el dispositivo al lector. Es el método más rápido
ChipEl cliente inserta la tarjeta en la ranura inferior de la terminal
Banda magnéticaEl cliente desliza la tarjeta por el lector de banda. Disponible como respaldo
Pantalla de espera de tarjeta
El operador puede cancelar la transacción en cualquier momento desde esta pantalla tocando Cancel Sale.
Esta pantalla aún no está traducida
En la versión actual de la terminal, la pantalla de espera de tarjeta muestra sus textos en inglés incluso con la interfaz en español: Ready when you are, Tap, Insert, Swipe, Cancel Sale e Included tip. El monto también aparece sin separador de miles.
Tenlo en cuenta al capacitar a los operadores.

Paso 5 — Firma digital#

Paso condicional
Solo aplica a determinadas transacciones con tarjeta de crédito, según las reglas del banco emisor. No todas lo requieren.
La terminal solicita la firma del cliente en la pantalla táctil. El cliente firma con el dedo o con un stylus y toca Confirmar. Si necesita corregir, usa Limpiar para borrar y volver a firmar.
Pantalla de firma digital

Paso 6 — Procesamiento#

Mientras la terminal se comunica con la red de la tarjeta aparece la pantalla de espera con el monto en proceso. Este paso suele durar entre 2 y 5 segundos con buena conectividad.
Pantalla de procesamiento

Paso 7 — Resultado#

Aprobado#

Si la autorización es exitosa, la app muestra la pantalla Aprobado con el mensaje "cobrado exitosamente" y genera el comprobante automáticamente.
Pantalla de transacción aprobada
Desde esta pantalla el operador tiene tres opciones para el comprobante:
AcciónDescripción
CORREOEnvía el comprobante por email al cliente o al registro del comercio
PAYLOVEEnvía el comprobante al programa de fidelización del cliente, si tu comercio lo tiene habilitado
OMITIRCierra el flujo sin envío digital. La transacción queda registrada en la Lista de Ventas
El botón Imprimir en la parte inferior genera el comprobante físico en la impresora integrada.
El Ticket # es la referencia de la transacción
El Ticket # de 18 dígitos que aparece en la pantalla Aprobado identifica la transacción tanto en la terminal como en el portal Kushki. Compártelo con el cliente si necesita hacer seguimiento posterior.

Rechazado#

Si la autorización falla, la terminal muestra la pantalla Rechazado con el motivo, cuando el procesador lo provee. La transacción queda registrada en la Lista de Ventas con estado Rechazado y sin Ticket # asignado.
Qué hacer ante un rechazo:
1.
Verifica que la tarjeta tenga fondos suficientes y que no esté bloqueada.
2.
Intenta con otro método de ingreso. Si falló por contactless, prueba con chip.
3.
Si el problema persiste, solicita al cliente una tarjeta alternativa.
Devoluciones y Auth & Capture
Aprende a procesar reembolsos y a gestionar preautorizaciones desde la terminal.
Configuración del terminal
Ajusta cuotas, propinas, usuarios y recibos según las necesidades de tu comercio.
Modificado en 2026-10-19 14:46:38
Anterior
Kushki One App de Pagos
Siguiente
Devoluciones y PreAuth & Capture
Built with