WooCommerce e Webhook Stripe: Risolvere gli Ordini Bloccati in Attesa di Pagamento

Gestire un e-commerce richiede flussi di vendita affidabili e tempestivi. Molti gestori riscontrano frequenti ordini bloccati in attesa di pagamento dopo la transazione con carta di credito. Questo disguido genera carrelli abbandonati, lamentele e perdite economiche.

Il cliente completa il pagamento su Stripe. Il denaro viene scalato regolarmente dalla carta. Tuttavia, l’ordine rimane nello stato ‘In attesa di pagamento’ dentro WooCommerce.

In questa guida analizziamo le cause del problema. Vedremo come configurare e velocizzare i webhook. Esamineremo database, code di lavoro e configurazioni server per garantire transazioni istantanee.

1. Il Ruolo dei Webhook di Stripe nel Checkout

Stripe utilizza una comunicazione asincrona per aggiornare lo stato degli acquisti. Questa architettura garantisce pagamenti sicuri ma richiede server reattivi.

Come funziona la notifica asincrona

Durante il checkout, il browser invia i dati della carta a Stripe. Stripe autorizza la transazione e invia una notifica HTTP al tuo sito. Questa notifica si chiama webhook.

WooCommerce riceve il webhook sull’endpoint dedicato. Quindi elabora l’evento payment_intent.succeeded e imposta l’ordine su ‘In lavorazione’.

Perché l’ordine non si aggiorna

Se il webhook fallisce o scade, lo stato non cambia. Il sistema lascia gli ordini bloccati in attesa di pagamento a tempo indefinito.

I motivi principali sono blocchi del database, code sature o timeout HTTP. Esaminiamo ora gli strumenti di diagnostica.

2. Diagnostica: Individuare Errori nei Log

Prima di modificare le impostazioni, è fondamentale analizzare i dati reali. Dobbiamo capire dove si interrompe la catena di comunicazione.

Verificare gli eventi nella Dashboard di Stripe

1. Accedi alla dashboard di Stripe.
2. Vai nella sezione Sviluppatori e clicca su Webhook.
3. Seleziona l’endpoint del tuo store WooCommerce.
4. Controlla la scheda Tentativi di recapito.

Se noti codici di errore 408, 500 o 504, il tuo server rifiuta o rallenta le richieste. Stripe ripeterà i tentativi, ma con intervalli crescenti.

Consultare i registri di WooCommerce

Entra nel pannello di WordPress. Vai su WooCommerce > Stato > Log.

Cerca il file di log associato a Stripe più recente. Troverai i dettagli esatti su ogni payload ricevuto e su eventuali eccezioni PHP.

Trucco pratico: Se trovi errori di firma non valida (400 Bad Request), reimposta il ‘Segreto di firma del webhook’ in WooCommerce copiandolo nuovamente da Stripe.

3. Ottimizzazione del Database con HPOS

Nei negozi con alto traffico, il database legacy di WordPress rappresenta un collo di bottiglia. La tabella wp_postmeta crea conflitti durante scritture simultanee.

I deadlock sui postmeta

Quando il webhook arriva, WooCommerce tenta di aggiornare i metadati dell’ordine. Nello stesso momento, il browser del cliente potrebbe fare polling sullo stesso record.

Due processi provano a bloccare la stessa riga nel database. Si verifica un deadlock MySQL. La transazione fallisce e il webhook va in timeout.

Passare a High-Performance Order Storage

WooCommerce include un’architettura moderna a tabelle dedicate. Questo sistema elimina la frammentazione e i blocchi concorrenti.

Per una migrazione sicura ed efficiente, consulta il nostro tutorial dettagliato: Migrazione ad High-Performance Order Storage (HPOS) per Evitare i Deadlock del Database sui Webhook di Stripe.

Con HPOS, le tabelle ordini scalano senza sovraccaricare il database.

4. Gestione della Coda con Action Scheduler

WooCommerce elabora molte operazioni in background tramite Action Scheduler. Se la coda si intasa, le notifiche di pagamento non vengono processate tempestivamente.

Accumulo di task e ritardi

Molti plugin aggiungono azioni pianificate continuamente. Se la coda contiene decine di migliaia di righe obsolete, le query rallentano drasticamente.

Il webhook Stripe finisce in attesa dietro ad altre attività secondarie. Di conseguenza, il cliente vede gli ordini bloccati in attesa di pagamento anche dopo aver concluso l’acquisto.

Pulizia periodica e WP-CLI

È essenziale eliminare i task falliti o completati per mantenere pulita la tabella wp_actionscheduler_actions. Puoi automatizzare questa pulizia con cron di sistema e comandi WP-CLI.

Trovi i comandi e la procedura passo-passo nella guida: Ottimizzazione e Pulizia di Action Scheduler: Velocizzare l’Elaborazione in Coda degli Eventi Stripe.

5. Tuning di PHP-FPM e Bypass della Cache

L’infrastruttura di hosting gioca un ruolo decisivo nella gestione dei webhook. Tempi di risposta superiori a 20 secondi causano la disconnessione forzata di Stripe.

Saturazione dei PHP-FPM Worker

Durante picchi di vendite improvvisi, i worker PHP possono esaurirsi. I webhook rimangono in coda sul server web fino allo scattare del timeout HTTP 504.

Devi calcolare la memoria del server e regolare i parametri pm.max_children e pm.max_requests per assorbire i picchi di richieste simultanee.

Escludere gli endpoint dalla Edge Cache

Sistemi di caching aggressivi come Cloudflare o Varnish possono salvare le risposte dell’endpoint dei webhook. Questo impedisce a WooCommerce di ricevere l’evento originale.

L’URL /?wc-api=wc_stripe deve sempre aggirare qualsiasi livello di memorizzazione nella cache del server e dei CDN.

Per la configurazione esatta di Nginx, PHP e CDN, leggi l’approfondimento: Tuning dei PHP-FPM Worker e Bypass Cache Edge per Prevenire i Timeout HTTP 504 sui Webhook di Stripe.

FAQ: Domande Frequenti sui Webhook Stripe e WooCommerce

Perché Stripe ritenta l’invio del webhook più volte?

Se il tuo server non risponde con uno stato HTTP 200 entro pochi secondi, Stripe considera fallita la consegna. La piattaforma ripete l’invio automaticamente a intervalli prestabiliti per diverse ore.

Posso forzare manualmente l’aggiornamento degli ordini?

Sì, puoi visualizzare l’evento non consegnato nella dashboard di Stripe. Clicca su ‘Invia di nuovo’ per ritrasmettere il payload direttamente all’endpoint di WooCommerce dopo aver risolto l’errore sul server.

Disattivare gli altri plugin aiuta a velocizzare il webhook?

Sì, ogni richiesta al webhook carica l’intero ambiente WordPress. Plugin pesanti o non ottimizzati rallentano l’avvio di PHP. Riduci i plugin attivi per velocizzare i tempi di elaborazione ed eliminare definitivamente i casi di ordini bloccati in attesa di pagamento.