1. Devoluciones
Kushki Docs
Español
  • Español
  • English
  • Inicio
  • Inicio rápido
    • Últimas novedades
    • Datos de prueba
    • Preguntas frecuentes
    • Paso a producción
    • Política de cambios importantes del API
    • 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
    • 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
    • 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 calendarizado
      • ¿Cómo funcionan los cargos recurrentes con tarjeta?
    • Pagos OneClick
      • Recibe pagos OneClick con autorización y captura
      • Genera pagos one click
      • ¿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
    • Raw card-present API
      • Introducción a 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
    • Kushki One
      • Primeros Pasos
      • 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
      • Descripción general
      • Devoluciones y PreAuth & Capture
      • Pago Dividido en la terminal
      • Configuración del terminal
      • Procesa un cobro
      • Consulta tus transacciones
    • Transacciones
      • Transacciones
      • Anula un pago
  • Pagos con transferencias
    • Recibe transferencias bancarias
    • Códigos de error para transferencias
    • 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
    • ¿Cómo funcionan los pagos en efectivo?
    • Puntos de recaudo
    • Códigos de error para transacciones declinadas en efectivo
  • Métodos alternativos de pago (APM)
    • ¿Cómo funcionan los pagos con APM?
    • Acepta pagos con Bre-B
  • Dispersión de dinero
    • Recarga tu saldo para dispersiones
    • Transferencia bancaria
      • Dispersa a cuentas bancarias
      • Dispersa con Bre-B
      • Códigos de error para dispersiones por transferencia
      • ¿Cómo funciona la dispersión por transferencia bancaria?
    • Efectivo
      • Dispersa dinero en efectivo
      • Maneja tus dispersiones
      • ¿Cómo funciona la dispersión por efectivo?
  • 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
    • Webhooks para pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
    • Webhooks para smartlinks
      • Webhooks con Smartlinks
    • Webhooks para dispersiones
      • Webhook para dispersión de dinero con transferencia
      • Webhook para dispersión de dinero con efectivo
    • Webhooks para botón de pagos
      • Webhooks con Botón de pago
    • 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. Devoluciones

Devoluciones, anulaciones y reembolsos

Aprende cómo anular un pago o solicitar un reembolso para tus clientes
Esta funcionalidad se encuentra disponible para los siguientes modelos:
☑ Adquirente

☑ Agregador/Gateway
Con Kushki puedes procesar devoluciones de pagos con tarjeta débito y crédito en estado aprobado. Una vez aprobada una devolución, los fondos se retornarán a la tarjeta de tu cliente.
Importante
Kushki solo soporta devoluciones en pagos con tarjeta. Para gestionar devoluciones de pagos con transferencia o en efectivo debes realizar el proceso de forma manual, en acuerdo con tu cliente.
Las devoluciones pueden ser de dos clases, según el día y la hora en que se procese la transacción original y la solicitud de anulación:

1. Anulación en línea (Void)#

Se da cuando la solicitud de devolución se procesa durante el mismo día de la transacción, antes de las 20:59 para modelo agregador, y antes de las 23:59 para adquiriencia. Realizaremos hasta tres intentos de devolución con el procesador y si es exitosa, la compra se eliminará del extracto de movimientos de tu cliente y se devolverá el monto de la compra a su cuenta.
Anulación en línea ES

2. Reembolso (Refund)#

Cuando no sea posible realizar una anulación en línea, será necesario realizar un reembolso. El reembolso se puede dar en los siguientes escenarios:
Cuando la solicitud de devolución se procesa bajo las siguientes condiciones:
Modelo Agregador/Gateway: Después de las 20:59 del dia de la transacción.
Adquiriencia: Después de las 23:59 horas del día de la transacción.
Cuando fallan los tres intentos de anulación en línea.
Cuando la solicitud de anulación se realiza en un día diferente al de la transacción original.
Este tipo de reembolsos pueden tardar hasta 15 días hábiles en procesarse y en reflejarse en el extracto de tu cliente, dependiendo del banco emisor de la tarjeta.
A continuación una ilustración del proceso de reembolso:
Reembolso manual ES

¿Cómo procesar una devolución?#

El proceso de devolución puede tener dos resultados: Anulación (void) o Reembolso (refund). La devolución se hará como anulación (void) siempre que se solicite el mismo día de la transacción y cumpla con los siguientes plazos:
Modelo Agregador/Gateway: Antes de las 20:59 horas del dia de la transacción.
Modelo Adquirente: Antes de las 23:59 horas del dia de la transacción.
Si excede ese tiempo, entonces será procesada como reembolso (refund). Los reembolsos pueden tardar hasta 7 días hábiles en procesarse y hasta 45 días hábiles en reflejarse en el extracto de tu cliente, dependiendo del banco emisor de la tarjeta.
Puedes procesar devoluciones desde tu Consola según lo explicado aquí o integrar en tu aplicación nuestro método de API de solicitud de cancelación para que tus compradores puedan solicitar desde tu sitio la devolución de una compra.
Si integras las devoluciones vía API, bastará con que uses el método de solicitud de anulaciones, en caso de que no sea posible completar una anulación automática de la transacción, Kushki se encargará de procesarla como devolución manual.
Una vez una solicitud de devolución sea aprobada, esta no podrá revertirse.
Para solicitar la anulación de un pago es necesario utilizar el ticketNumber de la transacción original como path parameter y enviar tu credencial privada, tal y como se muestra en el siguiente ejemplo:
JavaScript
Python
PHP
Consulta nuestra referencia API para mayor información.

¿Cuál es el tiempo límite para solicitar una devolución?#

El tiempo límite para que tus clientes soliciten una devolución varía por modelo de afiliación:
Agregación (Gateway)Adquiriencia Kushki (Doméstica)Adquiriencia Kushki (Internacional)
Hasta 6 meses después de realizado un cobro.Hasta 120 días después de realizado un cobro.Hasta 120 días después de realizado un cobro.

¿Cómo procesar una devolución parcial?#

Puedes permitirle a tus clientes solicitar devoluciones parciales usando el mismo endpoint de anulación de transacciones, por lo tanto es posible que un solo cargo tenga varias solicitudes de devolución asociadas, siempre y cuando la suma de estas no sobrepase el monto total de la transacción original.
Las devoluciones parciales pueden solicitarse manualmente, a través de la Consola o vía API, según lo explicado a continuación.

Devoluciones parciales vía API#

Para solicitar una devolución parcial, puedes usar el endpoint de solicitud de anulaciones. Debes enviar el ticketNumber como path parameter, tu credencial privada y el desglose de monto e impuestos en el objeto amount. Asegúrate que el cálculo de los impuestos y montos sea el correcto.
JavaScript
Python
PHP

¿Cómo conocer el estado de una devolución?#

Puedes conocer el estado de una anulación desde tu Consola según lo explicado aquí o configurar un Webhook de devoluciones, en el cual Kushki te notificará cuando se complete exitosamente una solicitud de devolución, ya sea anulación (void) o reembolso (refund).

Recomendado
Consulta el estado de tus devoluciones
Modificado en 2026-10-21 19:53:18
Anterior
Devoluciones
Siguiente
Autenticación 3DS
Built with