Webhooks: cómo investigar y solucionar el error «Se agotó el tiempo de espera»

«Se agotó el tiempo de espera» indica que Stripe ha podido establecer una conexión con tu servidor, pero este ha tardado demasiado en proporcionar una respuesta. Stripe espera que tu servidor responda de inmediato con un código de estado HTTP entre el 200 y el 299 para indicar que el evento se ha recibido correctamente.

Prueba a seguir estos pasos:

  1. Revisa tu código encargado de procesar los webhooks y asegúrate de que devuelva un código de estado 2xx rápidamente: si necesitas llevar a cabo tareas de larga ejecución tras recibir un evento de Stripe, debes confirmar la recepción de inmediato a Stripe y después hacer esas tareas (muchas personas añaden los eventos recibidos a una cola interna para que se procesen en serie de forma asíncrona).

  2. Asegúrate de que tu servidor esté funcionando con normalidad: comprueba si hay un uso extrañamente elevado de la CPU o la memoria, si el almacenamiento está lleno, si hay problemas de espacio en el disco o si hay errores o advertencias en los registros del servidor.