1. Webhooks para pagos únicos
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)
    • Marcas de tarjeta soportadas
    • Funcionalidades por modelo de negocio
    • ¿Cómo funcionan las Comisiones a terceros?
    • Guía de integración Comisiones a terceros
    • Pagos en un paso
      • ¿Cómo funcionan los pagos con tarjeta?
      • Acepta un pago con tarjeta
      • Acepta pagos únicos con OTP
      • Códigos de error autenticación OTP
      • Códigos de error pagos únicos con tarjeta
    • Devoluciones
      • Devoluciones, anulaciones y reembolsos
    • Autenticación 3DS
      • Introducción a 3DS
      • Integración 100% API de 3DS
      • Integración 3DS con librería kushki.js
      • Integración 3DS API + librería kushki.js
      • Códigos de error autenticación 3DS
  • Pagos recurrentes con tarjeta (Online)
    • Autentica tus suscripciones con 3DS
    • Suscripciones externas a Kushki
    • 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 OneClick
      • Genera pagos one click
  • Pagos con transferencias
    • Bancos y detalles de operación para pagos con transferencia bancaria
    • Recibe transferencias bancarias
    • Consulta el estado de una transacción
  • Pagos en efectivo
    • Acepta un pago en efectivo
    • Puntos de recaudo
    • Códigos de error para transacciones declinadas en efectivo
  • Plugins
    • Shopify
      • 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 pagos recurrentes
      • Webhook para pagos recurrentes con tarjeta
    • Webhooks para smartlinks
      • Webhooks con Smartlinks
    • 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. Webhooks para pagos únicos

Webhook para pagos únicos con transferencia bancaria

Transferencias
Como fase final del proceso de recepción de pagos con transferencia, Kushki te da la posibilidad de enviar eventos al webhook que notifiquen a tu aplicación cuando se complete un pago con transferencia.

Estructura#

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

Estas son las posibles variables que se entregan en el webhook:
Método: POST
Body: Object
VariableTipo
amountobject
amount.subtotalIva0integer
amount.ivainteger
amount.subtotalIvainteger
amount.icenumber
amount.currencystring
amount.extraTaxesobject
amount.extraTaxes.agenciaDeViajesnumber
amount.extraTaxes.propinanumber
amount.extraTaxes.iacnumber
amount.extraTaxes.tasaAeroportuarianumber
processorStatestring OK NOT_AUTHORIZED FAILED
documentTypestring
createdinteger (Unix Timestamp Format)
documentNumberstring
transactionCyclestring
paymentDescriptionstring
responseCodestring
responseTextstring
tokenstring
publicMerchantIdstring
returnCodestring
bankIdstring
userIpstring
userTypestring “Persona Natural” (0) o “Persona Jurídica” (1)
trazabilityCodestring
statusstring initializedTransaction approvedTransaction declinedTransaction expiredTransaction
completedAtnumber (Unix Timestamp Format)
countrystring
ticketNumberstring
metadataobject
metadata.key0string
metadata.key1string
metadata.key2string
serviceCodestring
processorTypestring
transferProcessorstring
entityCodestring
processorIdstring
bankurlstring
callbackUrlstring
currencystring
sessionIdstring
userIdstring
emailstring
processorTokenstring
signatureTokenstring
termsUrlstring

Ejemplos#

JSON
JSON
// Transacción aprobada
{
  "country": "Ecuador",
  "ticketNumber": "3135260111086030",
  "metadata": {
    "userId": "IB344"
  },
  "documentType": "RUC",
  "serviceCode": null,
  "documentNumber": "123456789",
  "processorType": "gateway",
  "transferProcessor": "SafetyPay Processor",
  "requestAmount": 90,
  "merchantName": "TuComercioEC",
  "credentialAlias": "Ecuador",
  "processorId": "6000000000165342923107252372111",
  "credentialInfo": {
    "alias": "Ecuador",
    "credentialId": "f3a4b1cbe9194566b4077e61203a1109",
    "publicCredentialId": "3d862f80fb4c4527a0ecce6992dec918"
  },
  "bankurl": "https://uat-sandbox.kushkipagos.com/checkout/transfer?status=pending&identificationType=RUC&identificationNumber=123456789&description=&referenceNumber=3135260111086030&bankName=&bankCode=null&amount=90&cus=178076753&ticketNumber=3135260111086030&processor=SafetyPay Processor",
  "callbackUrl": "https://kushki.com",
  "currency": "USD",
  "trazabilityCode": "178076753",
  "email": "user@example.com",
  "amount": {
    "subtotalIva0": 90,
    "iva": 0,
    "subtotalIva": 0,
    "ExtraTaxes": {
      "agenciaDeViajes": 0,
      "iac": 0,
      "tasaAeroportuaria": 0
    }
  },
  "completedAt": 1683135264404,
  "entityCode": null,
  "transactionReference": "faa94a40-50c5-4dc8-b252-d433d6513519",
  "created": 1683135239810,
  "userAgent": "PostmanRuntime/7.29.2",
  "sessionId": "-",
  "publicCredentialId": "3d862f80fb4c4527a0ecce6992dec918",
  "userId": "-",
  "paymentDescription": "Description of the payment.",
  "token": "4bbb0c8db0fa433cb7f6179189d67d7a",
  "publicMerchantId": "20000000104536895000",
  "bankId": null,
  "credentialId": "f3a4b1cbe9194566b4077e61203a1109",
  "userIp": "187.207.13.51",
  "config": {
    "region": "us-east-1"
  },
  "status": "approvedTransaction"
}
Modificado en 2026-09-21 20:05:18
Anterior
Webhook para pagos únicos con tarjeta
Siguiente
Webhook para pagos únicos con efectivo
Built with