Saltar al contenido

Inicio / Blog / 2026-09-16

El webhook que rechazaba cada pago real

Wompi Payouts (pagos a terceros) tenía su webhook de confirmación conectado hacía semanas. Nunca validó ni una sola notificación real. Esto es lo que encontré revisando el código, y por qué el síntoma no se parecía en nada a la causa.

El síntoma

Un payout (una transferencia de plata saliente, vía Wompi) se crea, Wompi la procesa, y en algún momento manda un webhook con el resultado — aprobado, rechazado, lo que sea. Ese webhook es lo que actualiza el estado real de la transferencia en la base de datos.

El problema: ese estado nunca se actualizaba solo. Cada transferencia se quedaba en pending para siempre, aunque Wompi ya la hubiera procesado del otro lado. La única forma de saber el estado real era ir a revisar manualmente — exactamente el tipo de cosa que nadie hace todos los días, hasta que hace falta y ya es tarde.

La causa no era "falta validación" — era "valida con la llave equivocada"

Wompi tiene dos esquemas de firma distintos según el tipo de webhook:

  • El webhook normal de transacciones (checkout) firma con un secreto, y manda el timestamp adentro del objeto signature.
  • El webhook de Payouts usa un secreto distinto— no es el mismo que el del checkout — y manda el timestampcomo hermano de signature, no anidado.

El código de este sistema verificaba los webhooks de Payouts reusando la función y el secreto del checkout normal. Como la forma del objeto no coincidía y el secreto tampoco, el checksum calculado nunca iba a matchear con el real — ni una sola vez, por diseño. No era un bug intermitente ni una condición de carrera: la verificación estaba matemáticamente destinada a fallar siempre.

Por qué esto es más peligroso que un error obvio

Si el webhook hubiera tirado un 500 o un error visible, se hubiera notado rápido. Lo que pasó en cambio fue silencioso: la verificación fallaba, el endpoint respondía 401 invalid_signature — que es exactamente el comportamiento correcto ante una firma real inválida — así que no había nada que gritara "esto está roto". Solo un archivo lento y constante de transferencias que nunca se confirmaban solas.

Ese es el patrón más caro en integraciones de pago: no el error ruidoso que para todo, sino el que se comporta exactamente como el caso normal de "esto es fraudulento, lo rechazo" cuando en realidad el problema es tuyo, no del atacante.

El fix

Una función de verificación separada, específica para el sobre real de Payouts: su propio secreto (WOMPI_PAYOUTS_EVENTS_KEY, no el del checkout), leyendo el timestamp del nivel correcto del objeto. Nada elegante — simplemente dejar de asumir que dos webhooks del mismo proveedor comparten esquema porque comparten proveedor.

La lección que se repite

Casi ningún proveedor de pagos documenta esto de forma obvia en un solo lugar: transacciones, payouts, suscripciones y reembolsos suelen tener webhooks con formas de firma ligeramente distintas, documentados en páginas separadas que es fácil no leer si ya "sabés cómo funciona el webhook" de otro endpoint del mismo proveedor. La integración que funciona en el checkout no te dice nada sobre si la de payouts está realmente conectada — solo lo sabés si alguien la prueba de punta a punta, con una transferencia real.

¿Tu integración de pagos tiene un webhook que nunca probaste de punta a punta?

← Volver al blog

Escríbeme por WhatsApp