Qué importa primero: Los clientes pueden ser cobrados dos veces cuando checkout se vuelve a enviar, un tiempo de espera alienta otro intento, o la lógica de reintentar personalizada carece de idempotencia.
Qué indica realmente este síntoma
El estado del pedido WooCommerce por sí solo no puede probar el número de capturas. Los registros de transacciones Gateway, las claves de idempotencia y fecha y horas son decisivos.
Recopila pruebas antes de cambiar nada
- Recoger todos los cargos, autorizaciones y referencias de devolución de pasarela.
- Cargas de mapas a pedidos WooCommerce, checkout sesiones e intentos del cliente.
- Revisa el tiempo de espera, reintentar y webhook logs alrededor del incidente.
- Deshabilitar la ruta de pago fallida si la carga duplicada está en curso.
Causas más habituales
- Intentar de nuevo con el cliente: El primer pago completado sin una página de confirmación utilizable.
- Gateway/client reintento: Una petición se repitió sin una clave de idempotencia.
- Webhook y carrera de retorno: Dos rutas de código capturan o finalizan el pago.
- Código de pago personalizado: Las llamadas de integración capturan más de una vez.
Secuencia segura de diagnóstico y reparación
- Contener el problema y comunicarse con los clientes afectados.
- Reembolso confirmado capturas duplicadas de acuerdo con pasarela y proceso de negocio.
- Implementar la idempotencia y una vía de pago-completamiento autorizada.
- Prueba el tiempo de espera y los escenarios repetitivos, no solo el camino feliz.
Cómo distinguir entre las causas probables
No trates Intentar de nuevo con el cliente y Gateway/client reintento como causas equivalentes. El primer pago completado sin una página de confirmación utilizable. En cambio, una petición se repitió sin una clave de idempotencia. Para distinguirlas, usa estas dos comprobaciones: Recoger todos los cargos, autorizaciones y referencias de devolución de pasarela; y cargas de mapas a pedidos WooCommerce, checkout sesiones e intentos del cliente. Con esos datos podrás decidir si conviene aplicar la primera acción controlada —Contener el problema y comunicarse con los clientes afectados— o si debes conservar el estado actual y ampliar la investigación.
En una tienda activa, reproduce el problema con un pedido de prueba controlado y sigue el mismo recorrido de pago, stock, impuestos y notificaciones que usan los clientes. No cambies varios componentes del checkout a la vez, porque destruirías la evidencia necesaria para atribuir el fallo. Documenta la fecha y hora exactas, la URL o transacción afectada, el último estado correcto conocido y cada cambio realizado durante el diagnóstico. Ese registro permite distinguir una reparación reproducible de una desaparición temporal del síntoma.
Qué no debes hacer
No reembolsar desde WooCommerce hasta que sepa si el pasarela admite y registró ese reembolso; de lo contrario, los registros pueden diferir más.
Cómo verificar la reparación
- Cada checkout sesión puede producir como máximo un pago capturado.
- Gateway y los registros de reembolso de pedidos coinciden.
- Los tiempos de espera y los llamadas de retorno duplicados permanecen seguros e idempotentes.
Que el síntoma visible desaparezca no es suficiente. Cierra la incidencia solo cuando la acción original que fallaba, el recorrido de negocio relacionado y los registros relevantes confirmen que el problema ha desaparecido.