1. Pagos calendarizados
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. Pagos calendarizados

¿Cómo funcionan los cargos recurrentes con tarjeta?

Te contamos un poco más acerca del proceso de pagos recurrentes
Esta funcionalidad se encuentra disponible para los siguientes modelos:
☑ Adquirente

☑ Agregador
El pago con tarjeta tiene un alcance global, siendo este uno de los métodos de pago en línea más populares. Por esta razón, hemos diseñado para ti los cobros calendarizados, un producto que te ayudará a realizar cobros de manera automática y sencilla. Permitiendo que tus clientes paguen de forma periódica (diario, semanal, mensual, trimestral,etc) por los productos o servicios que ofrezcas.

Proceso de pago#

El pago con suscripción por tarjeta consta de 2 etapas principales: inscripción de la tarjeta y ejecución del cobro recurrente.
Card pago recurrente

Inscripción de la tarjeta#

1. Selección del método de pago#

En tu sitio web o app, el usuario seleccionará el método de pago. Asegúrate que quede claro para el pagador que su tarjeta será inscrita para pagar un valor recurrente.

2. Ingreso de datos#

En esta etapa el usuario proporciona los datos de la tarjeta que utilizará para pagar. Tu sitio web o app deberá encargarse de verificar que la información de la tarjeta esté correcta (por ejemplo, que la fecha de expiración no sea pasada, o que el número de tarjeta obedezca el algoritmo de Luhn). En este paso aún no hay garantía que la tarjeta sea válida.

3. Envío de datos a Kushki#

Kushki recibirá los datos y verificará si existen suficientes fondos para la cuenta asociada a la tarjeta mediante un cobro de validación. Este cobro por un monto pequeño lo cursa Kushki y es reversado automáticamente en caso de ser exitoso. El cobro te garantiza que la tarjeta de tu cliente puede ser cobrada luego de la inscripción.

4. Notificación de cargo recurrente creado#

En esta etapa te indicaremos el resultado de la inscripción de la tarjeta para que lo muestres en pantalla al usuario.

Cobro recurrente#

1. Ejecución del cobro#

Kushki cursa los cargos recurrentes a la tarjeta inscrita de manera automática. Los cobros se ejecutarán y repetirán de acuerdo al monto y periodo indicados al momento de crear el cargo recurrente.
La lógica de cobros empieza a correr todos los días a partir de las 6am GMT-5. Asegúrate de que el cargo recurrente esté creado antes de esta hora si quieres que el primer cobro se ejecute el mismo día de la inscripción. Como alternativa, tu cliente puede inscribir su tarjeta días antes de que Kushki ejecute el primer cobro. Al crear el cargo recurrente deberás indicar la fecha de inicio startDate.
Reintentos#
En el caso de que el cobro sea declinado, Kushki maneja una lógica de reintentos para intentar recuperar el cobro. Por omisión, se reintentan 3 veces por día, durante 3 días seguidos a partir del día de cobro definido originalmente en startDate. Por ejemplo, para un cargo calendarizado mensual con fecha de inicio 10-01-2021, si el 10-02-2021 se declina el cobro, se reintentará hasta el 13-02-2021, 3 veces cada día; es decir, 9 intentos de cobro en total.
Podrás modificar los días que se reintenta el cargo, así como también definir días específicos para su cobro.
Personaliza la lógica de reintentos#
Puedes personalizar la lógica de reintentos de cobro enviando el objeto retryConfiguration de la siguiente manera:
1.
retryType: "schedule". Si eliges scheduled, puedes especificar en el campo value la frecuencia con la que se reintentará el cobro.
En el siguiente ejemplo, el cobro se intentará 3 veces al día cada 2 días durante todo el mes.
{
   "retryConfiguration":{
      "retryType":"schedule",
      "value":[2]
   }
}
2.
retryType:"fixed". Envía los días concretos de u mes en el que deseas que se ejecuten los reintentos. Ej. el día 10, 20, 30.
En el siguiente ejemplo, el cobro sólo se reintentará 3 veces al día, los días 10, 20 y 30 del mes.
{
  "retryConfiguration":{
     "retryType":"fixed",
     "value":[10,20,30]
  }
}```

:::info[]
Envía el `retryType` como `fixed` si no quieres reintentar el cobro durante todo el mes.
:::

Si el __último intento de cobro fue rechazado__, es posible que te enviemos una notificación vía Webhook informándote de ello. En estos casos, te recomendamos que te pongas en contacto con el titular de la tarjeta y le ofrezcas una serie de alternativas para pagar la cuota que no se ha podido cobrar; por ejemplo, cambiar la tarjeta de crédito registrada y generar un [One-click payment](/en/mx/recurring-payments/one-click-payments/on-demand) sólo por una vez. Kushki seguirá ejecutando cargos automáticos durante los siguientes periodos.

:::danger[Importante]
Al personalizar la lógica de reintentos hay que tener en cuenta que una vez iniciado el primer cobro, si este falla y se inician los reintentos, cualquier actualización de los reintentos se aplicará hasta el siguiente periodo de suscripción (semanal, mensual, anual).
:::

##### Periodicidad

Puedes elegir la periodicidad de los cargos recurrentes enviando cualquier de estos valores en el campo requerido `periodicity`:

* **daily**: cada 1 día.
* __weekly__: cada 7 días.
* __biweekly__: cada 15 días.
* __monthly__: cada 30 días.
* __threefortnights__: cada seis semanas o 42 días.
* __bimonthly__: cada 60 días.
* __quarterly__: cada 90 días.
* __fourmonths__: cada 120 días.
* __halfyearly__: cada 180 días
* __yearly__: cada 360 días.
* __custom__: para [pagos one click](/co/recurring-payments/one-click-payments/on-demand?tab=Web).

#### 2. Notificación de estado de la transacción

En esta etapa serás notificado con el estado de cada uno de los cobros automáticos. Puedes recibir estas __notificaciones a un webhook__ que expongas para que Kushki lo consuma. También cuentas con la consola de Kushki para verificar las transacciones junto con el detalle de cada una y el estado.

***

<Card title="Suscribe una tarjeta" href="/co/recurring-payments/scheduled-payments/subscribe-a-card?tab=Web">
Inicia tu integración y acepta pagos recurrentes online de manera segura.
</Card>

<Card title="Acepta webhooks" href="/co/notifications/recurring-payments/webhook-card-subscriptions">
Maneja eventos post-pago de la manera correcta.
</Card>
Modificado en 2026-10-14 19:40:15
Anterior
Crea un cargo calendarizado
Siguiente
Pagos OneClick
Built with