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

Webhook para pagos con Webpay Plus

Kushki puede enviar eventos webhook que notifican a tu aplicación cuando uno de los siguientes eventos ocurre al realizar un cobro con el servicio de Webpay Plus:
Cuando una transacción ha sido aprobada.
Cuando una transacción ha sido declinada.

Notificación de pago#

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
countrystring
processor_typestring
response_codestring
transaction_status"APPROVAL" "DECLINED"
request_amountnumber
channelstring
merchant_idstring
approved_transaction_amountnumber
buy_orderstring
currency_codestring
subtotal_ivanumber
processor_idstring
processor_namestring
response_textstring
transaction_referencestring
last_four_digitsstring
transaction_idstring
approval_codestring
amountobject
subtotalIva0number
ivanumber
subtotalIvanumber
creatednumber (Unix Timestamp Format)
iva_valuenumber
integration_methodstring
merchant_namestring
card_typestring
ticket_numberstring
transaction_type"SALE"
tokenstring
sync_modestring
subtotal_iva0number
transactionReferencestring

Ejemplos#

JSON
JSON
// Transacción aprobada
{
  "country": "Chile",
  "processor_type": "aggregator_formal",
  "response_code": "000",
  "transaction_status": "APPROVAL",
  "request_amount": 2500,
  "channel": "webpay",
  "merchant_id": "20000000105045623000",
  "approved_transaction_amount": 2500,
  "buy_order": "20220604230551990",
  "currency_code": "CLP",
  "subtotal_iva": 0,
  "processor_id": "1000001057834855117416546432453",
  "processor_name": "Transbank Processor",
  "response_text": "Transacción aprobada",
  "transaction_reference": "46a1ff25-51a4-409f-84b8-155fd4732f98",
  "last_four_digits": "7763",
  "transaction_id": "46a1ff25-51a4-409f-84b8-155fd4732f98",
  "approval_code": "1415",
  "amount": {
    "subtotalIva0": 2500,
    "iva": 0,
    "subtotalIva": 0
  },
  "created": 1656025541039,
  "iva_value": 0,
  "integration_method": "rest",
  "merchant_name": "Tu Gran Empresa",
  "card_type": "debit",
  "ticket_number": "446025551863514017",
  "transaction_type": "SALE",
  "token": "24d63081656c464694987036e120d6e0",
  "sync_mode": "api",
  "subtotal_iva0": 2500,
  "transactionReference": "46a1ff25-51a4-409f-84b8-155fd4732f98"
}
Modificado en 2026-10-21 16:29:50
Anterior
Webhook para pagos únicos con efectivo
Siguiente
Webhooks para pagos recurrentes
Built with