Què cal saber primer: un client pot acabar amb dos càrrecs si torna a enviar el checkout, si una espera llarga el porta a repetir el pagament o si una integració reintenta una captura sense idempotència. Abans de tocar la comanda, cal determinar quantes transaccions reals ha registrat la passarel·la.
Com saber si hi ha dos càrrecs reals
L’estat de WooCommerce no és prou prova. Compara l’ID de la comanda amb totes les autoritzacions i captures de la passarel·la, els imports, la moneda i les marques de temps. Dos correus de confirmació no impliquen necessàriament dos cobraments; dues captures diferents, sí.
Quines dades has de conservar
- ID de comanda i sessió de checkout.
- ID de cada transacció, autorització, captura i reemborsament.
- Registres de timeout, retorn del navegador i webhooks.
- Qualsevol clau d’idempotència enviada a la passarel·la.
Els patrons que expliquen més duplicats
- Reintent del client: el pagament es completa però la confirmació no arriba i l’usuari prova de nou.
- Reintent tècnic: el client HTTP o la passarel·la repeteix la petició sense una clau estable.
- Dues rutes de captura: el retorn síncron i el webhook executen lògica de cobrament.
- Codi personalitzat: un plugin o integració crida la captura més d’una vegada.
Ordre segur per resoldre-ho
- Atura temporalment la ruta concreta que està duplicant càrrecs si l’incident continua actiu.
- Concilia cada transacció amb la passarel·la abans de fer cap reemborsament.
- Defineix una única ruta autoritzada de captura i afegeix idempotència als reintents.
- Prova explícitament timeout, doble clic, refresc, retorn tardà i webhook repetit.
Com distingir un pagament duplicat d’una comanda duplicada
Són problemes relacionats, però no equivalents. Pots tenir dues comandes i una sola captura, o una comanda i dues captures. Si també veus ordres repetides, revisa com diagnosticar comandes duplicades a WooCommerce. Si el pagament figura completat però l’estat local no quadra, consulta com conciliar un pagament completat amb una comanda fallida.
Què no convé fer
No canviïs estats ni generis reemborsaments massius des de WooCommerce abans de confirmar què ha registrat la passarel·la. Fer-ho pot separar encara més el llibre de comandes del llibre financer.
Quan pots donar la incidència per tancada
El flux queda reparat quan una sessió de checkout no pot produir més d’una captura, els reintents i webhooks repetits són idempotents, i els registres de WooCommerce i de la passarel·la coincideixen transacció per transacció.
CRITERI D’INCIDENT WP REPAIR
Seqüència d’intervenció segura
l’estat de la comanda WooCommerce per si mateix no pot provar el nombre de captures. Els registres de transaccions Gateway, les claus d’idempotència i data i hores són decisius.
- Recollir tots els càrrecs, autoritzacions i referències de retorn de passarel· la.
- Càrregues de mapes a comandes WooCommerce, checkout sessions i intents del client.
- Revisa el temps d'espera, reintentar i webhook registres al voltant de l’incident.
- Deshabilita el camí de pagament fallat si la càrrega duplicada està en curs.
Què ha de quedar verificat
- Cada checkout sessió pot produir com a màxim un pagament capturat.
- Gateway i els registres de reemborsament de comandes coincideixen.
- Els temps d'espera i les trucades de retorn duplicats romanen segurs i idempotents.
Fonts tècniques oficials
Aquesta guia explica el diagnòstic. Si la web està afectada ara mateix, la intervenció ha de preservar una via de recuperació i verificar el recorregut real del negoci.
Veure el servei de reparació urgent →SOBRE ESTE SÍNTOMA
Preguntes freqüents d'aquesta guia.
Pot l'estat de la comanda WooCommerce dir-me quantes vegades un client va ser cobrat realment?+
No. L’estat de la comanda per si mateix no pot provar el nombre de captures; els registres de transaccions gateway, les claus d’idempotència i les marques de temps són la prova decisiva per a determinar si un client va ser acusat una o diverses vegades.
He d'emetre un reemborsament directament des de WooCommerce tan aviat com localitzi una càrrega duplicada?+
No fins que confirmi que el gateway realment suporta i ha registrat aquest reemborsament. El reemborsament de WooCommerce sense aquest xec pot causar que el gateway i ordenar registres diverixin encara més en lloc de reconciliar-los.
Si els càrrecs duplicats estan succeint activament en aquest moment, quin és el primer moviment?+
Deshabilita la ruta de pagament fallat immediatament si la càrrega duplicada està en curs, abans de treballar a través de l’anàlisi de causa arrel. Comptar amb dany actiu als clients té prioritat sobre diagnosticar si es tracta d’un retent de client, un retent de gateway, o una carrera entre webhook i el maneig de pàgina de retorn.
Prova només el flux checkout exitós captura aquest tipus d’error?+
No. La guia requereix específicament provar els escenaris de temps fora i repetitiu, no només el camí feliç, ja que els pagaments duplicats normalment sorgeixen de les condicions de reintento i carrera que mai apareixen quan tot es completa en el primer intent.