Un gateway di pagamento è il collegamento tra il tuo negozio WooCommerce e la società che elabora i pagamenti, come Stripe, PayPal o la tua banca. Quando smette di funzionare, i clienti potrebbero non riuscire a pagare, oppure potrebbero pagare senza che il tuo negozio lo sappia.
Potresti notare che:
- un metodo di pagamento è sparito dal checkout
- i clienti vedono un errore quando provano a pagare
- ogni pagamento viene rifiutato, comprese carte valide
- gli ordini restano "In attesa di pagamento" anche se il cliente dice di aver pagato
- i pagamenti compaiono nella dashboard del provider ma non in WooCommerce
- hai ricevuto un’email dal provider di pagamento riguardo al tuo account
È un problema da affrontare in fretta, perché incide sulle vendite e può lasciare i clienti nel dubbio di aver pagato o meno. Tuttavia, un problema del gateway di solito non significa che il denaro sia andato perso. Nella maggior parte dei casi le informazioni sul pagamento sono ancora disponibili presso il provider, e la causa si trova controllando alcuni punti specifici.
Questa guida spiega cosa di solito va storto, cosa puoi controllare in sicurezza, come gestire gli ordini in attesa e quando è meglio chiedere supporto tecnico.
Come funziona un gateway di pagamento in WooCommerce?
La maggior parte dei gateway si aggiunge a WooCommerce con un plugin, di solito fornito dalla società di pagamento o da uno sviluppatore terzo.
Un pagamento tipico prevede diversi passaggi:
- Il cliente sceglie un metodo di pagamento al checkout.
- WooCommerce crea l’ordine con lo stato "In attesa di pagamento".
- Il cliente paga, sul tuo sito o sulla pagina del provider.
- Il provider invia una conferma al tuo sito, spesso tramite un webhook o una notifica simile.
- WooCommerce aggiorna l’ordine, per esempio a "In lavorazione", e invia l’email di conferma.
Un problema in uno qualsiasi di questi passaggi può bloccare i pagamenti. I casi più confusi sono i guasti al passaggio 4: il cliente ha pagato, ma il tuo negozio non riceve mai la conferma.
Cosa potrebbe aver causato il problema?
Chiavi API e credenziali scadute o cambiate
Il plugin del gateway usa chiavi, token o altre credenziali per comunicare con il provider. Se scadono, vengono rigenerate nella dashboard del provider o vengono sostituite da un collega, il plugin non riesce più a collegarsi.
Succede spesso dopo che qualcuno ruota le chiavi per motivi di sicurezza, sposta l’account su un nuovo utente o ricollega il plugin.
Modalità test rimasta attiva
Molti gateway hanno una modalità test o sandbox per provare i pagamenti senza denaro reale. Se è rimasta attiva dopo i test, o è stata attivata per errore, le carte reali possono essere rifiutate, oppure gli ordini possono risultare pagati senza che sia stato incassato alcun pagamento reale.
Webhook che non arrivano
I webhook sono messaggi che il provider invia al tuo sito quando succede qualcosa, come un pagamento riuscito o un rimborso. Se non riescono a raggiungere il sito, i pagamenti possono andare a buon fine presso il provider mentre gli ordini in WooCommerce restano in attesa.
I webhook possono non arrivare perché l’indirizzo configurato presso il provider è sbagliato, il dominio è cambiato, il sito era offline o una regola di sicurezza o di cache blocca la richiesta.
Problemi con il certificato SSL
I provider di pagamento si aspettano una connessione sicura. Se il certificato SSL è scaduto, è configurato male o non copre il dominio usato per le notifiche, il checkout può mostrare avvisi e il provider può non riuscire a consegnare i webhook.
Un aggiornamento del plugin del gateway
Un aggiornamento del plugin del gateway, di WooCommerce o di WordPress può cambiare il funzionamento del gateway, richiedere nuove impostazioni o introdurre un conflitto con un altro plugin o con il tipo di checkout in uso. Alcuni gateway vanno anche ricollegati dopo un aggiornamento importante.
Limitazioni su valuta e paese
Un metodo di pagamento può essere nascosto o rifiutato se non supporta la valuta del negozio, il paese del cliente o l’importo dell’ordine. Cambiare la valuta del negozio, aggiungere nuovi paesi o usare un selettore di valuta può far sparire un metodo senza alcun errore.
L’account è limitato dal provider di pagamento
I provider possono limitare un account, per esempio mentre esaminano documenti, verificano l’azienda o controllano attività insolite. In questo caso il problema non è affatto sul tuo sito. Cerca email o avvisi nella dashboard del provider.
Altri problemi sul sito
A volte il gateway è a posto ma è il checkout stesso a essere rotto, per esempio per un errore JavaScript, una cache o un conflitto tra plugin. La nostra guida sui problemi del checkout di WooCommerce tratta queste cause.
Cosa significano gli ordini bloccati "In attesa di pagamento"?
Un ordine con lo stato "In attesa di pagamento" è stato creato, ma WooCommerce non ha ricevuto la conferma del pagamento.
Può significare che:
- il cliente ha avviato il pagamento ma non l’ha completato
- il pagamento non è andato a buon fine
- il cliente ha pagato, ma la conferma non è arrivata al tuo sito
Il primo caso è normale: alcuni clienti abbandonano l’acquisto. Un aumento improvviso degli ordini in attesa, o clienti che ti dicono di aver pagato, fanno pensare al terzo caso.
WooCommerce può annullare automaticamente gli ordini in attesa non pagati dopo un tempo impostato nelle impostazioni di magazzino, quindi gli ordini in attesa potrebbero in seguito risultare annullati.
Prima di segnare come pagato un ordine in attesa, verifica il pagamento nella dashboard del provider. Non spedire mai un ordine basandoti solo sul fatto che il cliente dice di averlo pagato.
Per prima cosa, cerca di capire cosa è cambiato
Pensa a cosa è successo prima che i pagamenti si bloccassero:
- È stato aggiornato il plugin del gateway, WooCommerce o WordPress?
- Qualcuno ha cambiato le chiavi API o ricollegato l’account?
- A un certo punto è stata attivata la modalità test?
- È stato cambiato il dominio o migrato il sito?
- Il certificato SSL è stato rinnovato o cambiato?
- Un plugin di sicurezza, un firewall o una cache sono stati configurati diversamente?
- Hai cambiato la valuta del negozio o i paesi in cui vendi?
- Il tuo provider di pagamento ti ha inviato qualche email?
Controlla anche quando è stato registrato in WooCommerce l’ultimo pagamento riuscito e confrontalo con l’ultimo pagamento nella dashboard del provider. Se non coincidono, probabilmente il passaggio di conferma non funziona.
Cosa puoi controllare in sicurezza?
Controlla la dashboard del provider di pagamento
Accedi alla dashboard del provider e controlla:
- se compaiono i pagamenti recenti e con quale stato
- eventuali avvisi sul tuo account, sulla verifica o su limiti
- se l’account è in modalità live o in modalità test
- le impostazioni dei webhook o delle notifiche, se disponibili
La maggior parte dei provider mostra se le consegne recenti dei webhook sono riuscite o fallite. La posizione esatta dipende dal provider.
Controlla le impostazioni del gateway in WooCommerce
Vai su WooCommerce > Settings > Payments (WooCommerce > Impostazioni > Pagamenti) e apri le impostazioni del gateway interessato. Verifica che:
- il metodo di pagamento sia attivo
- la modalità test o sandbox sia disattivata sul negozio online
- l’account sia collegato o le credenziali siano compilate
Non incollare nuove chiavi a meno che tu non sia sicuro che siano le chiavi live corrette per questo negozio.
Rivedi gli ordini in attesa
Vai su WooCommerce > Orders (WooCommerce > Ordini) e filtra per "In attesa di pagamento". Guarda le date. Se gli ordini in attesa hanno iniziato ad accumularsi da un certo giorno, è un indizio utile.
Fai un pagamento di prova
Se possibile, fai un vero ordine di basso importo con il gateway live e controlla il risultato sia in WooCommerce sia nella dashboard del provider. Poi rimborsalo.
Contatta il tuo provider di pagamento
Se vedi avvisi sull’account, pagamenti rifiutati senza un motivo chiaro o webhook che non arrivano, contatta l’assistenza del provider. Può vedere dettagli sul tuo account e sulla sua parte del collegamento che dal tuo sito non sono visibili.
Cosa evitare?
Evita di:
- rigenerare le chiavi API senza sapere dove altro vengono usate
- attivare la modalità test su un negozio online durante l’orario di vendita
- segnare come pagati gli ordini in attesa senza controllare la dashboard del provider
- eliminare e reinstallare il plugin del gateway senza un backup
- disattivare in modo permanente il firewall o il plugin di sicurezza
- installare un secondo plugin di gateway per lo stesso provider accanto al primo
- condividere chiavi API o credenziali dell’account via email o in forum pubblici
Cambia una cosa alla volta e fai un test dopo ogni modifica.
Quando chiedere supporto tecnico?
Il supporto tecnico è consigliato quando:
- ai clienti viene addebitato il pagamento ma gli ordini restano in attesa
- tutti i pagamenti falliscono e il provider dice che l’account è a posto
- i webhook non arrivano e non riesci a capire perché
- il problema è iniziato dopo un aggiornamento o una migrazione
- vendi abbonamenti o pagamenti ricorrenti
- il negozio usa codice personalizzato intorno al checkout o ai pagamenti
- non ti senti a tuo agio a modificare le impostazioni del gateway su un negozio online
- il problema continua a ripresentarsi
Non devi conoscere la causa prima di chiedere aiuto. Una descrizione di cosa vedono i clienti e di cosa mostra la dashboard del provider è un buon punto di partenza.
Quali informazioni raccogliere?
Dettagli utili:
- l’URL del sito
- il provider di pagamento e il nome del plugin del gateway
- data e ora dell’ultimo pagamento riuscito
- screenshot di eventuali errori mostrati ai clienti
- il numero di ordini bloccati "In attesa di pagamento"
- eventuali avvisi o email del provider di pagamento
- se le consegne dei webhook falliscono, se riesci a vederlo
- eventuali aggiornamenti, migrazioni o modifiche alle impostazioni recenti
- il report di stato del sistema di WooCommerce
Non inviare chiavi API, password o dati completi delle carte via email. D4Hub può spiegarti come condividere gli accessi in sicurezza.
Come può aiutarti D4Hub
L’obiettivo è ripristinare i pagamenti e assicurarsi che ogni ordine pagato venga registrato correttamente.
A seconda del problema, D4Hub può aiutarti a:
- controllare la configurazione e il collegamento del gateway
- rivedere i log di WooCommerce e del gateway
- controllare le impostazioni dei webhook e le consegne fallite
- trovare regole di sicurezza, firewall o cache che bloccano le notifiche di pagamento
- risolvere problemi di SSL e di dominio che incidono sui pagamenti
- individuare conflitti causati da aggiornamenti di plugin, WooCommerce o WordPress
- riconciliare gli ordini in attesa con i pagamenti nella dashboard del provider
- controllare le impostazioni di compatibilità su valuta, paese e checkout
- testare l’intero flusso di pagamento dopo la correzione
- consigliarti un monitoraggio per accorgerti prima dei problemi di pagamento
Puoi chiedere supporto in qualsiasi fase del processo.
Per esempio, D4Hub può:
- confermare se una modifica che vuoi fare è sicura
- farsi carico dell’analisi dopo un tentativo non riuscito
- completare l’intera diagnosi e riparazione
- rivedere il flusso di pagamento dopo una correzione temporanea
Per chi vuole mettere le mani in pasta: controlli tecnici su un gateway di pagamento
I controlli che seguono sono per chi ha dimestichezza con la bacheca di WordPress, i log del server e la dashboard del proprio provider di pagamento.
Prima di modificare qualsiasi impostazione su un negozio online, fai un backup recente che includa il database. Cambia una cosa alla volta e fai un pagamento di prova dopo ogni modifica. Non incollare mai chiavi API o segreti in log, ticket o luoghi pubblici.
Leggi i log del gateway in WooCommerce
Vai su WooCommerce > Status > Logs (WooCommerce > Stato > Log).
A seconda della versione di WooCommerce, vedrai un elenco di file di log o un elenco di voci filtrabili per origine. Cerca l’origine con il nome del tuo plugin del gateway, e fatal-errors.
Concentrati sulle voci registrate nel momento di un pagamento fallito. Indizi utili sono errori di autenticazione, richieste rifiutate, timeout o messaggi su credenziali non valide o mancanti.
Molti plugin di gateway scrivono log dettagliati solo quando nelle loro impostazioni è attiva un’opzione di logging o debug, in WooCommerce > Settings > Payments (WooCommerce > Impostazioni > Pagamenti). Disattivala di nuovo quando hai finito, perché i log possono contenere dati dei clienti.
Controlla la consegna dei webhook presso il provider
Nella dashboard del provider di pagamento, trova la sezione dei webhook, delle notifiche o delle callback. Il nome varia a seconda del provider.
Controlla:
- che l’indirizzo del webhook usi il tuo dominio attuale e
https:// - che corrisponda all’indirizzo che il plugin del gateway si aspetta, spesso mostrato nelle impostazioni del plugin
- se le consegne recenti sono riuscite o fallite
- il codice di risposta restituito dal tuo sito per le consegne fallite
Un 403 spesso significa che un firewall o una regola di sicurezza ha bloccato la richiesta. Un 404 fa pensare a un indirizzo sbagliato, per esempio dopo un cambio di dominio. Un codice 5xx indica un errore sul tuo server. Un timeout può significare che il sito è lento o non raggiungibile.
Molti provider ti permettono di inviare di nuovo una notifica fallita dopo aver risolto la causa.
Assicurati che gli endpoint di pagamento non siano bloccati o in cache
I gateway ricevono le notifiche a indirizzi specifici del tuo sito. Alcuni usano l’endpoint API di WooCommerce, che ha la forma /?wc-api= seguito da un nome, altri usano indirizzi sotto /wp-json/. La documentazione o le impostazioni del plugin di solito mostrano l’indirizzo esatto.
Verifica che questi indirizzi non siano:
- bloccati da un plugin di sicurezza, dal firewall dell’hosting o da una regola del firewall della CDN
- sottoposti a una protezione anti-bot o a una schermata CAPTCHA
- messi in cache da un plugin di cache, dalla cache dell’hosting o da una CDN
- reindirizzati, per esempio da
httpahttpso trawwwe non-www, in un modo che fa perdere la richiesta
I log del firewall e della CDN spesso mostrano richieste bloccate provenienti dai server del provider. Se aggiungi un’eccezione, rendila il più ristretta possibile, solo per l’indirizzo specifico, invece di disattivare la protezione per tutto il sito.
Controlla il certificato SSL
Da un terminale, sostituendo example.com con il tuo dominio:
echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null | openssl x509 -noout -datesLa riga notAfter mostra la data di scadenza. Apri anche il sito in un browser e verifica che nella pagina del checkout non ci siano avvisi sul certificato.
Controlla la versione del plugin del gateway
Con WP-CLI:
wp plugin list --status=activeAnnota la versione del plugin del gateway e di WooCommerce. Se il problema è iniziato dopo un aggiornamento, controlla nel changelog del plugin se ci sono modifiche che richiedono nuove impostazioni o un nuovo collegamento.
Rivedi gli ordini in attesa
Vai su WooCommerce > Orders (WooCommerce > Ordini) e filtra per "In attesa di pagamento". Per ogni ordine in attesa recente, cerca il numero d’ordine o l’email del cliente nella dashboard del provider.
Se il pagamento è andato a buon fine presso il provider, l’ordine va riconciliato. Alcuni gateway aggiornano automaticamente l’ordine quando un webhook fallito viene inviato di nuovo. Altrimenti, aggiorna l’ordine a mano solo dopo aver confermato il pagamento e aggiungi una nota all’ordine che spieghi cosa hai controllato.
Il tempo dopo il quale WooCommerce annulla gli ordini non pagati si imposta con l’opzione "Hold stock (minutes)" in WooCommerce > Settings > Products > Inventory (WooCommerce > Impostazioni > Prodotti > Inventario). Tienilo presente quando rivedi ordini che risultano annullati.
D4Hub può aiutarti a leggere i log e i risultati dei webhook e a decidere il prossimo passo sicuro.
Domande frequenti
Ai miei clienti è stato addebitato due volte?
Può succedere se un cliente riprova dopo un apparente errore. Controlla nella dashboard del provider se ci sono pagamenti doppi dello stesso cliente e rimborsa da lì gli eventuali doppioni. Contattare subito i clienti coinvolti aiuta a evitare confusione.
Perché un metodo di pagamento è sparito dal checkout?
Potrebbe essere stato disattivato, potrebbe non supportare la valuta, il paese o l’importo dell’ordine attuali, oppure il plugin potrebbe non essere compatibile con il tuo tipo di checkout. Controlla prima le impostazioni del gateway, poi i log.
Il provider dice che dal suo lato è tutto a posto. E adesso?
Allora il problema è probabilmente sul tuo sito o tra i due: credenziali, webhook, SSL, una regola di sicurezza o un conflitto tra plugin. I log di WooCommerce e i risultati delle consegne dei webhook sono i punti migliori da cui partire.
Posso passare a un altro gateway di pagamento come soluzione rapida?
Può funzionare come misura temporanea, ma un nuovo gateway richiede un proprio account, una verifica e dei test. E non risolve la riconciliazione degli ordini già bloccati in attesa. Consideralo un’opzione di breve periodo, non una soluzione.
È sicuro segnare come pagati gli ordini in attesa?
Solo dopo aver confermato il pagamento nella dashboard del provider. Aggiungi una nota all’ordine che spieghi come l’hai verificato.
D4Hub può aiutarmi se ho già provato a risolvere da solo?
Sì. Spiega cosa hai cambiato e cosa è successo dopo ogni modifica. Questo aiuta a ricostruire l’accaduto e a trovare il prossimo passo sicuro.