Un webhook puede llegar dos veces y seguir siendo una notificación legítima. Si tu tienda interpreta cada aviso como un pedido nuevo, un reintento puede acabar en dos tareas de preparación, dos correos o dos movimientos de existencias. La automatización necesita reconocer la operación que ya ha realizado.
La pregunta para tu proveedor es concreta: «¿Qué ocurre si recibimos otra vez el mismo aviso mientras todavía estamos procesando el primero?». Una demostración en la que todo llega una vez y en el orden esperado deja esa parte sin comprobar. Esta guía propone una revisión del flujo; no exige cambiar de plataforma ni contratar una integración concreta.
Un aviso repetido no debería crear otra operación
Un webhook es un aviso que un servicio envía a una dirección de tu aplicación cuando ocurre un evento. La documentación de webhooks de Stripe explica que puede haber entregas duplicadas y que el orden de recepción no está garantizado. Recomienda reconocer eventos ya procesados, verificar su procedencia y tratar el trabajo de forma asíncrona cuando corresponde.
Eso no convierte cualquier aviso repetido en un fallo del emisor. El receptor podría haber realizado el trabajo y haber perdido la respuesta de confirmación. Desde fuera, el remitente no sabe si la tarea terminó o si debe intentarlo de nuevo. Tu sistema debe separar el hecho de recibir una notificación del derecho a ejecutar otra vez su efecto.
La idempotencia expresa ese objetivo: repetir una petición lógica no debería multiplicar su resultado. Stripe también documenta claves de idempotencia para llamadas a su API. Esa protección pertenece a esas peticiones y a sus condiciones; no sustituye el control que necesita tu aplicación al recibir webhooks.
Distingue la entrega, el evento y el pedido
Imagina una tienda ficticia que recibe un aviso de pedido confirmado. El pedido tiene su referencia comercial; el aviso, un identificador de evento; y el servidor puede registrar varias entregas. Confundir esas tres piezas dificulta descubrir qué ha ocurrido cuando atención al cliente recibe una reclamación.
Si alguna columna no cabe, desplaza la tabla lateralmente.
| Referencia | Qué permite comprobar |
|---|---|
| Pedido | Qué compra o encargo se está gestionando. |
| Evento | Qué cambio comunicado se ha recibido. |
| Entrega | Cuándo llegó cada intento y qué respuesta obtuvo. |
| Acción interna | Si la preparación, el correo o el ajuste pendiente ya terminó. |
En ese ejemplo, recibir dos entregas del mismo evento debería dejar dos entradas de recepción y una sola tarea de preparación. Si llegan dos eventos distintos sobre el mismo pedido, habrá que comprobar qué significa cada uno. No basta con descartar todo lo que comparta referencia comercial: podrías perder una actualización válida.
Define el significado de cada campo antes de conectar aplicaciones. Un procedimiento operativo con responsables y excepciones ayuda a que tienda, almacén y proveedor técnico entiendan la misma secuencia.
Comprueba qué sucede si el proceso se interrumpe
Pide una revisión con estados comprensibles: recibido, pendiente, terminado o requiere intervención. El nombre exacto importa menos que poder distinguir una recepción guardada de una operación completada. Un indicador genérico de «correcto» resulta insuficiente si oculta que todavía falta crear una tarea de almacén.
El punto delicado es la interrupción entre pasos. Si el sistema marca el aviso como terminado antes de guardar la tarea, podría perder trabajo. Si guarda la tarea y después falla al recordar que la creó, podría duplicarla. El equipo técnico debe explicar cómo mantiene la coherencia y cómo controla dos ejecuciones simultáneas.
No necesitas decidir el mecanismo de base de datos para evaluar la respuesta. Sí puedes solicitar una prueba de concurrencia, una interrupción deliberada y la recuperación posterior. El resultado esperado debe describir acciones concretas: qué queda guardado, qué se reintentará y qué verá la persona responsable.
Prepara cinco pruebas que un negocio puede revisar
- Repetición consecutiva. Reenviar el mismo evento en un entorno de pruebas y contar las acciones internas generadas.
- Recepción simultánea. Procesar dos entregas a la vez para comprobar que el control no depende únicamente de llegar primero.
- Orden diferente. Presentar una actualización antes que otra y observar cómo consulta o reconcilia el estado vigente.
- Interrupción a mitad. Detener un paso y comprobar qué ocurre al recuperar el trabajo pendiente.
- Aviso no válido. Usar una notificación de prueba que no supere la verificación prevista y confirmar que no modifica pedidos.
Para cada prueba, anota la referencia ficticia, el resultado esperado, lo observado y la evidencia disponible. No uses pedidos reales para forzar errores. Una captura del panel puede ser útil, pero el recuento debe incluir la tarea o registro final, no solo la respuesta del webhook.
La ficha de incidencias con estado y seguimiento puede adaptarse a estas comprobaciones. Mantén las credenciales y los datos completos de clientes fuera de capturas compartidas. Una referencia de prueba suele bastar para enlazar la observación con su registro técnico.
Deja una forma de recuperar el trabajo pendiente
Una integración necesita que alguien pueda localizar los casos detenidos, comprender el motivo y decidir el siguiente paso. Pide una lista de pendientes con su antigüedad y una explicación del reintento. Un botón de «reenviar todo» merece una comprobación especial: recuperar tareas no debería volver a ejecutar las que ya terminaron.
Acuerda quién revisa esa lista y cómo se entrega el diagnóstico si cambia el proveedor. Si estás comparando soluciones, utiliza la comparativa de plataformas de automatización para situar su mantenimiento; la marca elegida no demuestra por sí sola que tu flujo controle duplicados.
El criterio de aceptación puede ser muy sencillo: ante una repetición controlada, el pedido conserva una sola acción válida y el historial permite explicar cada intento. Esa prueba aporta más información para decidir que una automatización rápida cuyo comportamiento ante fallos nadie puede describir.
Fuentes y fecha de revisión
Revisión: 19 de noviembre de 2026. Se contrastaron los reintentos, la identificación del evento, la comprobación de su procedencia y las claves de idempotencia con la documentación oficial de Stripe. El flujo y las pruebas de aceptación son ejemplos editoriales para revisar una integración propia en un entorno de pruebas.