Pagamenti WooCommerce non riusciti: ordini in attesa e controlli da fare

Raccogli i dati prima di far riprovare il cliente

Apri il singolo ordine e annota il numero, il totale, il metodo di pagamento, lo stato e l’orario del tentativo. Leggi le note alla ricerca di identificativo della transazione, errore del gateway o passaggio di stato. Conserva il messaggio apparso al cliente, oscurando informazioni personali non necessarie.

Consulta poi il pannello del servizio di pagamento e cerca la transazione corrispondente. La procedura WooCommerce per gli ordini problematici raccomanda questa verifica prima di chiedere un altro tentativo quando l’addebito è incerto.

Una scheda utile può riportare: “Ordine 1254, carta, ore 10:15, checkout bloccato dopo l’autenticazione”. È un punto di partenza concreto per l’assistenza. Evita prove ripetute con carte reali: possono creare più autorizzazioni o addebiti e complicare la ricostruzione.

Interpreta lo stato senza confonderlo con la transazione

Gli stati ufficiali degli ordini WooCommerce descrivono fasi diverse. Le etichette possono cambiare con lingua o personalizzazioni:

• In attesa di pagamento: l’ordine è presente, ma il pagamento non risulta confermato.
• In sospeso: può essere attesa una conferma, come per un bonifico o un pagamento autorizzato da acquisire.
• Fallito: il tentativo risulta non riuscito o rifiutato; vanno lette le note.
• In lavorazione: per un normale acquisto online di prodotti fisici il pagamento è generalmente ricevuto e resta da evadere l’ordine.
• Completato: indica l’evasione conclusa secondo il flusso del negozio.

Un ordine che resta “In lavorazione” non è necessariamente guasto. Viceversa, impostarlo manualmente su “Completato” non dimostra che il gateway abbia incassato. Personalizzazioni e metodi manuali richiedono sempre un confronto con la documentazione specifica.

Distingui autorizzazione, acquisizione e rifiuto

Una somma temporaneamente riservata sulla carta può essere un’autorizzazione, non un importo già acquisito dal negozio. Alcuni gateway permettono di separare questi passaggi. La documentazione WooPayments su autorizzazione e acquisizione ne illustra il funzionamento: l’autorizzazione ha una durata limitata e deve essere acquisita secondo le regole del servizio.

Controlla quindi lo stato nel pannello del gateway. Se il flusso prevede l’acquisizione manuale, deve esistere un responsabile che la gestisca nei tempi previsti. Non attivare questa opzione come tentativo generico di risolvere un errore.

Se invece il pagamento è rifiutato, leggi il codice restituito. Autenticazione incompleta, dati non validi o decisioni del servizio richiedono azioni diverse. La guida dell’estensione Stripe sui pagamenti non riusciti mostra come interpretare i messaggi; le sue indicazioni valgono per quella specifica integrazione.

Controlla la conferma tra gateway e negozio

Quando il gateway registra un pagamento riuscito ma l’ordine resta in attesa, il tecnico deve verificare la comunicazione di ritorno. Una notifica, spesso chiamata webhook o callback, permette al servizio di comunicare l’esito al sito. Non coincide necessariamente con la pagina che il cliente vede dopo il pagamento.

Controlla con l’assistenza del gateway destinazione delle notifiche, esito delle consegne e corrispondenza fra ordine e transazione. Se serve inviare nuovamente una notifica, segui la procedura specifica del fornitore e verifica l’effetto su quell’ordine.

Non creare alla cieca un webhook dal menu generale di WooCommerce: i webhook delle integrazioni esterne non sono automaticamente quelli usati dal plugin di pagamento. La documentazione WooCommerce sui webhook descrive il sistema generale; per il gateway serve la sua documentazione dedicata.

Leggi gli errori e ricostruisci le modifiche recenti

I registri aiutano a distinguere un rifiuto del servizio da un errore del sito. La guida WooCommerce ai problemi di pagamento indica il percorso WooCommerce → Stato → Log. I dati disponibili dipendono dal plugin e dall’eventuale registrazione attiva; un log attivato oggi non ricostruisce automaticamente un tentativo passato.

Fornisci al tecnico versione di WooCommerce, estensione del gateway e cambi recenti a tema, cache, sicurezza o checkout. Se l’errore compare dopo un aggiornamento, può essere utile la guida al sito WordPress che non funziona dopo un aggiornamento.

Non pubblicare registri completi in pagine accessibili a tutti: possono contenere dati degli ordini o dettagli tecnici. Condividi tramite il canale di assistenza gli estratti necessari e concorda durata e disattivazione dell’eventuale registrazione approfondita.

Riproduci il problema in un ambiente di prova

Prepara con il tecnico una copia di prova separata dal negozio, configurata per non inviare ordini a corrieri o gestionali reali. Usa la modalità test o l’account di prova previsti dal gateway. WooPayments documenta pagamenti simulati, compresi esiti differenti, senza impiegare carte reali.

Riproduci lo stesso percorso: prodotti, spedizione, dispositivo e metodo di pagamento. Per isolare un conflitto, il tecnico può seguire la procedura ufficiale per plugin e temi sulla copia di prova, cambiando una variabile alla volta.

Se il sito è stato clonato, controlla anche come il gateway distingue la copia dal negozio operativo. WooPayments descrive questo caso nella documentazione della modalità sicura. Non trasferire indiscriminatamente impostazioni e database di test sul sito che continua a ricevere ordini.

Verifica ogni ordine coinvolto e il percorso completo

La correzione tecnica va accompagnata dalla verifica degli ordini interessati. Prepara un elenco con numero ordine, identificativo della transazione, importo e risultato confermato dal gateway. Individua eventuali doppioni prima di evadere, annullare o avviare rimborsi; l’azione corretta dipende dai movimenti effettivi.

Per il collaudo finale controlla:

1. Il checkout mostra l’esito previsto anche da smartphone.
2. Ordine e transazione corrispondono senza duplicazioni.
3. Lo stato finale è coerente con metodo e prodotti.
4. Le notifiche arrivano al negozio e al cliente.
5. Magazzino e integrazioni ricevono l’evento atteso.

Assegna a una persona la verifica dei successivi ordini reali. La manutenzione del sito WordPress dovrebbe includere questi percorsi commerciali, così un controllo periodico non si ferma alla sola apertura della homepage.