Cuando una empresa utiliza la misma pasarela de pagos en dos plataformas diferentes puede encontrarse con una limitación importante: el proveedor solo permite registrar una URL de eventos.
Esto significa que, aunque ambos sistemas puedan crear pagos correctamente, solo uno recibiría de forma directa las notificaciones que confirman si una transacción fue aprobada, rechazada o quedó pendiente.
El complemento de distribución de eventos de Kalendia resuelve este problema. Recibe cada notificación una sola vez y la entrega de manera independiente a todos los sistemas que la necesiten.

¿Qué problema soluciona?
Imagina que tu empresa utiliza Wompi para cobrar en Kalendia y, al mismo tiempo, tiene otro sistema administrativo, educativo, contable o comercial que también necesita recibir los resultados de esos pagos.
Cada plataforma proporciona su propia URL de eventos, pero Wompi permite configurar una sola dirección. Si reemplazas una por la otra, uno de los sistemas deja de recibir las confirmaciones.
Webhook Relay funciona como una regleta inteligente:
Pasarela de pagos
↓
Webhook Relay de Kalendia
├──→ Kalendia
├──→ Sistema administrativo
└──→ Otro sistema autorizado
La pasarela envía el evento a una sola URL, pero el complemento crea una entrega separada para cada destino configurado.

¿Para qué puede utilizarse?
- Conectar una pasarela de pagos con Kalendia y otra plataforma.
- Enviar confirmaciones de pago a un sistema contable o administrativo.
- Notificar el mismo evento a un CRM, ERP, automatización o aplicación propia.
- Evitar perder actualizaciones cuando un proveedor admite una sola URL de eventos.
- Conservar un historial de eventos, entregas, errores y reintentos.
Aunque Wompi es un ejemplo frecuente, el complemento no está limitado a una pasarela específica. Puede distribuir webhooks de otros proveedores y aplicaciones que envíen eventos mediante HTTPS.
Qué hace y qué no hace el complemento
El Relay distribuye notificaciones. No reemplaza la integración de pagos de Kalendia ni almacena las credenciales utilizadas para crear cobros.
- Kalendia conserva las llaves y secretos necesarios para crear y verificar pagos.
- La pasarela conserva la URL del Relay como su URL de eventos.
- El Relay conserva la entrada y los destinos a los que debe entregar cada evento.
En Wompi, por ejemplo, la llave pública, la llave privada y el secreto de integridad continúan en la integración de pagos. En su panel solo se reemplaza la URL de eventos por la URL de entrada generada por el complemento.
Cómo configurarlo paso a paso

1. Activa Webhook Relay
En el panel de tu negocio abre Complementos, busca Webhook Relay y actívalo. Después abre su pantalla de configuración.
2. Crea una entrada
La entrada es el punto único al que enviará sus eventos la pasarela o sistema de origen.
- Escribe un nombre fácil de reconocer, por ejemplo, Pagos de producción.
- Selecciona el método de autenticación que admite el emisor. Si no requiere uno adicional, utiliza Sin autenticación adicional.
- Crea la entrada.
- Copia la URL generada.
La URL se almacena cifrada, aparece oculta por defecto y puede copiarse sin mostrarla. Trátala como una contraseña: no la publiques ni la incluyas en capturas de pantalla.
3. Añade los destinos
Cada destino representa un sistema que debe recibir el evento.
- Selecciona la entrada creada.
- Escribe un nombre para identificar el destino.
- Pega la URL HTTPS proporcionada por ese sistema.
- Guarda el destino y repite el proceso para los demás.
Para una integración compartida con Wompi podrías tener, por ejemplo, un destino para Kalendia y otro para el sistema externo que ya utilizaba la empresa.
4. Configura la URL en la pasarela
En el panel del proveedor busca el campo URL de eventos, Webhook URL o su equivalente. Pega únicamente la URL de entrada generada por el Relay y guarda los cambios.
No coloques allí las direcciones de los destinos. Esas permanecen dentro del complemento.
5. Haz una prueba real controlada
Cuando el proveedor exige eventos firmados, una prueba genérica no sustituye un evento real. Recomendamos realizar una operación de bajo valor y verificar:
- Que el evento aparezca en Eventos recientes.
- Que exista una entrega por cada destino.
- Que cada entrega figure como completada con una respuesta HTTP exitosa.
- Que el pago se actualice correctamente en todos los sistemas.
Seguridad y confiabilidad
El complemento incorpora medidas para operar de forma responsable:
- URLs de entrada con tokens aleatorios difíciles de adivinar.
- Cifrado de URLs, secretos, cabeceras y contenido almacenado.
- Acceso administrativo para consultar o modificar la configuración.
- Recepción exclusiva mediante solicitudes POST.
- Prevención de bucles y límites de tamaño y frecuencia.
- Cola independiente para cada destino.
- Reintentos automáticos ante fallos temporales.
- Pausa, renovación y archivado controlado de entradas y destinos.
- Historial técnico sin exponer el contenido sensible en correos de alerta.
Además, cada plataforma de destino puede seguir verificando la firma original del proveedor. El Relay conserva el cuerpo y las cabeceras necesarias para esa validación.
Qué hacer si un destino falla
Una falla en un destino no impide automáticamente que los demás reciban el evento. Cada entrega tiene su propio estado y sus propios reintentos.
Desde la pantalla del complemento puedes revisar la respuesta HTTP, identificar cuál sistema tuvo el inconveniente y reintentar la entrega correspondiente. También puedes pausar un destino sin eliminar la configuración ni su historial.
Una sola URL, varios sistemas sincronizados
Webhook Relay permite mantener conectadas varias plataformas sin pedir al proveedor de pagos una característica que no ofrece. El resultado es una integración más flexible: la pasarela continúa procesando los pagos y cada sistema recibe la notificación que necesita para actualizar su operación.
Si tu empresa utiliza Kalendia junto con otra plataforma y ambas necesitan recibir eventos del mismo proveedor, activa el complemento desde el catálogo y configura una entrada con todos los destinos autorizados.

