Idempotencia#
Kushki almacena sus notificaciones en varios servidores para mejorar la redundancia y lograr alta disponibilidad. Por eso, en raras ocasiones, podrías recibir una notificación duplicada.Recuerda diseñar tu endpoint de destino de Webhook para que sea idempotente (es decir, que no se vea afectado negativamente si procesa la misma notificación más de una vez).Respuesta rápida#
Si tu endpoint de destino de Webhook ejecuta lógica compleja o realiza llamadas HTTP, puede ocurrir un timeout antes de que Kushki pueda ser notificado de su recepción. Por eso, lo mejor es confirmar la recepción del webhook de inmediato devolviendo un código HTTP 200, y realizar el resto de las tareas después, o ejecutar otras tareas en paralelo o en segundo plano.Pruebas#
Las interacciones entre endpoints en internet pueden ser algo complicadas y volverse un dolor de cabeza cuando ocurren situaciones extremas que afectan el rendimiento de tu aplicación. Por eso te recomendamos verificar que tu Webhook funciona correctamente antes de liberarlo a producción.Verifica la firma#
Verifica siempre la firma de cada notificación (X-Kushki-Signature o X-Kushki-SimpleSignature) antes de procesar su contenido, y rechaza las que no coincidan. Consulta los pasos y los ejemplos en Webhooks — Introducción.Modified at 2026-10-27 15:49:13
