Guía para decidir mejor
Cómo comprobar webhooks de una pasarela WooCommerce
Una confirmación de pago puede llegar después de volver al sitio.
En muchas pasarelas, el navegador vuelve a la tienda antes de que el proveedor confirme definitivamente el pago. La confirmación puede llegar por un webhook, callback o notificación servidor a servidor. Si ese mensaje no se entrega, WooCommerce puede dejar el pedido pendiente aunque exista una transacción en el proveedor. Cada extensión tiene sus propios nombres y registros: sigue su documentación para localizar el endpoint exacto.
Distingue los dos sentidos de la comunicación
WooCommerce permite crear webhooks salientes para avisar a otros sistemas de eventos de tienda. Una pasarela de pago puede, además, llamar a un endpoint entrante de su plugin para comunicar autorización, captura, fallo o reembolso. No son la misma configuración. Antes de editar una URL, identifica cuál de los dos flujos falta y qué evento se espera.
Verifica la entrega sin repetir el cobro
- En el panel de la pasarela, busca el evento por ID de transacción, hora y estado de entrega.
- Comprueba URL del endpoint, HTTPS, método, código de respuesta y firma o secreto según la documentación del proveedor.
- Correlaciona la hora con logs del servidor, WAF, PHP y plugin; un 200 HTTP puede no significar que la aplicación procesó el evento.
- Revisa si la tarea quedó en cola; WooCommerce usa acciones programadas para varias operaciones.
- Ensaya con un evento de prueba autorizado y confirma una sola transición del pedido.
No desactives globalmente el firewall ni publiques el secreto del webhook para «probar rápido». Si el proveedor ofrece reenvío, comprueba primero si el pedido ya se actualizó y si la extensión procesa eventos repetidos de forma segura. Nunca reenvíes un cargo; una notificación y un cobro son operaciones diferentes.
Interpreta las respuestas
Un 404 puede indicar ruta o enlace permanente incorrectos; un 403, regla de seguridad o firma; un 5xx, excepción o falta de recursos. Un timeout requiere revisar duración del procesamiento y respuesta del origen. La causa no se deduce solo del código: abre el evento del proveedor y el log local. Si el pago está confirmado pero el pedido no, concilia el estado antes de cambiarlo manualmente. Si necesitas soporte de infraestructura, comparte la hora, endpoint sin secreto y código de respuesta.