1. Webhooks para pagos recurrentes
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. Webhooks para pagos recurrentes

Webhook para pagos recurrentes con Webpay OneClick

Kushki puede enviar eventos webhook que notifican a tu aplicación cuando uno de los siguientes eventos ocurre al tratar de inscribir tarjetas para pagos recurrentes con el servicio de Webpay OneClick:
La suscripción de una tarjeta ha sido aprobada.
La suscripción de una tarjeta ha sido rechazada.
La suscripción de una tarjeta está pendiente de aprobación.

Estructura#

Los webhooks enviados por Kushki contendrán los encabezados (headers) aquí listados.

Estas son las posibles variables que se entregan en el cuerpo del webhook:
Método: POST
Body: Object
VariableTipo
amountobject
amount.subtotalIva0number
amount.ivanumber
amount.subtotalIvanumber
amount.icenumber
amount.currencystring
metadataobject
metadata.contractIDstring
creatednumber (Unix Timestamp Format)
ipstring
activeboolean
planNamestring
contactDetailsobject
contactDetails.firstNamestring
contactDetails.lastNamestring
contactDetails.phoneNumbernumber
contactDetails.documentTypestring
contactDetails.documentNumbernumber
contactDetails.emailstring
tokenstring
dayOfWeekstring
monthnumber
binInfoobject
binInfo.bankstring
binInfo.binnumber
binInfo.processorstring
binInfo.brandstring
dayOfMonthnumber
merchantIdnumber
providerstring
periodicitystring
subscriptionStatus"CONFIRMED" "DECLINED" "PENDING"
callbackUrlstring
idnumber
subscriptionIdnumber
startDatenumber
statusstring

Ejemplos#

Suscripción aprobada
Suscripción rechazada
Suscripción pendiente de aprobación
// Suscripción aprobada
{
  "amount": {
    "subtotalIva0": 0,
    "iva": 0,
    "subtotalIva": 0,
    "ice": 0,
    "currency": "CLP"
  },
  "metadata": {
    "contractID": "157AB"
  },
  "created": 1631724854,
  "ip": "xxx.xxx.xxx.xxx",
  "active": false,
  "planName": "Premium",
  "contactDetails": {
    "firstName": "Diego",
    "lastName": "Cadena",
    "phoneNumber": "+593988734644",
    "documentType": "{{doctype_cl}}",
    "documentNumber": "1001001001",
    "email": "xxxxxxxxx.xxxxx@hotmail.com"
  },
  "token": "11316ea1ab5fe24d5ad9310396bbdfe542ce809bc2229e88efa78b5fab7389aa",
  "dayOfWeek": "-",
  "month": "-",
  "binInfo": {
    "bank": null,
    "bin": null,
    "processor": null,
    "brand": null
  },
  "dayOfMonth": 2,
  "merchantId": "20000000101167010000",
  "provider": "transbankwebpay",
  "periodicity": "custom",
  "subscriptionStatus": "CONFIRMED",
  "callbackUrl": "https://www.kushki.com",
  "id": "163172484706300020000000101167010000",
  "subscriptionId": "1631724847063000",
  "startDate": 1631750400,
  "status": "subscriptionApproved"
}
Modificado en 2026-10-21 16:29:56
Anterior
Webhook para pagos recurrentes con tarjeta
Siguiente
Webhooks para dispersiones
Built with