Cinco preguntas para saber si tu webhook de pagos funciona de verdad
Un webhook de pagos puede estar conectado durante semanas sin haber confirmado nunca un pago real. Estas cinco preguntas sirven para descubrir si el tuyo está en ese caso.
1. ¿Lo probaste de punta a punta con un pago real?
Que el endpoint responda 200 con un ejemplo de la documentación no demuestra que acepte una notificación verdadera. La que importa es la que genera el proveedor cuando un pago real cambia de estado. Hazla pasar una vez y comprueba que el estado en tu base de datos cambió solo.
Esta fue la causa del caso del webhook de Payouts: estaba conectado, pero nunca validó una notificación real.
2. ¿Verifica la firma con el secreto correcto para cada tipo de evento?
No des por hecho que dos webhooks del mismo proveedor se firman igual. Pagos, transferencias salientes y reembolsos pueden usar secretos y formas distintas. Revisa en la documentación de cada uno cuál corresponde, y confirma que tu código no reutiliza la verificación de uno para el otro.
3. ¿Qué pasa si la misma notificación llega dos veces?
Los proveedores reintentan cuando no reciben tu respuesta, y las redes fallan. Si procesar dos veces la misma notificación te hace entregar, cobrar o devolver dos veces, tu sistema depende de que nada falle nunca. Envía la misma notificación dos veces en un entorno de prueba y mira qué cambió la segunda vez.
4. ¿Tienes un estado "pendiente" y lo respetas?
Algunos medios, como PSE, no confirman al instante. Si tu sistema solo conoce "pagado" y "fallido", va a mentir mientras el banco decide. Lee por qué no puedes cobrar cuando el cliente vuelve a tu página.
5. ¿Alguien se entera si deja de funcionar?
Un webhook roto casi nunca falla con ruido. Responde 401 o 500 y los pagos se quedan sin confirmar. Si ninguna alerta te avisa cuando suben los rechazos o cuando hay pagos pendientes por demasiado tiempo, el problema lo vas a descubrir tú, o un cliente, mucho después.
Cómo usar la lista
Si respondiste "no sé" a alguna pregunta, eso ya es un hallazgo. Una auditoría consiste en responderlas con tu código delante: reviso webhooks, montos, reintentos y concurrencia, y te entrego un reporte con cada hallazgo, su severidad y cómo corregirlo.
¿Alguna de las cinco te dio una respuesta incómoda?