Pagament completat, però comanda fallida a WooCommerce: conciliar abans d’editar

Què importa primer: El client pot haver pagat tot i que WooCommerce va registrar un temps d’espera, error de crida o error fatal local. La transacció passarel· la és la font financera de la veritat per a si els fons es mouen.

Què indica realment aquest símptoma

Canvia l’ordre a Processament sense proves pot complir una ordre no pagada, mentre que tornar a intentar el pagament pot crear un càrrec duplicat.

Recull proves abans de canviar res

• Registre d’identificació de comanda, quantitat, moneda, referència passarel·la i hora exacta.
• Comprova el plafó de control passarel· la per a l’estat capturat, autoritzat, fallit o reemborsat.
• Coincideix amb passarel· la webhook/API registres amb WooCommerce registres i notes de comanda.
• Inspecciona estoc i els efectes secundaris de correu electrònic abans de qualsevol canvi d’estat manual.

Causes més habituals

• Ha fallat la pàgina de retorn: El pagament ha tingut èxit, però la redirecció orientada al client ha fallat.
• Webhook rebutjat: La devolució de crida passarel· la no ha pogut autenticar- se ni arribar a WordPress.
• Local fatal després del pagament: WooCommerce es va estavellar en actualitzar la comanda.
• Ambigüitat del temps d’espera: La petició es cronometrà mentre que el passarel·la es va completar aixíncronament.

Seqüència segura de diagnòstic i reparació

1. Reconeix cada transacció d’ordre afectada per transacció.
2. Corregir la crida de retorn, webhook o error fatal per a comandes futures.
3. L’actualització només va confirmar les comandes pagades amb una nota d’auditoria i el maneig deliberat d’ascensament.
4. Executeu un pagament de prova controlat a través del cicle complet.

Com distingir entre les causes probables

No tractis Ha fallat la pàgina de retorn i Webhook rebutjat com a causes equivalents. El pagament ha tingut èxit, però la redirecció orientada al client ha fallat. En canvi, la devolució de crida passarel· la no ha pogut autenticar- se ni arribar a WordPress. Per distingir- les, usa aquestes dues comprovacions: Registre d’identificació de comanda, quantitat, moneda, referència passarel· la i hora exacta; i comprova el plafó de control passarel· la per a l’estat capturat, autoritzat, fallit o reemborsat. Amb aquestes dades podreu decidir si convé aplicar la primera acció controlada —Reconcili cada transacció d’ordre afectada per transacció — o si has de conservar l’estat actual i ampliar la investigació.

En una botiga activa, reprodueix el problema amb una comanda de prova controlada i segueix el mateix recorregut de pagament, estoc, impostos i notificacions que usen els clients. No canviïs diversos components del checkout alhora, perquè destruiries l’evidència necessària per atribuir l’error. Documenta la data i hora exactes, la URL o transacció afectada, l’últim estat correcte conegut i cada canvi realitzat durant el diagnòstic. Aquest registre permet distingir una reparació reproduïble d’una desaparició temporal del símptoma.

Què no has de fer

No demani al client que torni a pagar fins que s’ hagi comprovat la transacció passarel· la.

Com verificar la reparació

• Gateway i WooCommerce estan d’acord en l’estat de pagament final.
• Stock, el correu electrònic i els efectes secundaris de compliment passen exactament una vegada.
• Un nou pagament controlat s’ actualitza automàticament.

Que el símptoma visible desaparegui no és suficient. Tanca la incidència només quan l’acció original que fallava, el recorregut de negoci relacionat i els registres rellevants confirmin que el problema ha desaparegut.