1. Kushki One App de Pagos
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Últimas novedades
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • Datos de prueba
    • Códigos de error
  • Glosario de pagos
    • Glosario de pagos
  • Pagos únicos con tarjeta (Online)
    • Network Tokens
    • Marcas de tarjeta soportadas
    • Funcionalidades por modelo de negocio
    • Guía de integración Comisiones a terceros
    • ¿Cómo funcionan las Comisiones a terceros?
    • Pagos en un paso
      • Acepta un pago con tarjeta
      • Cargo directo (sin token)
      • ¿Cómo funcionan los pagos con tarjeta?
      • Acepta pagos únicos con OTP
      • Códigos de error autenticación 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?
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Integración 3DS API + librería kushki.js
      • Introducción a 3DS
      • Integración 100% API de 3DS
      • Integración 3DS con librería kushki.js
      • Códigos de error autenticación 3DS
    • Pagos con Apple Pay
      • Configuración de Apple Pay
      • Pruebas en Sandbox Apple Pay
  • 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
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
      • Maneja tus cargos calendarizados
      • Crea un cargo recurrente
    • Pagos OneClick
      • Genera pagos one click
      • Recibe pagos OneClick con autorización y captura
      • ¿Cómo funcionan los pagos OneClick con autorización y captura?
  • Pagos con tarjeta presente
    • Acepta pagos con tarjeta presente
    • Datos de prueba
    • Webhooks para tarjeta presente
    • Cloud Terminal API
      • Acepta pagos
      • Anula una solicitud de pago
      • Consulta el estado de una petición de cobro
      • ¿Cómo imprimir un ticket personalizado?
    • App-to-app
      • Acepta pagos
    • Transacciones
      • Anula un pago
      • Transacciones
    • Terminal SDK
      • Acepta pagos
    • 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
    • Raw card-present API
      • Acepta pagos
      • Script de ejemplo para cifrar información
      • Intercambio de claves criptográficas
      • Preguntas frecuentes
      • Códigos de error para transacciones con tarjeta presente
    • Kushki One App de Pagos
      • Devoluciones y PreAuth & Capture
      • Procesa un cobro
      • Pago Dividido en la terminal
      • Consulta tus transacciones
      • Configuración del terminal
  • Pagos con transferencias
    • Bancos y detalles de operación para pagos con transferencia bancaria
    • Recibe transferencias bancarias
    • Consulta el estado de una transacción
  • Dispersión de dinero
    • Transferencia bancaria
      • Dispersa a cuentas bancarias
      • Códigos de error para dispersiones por transferencia
  • Plugins
    • Shopify
      • Operación del Plugin
    • Vtex
      • Guía de integración VTEX
  • Links de pago
    • Smartlinks
  • Formularios y botones de pago
    • Kajita
      • Kajitas de pago
      • ¿Cómo funciona?
    • Botón de pago
      • ¿Cómo funciona el botón de pago?
      • Genera un 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
    • 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 pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
    • 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

Devoluciones y PreAuth & Capture

Procesa reembolsos totales o parciales y gestiona preautorizaciones directamente 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.
Dos flujos de operador avanzado que requieren configuración previa y, en algunos comercios, credenciales de administrador.

Devoluciones#

Antes de empezar#

Requisitos
Las devoluciones deben estar habilitadas en Configuración → Configuración de Devoluciones. Si el parámetro Requerir Aprobación del Supervisor está activo, ten a mano las credenciales de un usuario administrador antes de iniciar el flujo.
La devolución puede ser total, por el monto completo de la venta original, o parcial, por un valor menor. En ambos casos la app registra el motivo y genera un nuevo Ticket # para el reembolso.
Una devolución puede tardar días en reflejarse
La app usa una sola palabra, Devolución, para dos operaciones distintas que se resuelven en tiempos muy diferentes:
Antes del horario de corte del día de la venta, la operación es una anulación: el monto nunca se debita de la cuenta del cliente.
Después del corte, la operación cae en el ciclo de reembolso y puede tardar días hábiles en verse reflejada en el estado de cuenta del cliente.
PaísHorario de corte (hora local)
México23:59 del día de la transacción
Si procesas una devolución cerca del cierre, avísale al cliente que el dinero puede tardar varios días en aparecer. La terminal muestra Aprobado en ambos casos.

Paso 1 — Localiza la transacción original#

Ve a Transacciones → Lista de Ventas, usa los filtros para encontrar la venta y toca la tarjeta para abrir el detalle. Dentro del detalle, selecciona Devolución.
También hay un acceso directo en INICIO
La operación Devolución aparece además en el menú de operaciones de la pestaña INICIO. Esta guía documenta la ruta desde la Lista de Ventas, que es la que te permite verificar la transacción original antes de reembolsarla.
Listado de ventas en la app

Paso 2 — Elige el tipo de devolución#

La app muestra el monto original y dos opciones:
OpciónDescripción
Monto completoDevuelve el 100% del valor original. El monto se precarga automáticamente
PersonalizadoActiva el teclado numérico. El encabezado muestra en tiempo real cuánto estás devolviendo del total
Selección del tipo de devolución
Confirma el monto tocando el botón de check azul.

Paso 3 — Selecciona el motivo#

La app requiere justificar la devolución antes de procesarla. Las opciones son Artículo Incorrecto, Daño, Cliente Insatisfecho y Otro.
Selector de motivo de devolución
Selecciona el motivo y toca Confirmar.

Paso 4 — Procesamiento y confirmación#

La terminal procesa el reembolso con la red de la tarjeta. Si es aprobado, muestra la pantalla Aprobado con el mensaje "reembolsado exitosamente" y un nuevo comprobante.
Pantalla de reembolso exitoso
AcciónDescripción
ImprimirImprime el comprobante de devolución en la terminal
CorreoEnvía el comprobante al email del comercio o del cliente
OmitirCierra el flujo sin generar comprobante

Cómo se ve la devolución en la Lista de Ventas#

Una vez procesada, la devolución aparece en el detalle de la transacción original con este desglose:
Detalle de una devolución parcial
CampoQué representa
Venta OriginalMonto total de la transacción aprobada originalmente
AnuladoMonto devuelto al cliente
Autorización RestanteSaldo aún autorizado tras la devolución parcial: Venta Original menos Anulado
La pantalla de detalle dice Anulado, no Devolución
El flujo se llama Devolución pero el detalle de la transacción rotula el campo como Anulado. Se refieren a lo mismo: el monto que le devolviste al cliente.
En el Resumen de Ventas del período ese monto aparece como Devoluciones y se resta del total neto del día.

Auth & Capture (preautorización y captura)#

Una preautorización reserva un monto en la tarjeta del cliente sin cobrarlo de inmediato. El cargo efectivo ocurre después, en un paso separado llamado captura. Es el flujo habitual en hoteles, renta de vehículos y restaurantes que ajustan el monto final antes de cerrar la cuenta.
Requiere habilitación previa
Auth & Capture debe estar habilitado para tu comercio a nivel de Kushki. Si no ves la opción en la terminal, contacta a tu account manager.

Crea una preautorización#

Paso 1 — Ingresa el monto#

Desde la pestaña INICIO, toca Autorización en el menú de operaciones. El encabezado del teclado muestra Autorización en lugar de Venta. Ingresa el monto a preautorizar y toca el botón de confirmación.
Pantalla de autorización

Paso 2 — Ingresa una referencia#

Opcional, pero recomendado
La referencia, de máximo 18 caracteres, facilita localizar la preautorización en la pantalla Capturar Pago. Es útil en comercios con muchas preautorizaciones abiertas al mismo tiempo.
Toca Guardar Ref para asociarla, u Omitir para continuar sin referencia.
Pantalla de referencia

Paso 3 — Presentación de la tarjeta#

La terminal muestra la pantalla de espera de tarjeta. El cliente presenta su tarjeta por contactless, chip o banda. El proceso es idéntico al del flujo de venta regular.
Pantalla de inserción de tarjeta

Paso 4 — Auth aprobada#

Si la autorización es exitosa, la app muestra la pantalla Auth Aprobada con el mensaje "Autorizado - No Capturado". El monto quedó reservado pero aún no debitado. Se genera un Ticket # y un comprobante.
Pantalla de preautorización aprobada
La reserva tiene fecha de vencimiento
La vigencia depende del tipo de tarjeta:
Tipo de tarjetaVigencia desde la autorización
Débito (Visa / Mastercard)7 días
Crédito (Visa / Mastercard)28 días
La terminal muestra el plazo restante en Capturar Pago. Si no capturas antes del vencimiento, la reserva se libera automáticamente y tendrás que autorizar de nuevo.

Captura una preautorización#

Paso 1 — Accede a Capturar Pago#

Desde la pestaña INICIO, toca Capturar Pago en el menú de operaciones. La pantalla lista todas las preautorizaciones pendientes con su referencia, monto y fecha de vencimiento.
Pantalla de capturar pagos
Cada preautorización pendiente tiene tres acciones:
AcciónDescripción
CancelarCancela la preautorización y libera el monto reservado. Equivale a una anulación
Re-AuthRenueva la preautorización por un nuevo período si está próxima a vencer, o ajusta el monto reservado
CapturarConfirma el cobro efectivo. Abre la pantalla de confirmación del monto

Paso 2 — Confirma el monto a capturar#

La app muestra la pantalla Confirmar total antes de capturar con el monto autorizado y el total a capturar. Toca Capturar Pago para confirmar.
Pantalla de confirmación del total a capturar
Puedes capturar hasta un 10% más de lo autorizado
El monto máximo a capturar puede ser hasta un 10% superior a la suma de la autorización inicial más todas las re-autorizaciones que no hayan sido canceladas.
Se permite una sola captura por ciclo de autorización. Si necesitas cobrar más de ese límite, usa Re-Auth para ampliar la reserva antes de capturar.

Paso 3 — Captura aprobada#

La app muestra la pantalla Aprobado con el mensaje "cobrado exitosamente" y genera el comprobante final de la transacción.
Pantalla de captura aprobada
Cuál comprobante es el definitivo
El comprobante de la captura es el documento fiscal de la transacción. El comprobante de la Auth Aprobada es solo un resguardo de la reserva: no acredita un cobro.
Consulta tus transacciones
Aprende a filtrar la Lista de Ventas y a generar el Resumen del día desde la terminal.
Configuración del terminal
Habilita devoluciones, configura Auth & Capture y gestiona los usuarios operadores.
Modificado en 2026-09-21 22:20:28
Anterior
Kushki One App de Pagos
Siguiente
Procesa un cobro
Built with