WooCommerce Subscriptions con Stripe: configurazione passo per passo

Ciao e benvenuto. Se hai bisogno di chiarimenti sul codice, lascia un commento (no WhatsApp); ricorda però che non fornisco assistenza gratuita sugli articoli che ho scritto nè personalizzo il codice in modo gratuito, quindi se la tua richiesta va oltre il semplice "aiutino", se vuoi mi chiedi una consulenza a pagamento nella pagina contatti. Grazie della comprensione. Alessio
In breve

Con WooCommerce Subscriptions e l’estensione Stripe ufficiale, è WooCommerce a pianificare e avviare i rinnovi, mentre Stripe incassa con il metodo di pagamento salvato e avvisa il sito tramite webhook. Collega Stripe da WooCommerce, Impostazioni, Pagamenti: dalla versione 8.6.1 i webhook si configurano da soli, basta controllare che lo stato sia Configured. Prova tutto in modalità test, anche con le carte che richiedono l’autenticazione forte, attiva i tentativi automatici per i pagamenti falliti e verifica che le copie di prova restino in modalità staging.

Vendere abbonamenti su WooCommerce porta incassi ricorrenti e prevedibili, ma il setup ha alcuni punti dove un errore non si vede subito: lo scopri a fine mese, quando mancano i rinnovi. Qui descrivo il flusso pulito con WooCommerce Subscriptions e l’estensione Stripe ufficiale, e correggo un equivoco che trovo spesso, anche in guide molto lette.

Chi fa cosa tra Subscriptions e Stripe?

WooCommerce Subscriptions gestisce il ciclo di vita dell’abbonamento: lo crea, pianifica i rinnovi con Action Scheduler, genera l’ordine di rinnovo, cambia gli stati e manda le email. Al momento del rinnovo chiede a Stripe di addebitare il metodo di pagamento salvato con il primo acquisto. Stripe esegue il pagamento e avvisa il sito dell’esito con i webhook. Non si usano gli abbonamenti di Stripe Billing, quindi eventi come invoice.payment_failed non c’entrano: contano quelli dei pagamenti, come payment_intent.succeeded e payment_intent.payment_failed.

Quali plugin servono e come li collego?

WooCommerce Subscriptions, che è un’estensione a pagamento, e l’estensione WooCommerce Stripe Payment Gateway. In WooCommerce, Impostazioni, Pagamenti, Stripe colleghi l’account con il pulsante di connessione. Gli abbonamenti richiedono che il cliente abbia un account, perché un ospite non può salvare il metodo di pagamento: verifica che la creazione dell’account al checkout sia permessa.

I webhook vanno configurati a mano?

come configurare WooCommerce Subscriptions con Stripe

Non più. Dalla versione 8.6.1 dell’estensione Stripe i webhook si configurano da soli quando colleghi l’account. Nelle impostazioni di Stripe, sezione dei dettagli dell’account, controlla che lo stato dei webhook sia Configured sia in modalità live sia in modalità test, e che l’ultimo evento ricevuto sia recente. Se lo stato è diverso, ricollega l’account. Un webhook che non arriva è la causa più subdola di abbonamenti fuori sincronia.

Come provo gli abbonamenti prima di andare online?

In modalità test, con le carte di prova di Stripe: 4242 4242 4242 4242 con una scadenza futura qualsiasi per il caso normale, e le carte che richiedono l’autenticazione 3D Secure per simulare la SCA dei clienti europei. Creo un abbonamento, poi forzo un rinnovo dalla scheda dell’abbonamento in bacheca, con l’azione per elaborare il rinnovo, e controllo che l’ordine si crei, che Stripe registri il pagamento e che lo stato torni attivo.

Come funziona la SCA con i rinnovi?

Al primo acquisto il cliente si autentica e il metodo di pagamento viene salvato per gli addebiti successivi. I rinnovi avvengono senza il cliente presente e di norma passano senza nuova autenticazione. Se la banca la richiede comunque, il rinnovo fallisce e il cliente deve completare il pagamento dal link dell’ordine. Per questo le email di pagamento non riuscito devono restare attive.

Come imposto i tentativi sui pagamenti falliti?

Subscriptions ha un sistema di tentativi automatici, da attivare nelle impostazioni degli abbonamenti. Le regole predefinite sono cinque, distribuite su sette giorni: dopo 12 ore, altre 12, poi 24, 48 e 72. Per la maggior parte dei negozi vanno bene; per cambiarle serve codice con il filtro wcs_default_retry_rules. Cosa fare quando i rinnovi falliscono lo spiego in i rinnovi falliti in Subscriptions.

Cosa succede con le copie di prova del sito?

Subscriptions memorizza l’indirizzo del sito dove è stato attivato e, se lo trova cambiato, passa in modalità staging: gli abbonamenti diventano a rinnovo manuale, così una copia non addebita due volte i clienti. È una protezione preziosa, ma ha un rovescio: dopo una migrazione o un cambio di dominio anche il sito vero può finire in staging. In WooCommerce, Stato, controlla sempre la modalità di Subscriptions.

In sintesi

Con Subscriptions e Stripe, WooCommerce pianifica e avvia i rinnovi e Stripe incassa con il metodo salvato, avvisando il sito con i webhook dei pagamenti, non con gli eventi invoice. Dalla 8.6.1 i webhook si configurano collegando l’account: controlla che lo stato sia Configured. Prova in modalità test anche con carte 3D Secure, forza un rinnovo, attiva i tentativi automatici (cinque in sette giorni) e controlla in WooCommerce, Stato, che solo il sito vero sia in modalità live.

Domande frequenti

Servono gli eventi invoice di Stripe per WooCommerce Subscriptions?

No: i rinnovi li avvia WooCommerce e Stripe li incassa come pagamenti singoli, quindi contano gli eventi dei payment intent.

Devo creare a mano il webhook di Stripe?

Con l’estensione Stripe dalla versione 8.6.1 no: si crea collegando l’account; basta controllare che risulti configurato.

Un cliente ospite può sottoscrivere un abbonamento?

No, serve un account, perché il metodo di pagamento va salvato per i rinnovi.

Come provo un rinnovo senza aspettare la scadenza?

Dalla scheda dell’abbonamento in bacheca, con l’azione che elabora il rinnovo, in modalità test.

Immagine di Alessio Angeloro

Alessio Angeloro

Alessio Angeloro è uno sviluppatore WordPress e programmatore WooCommerce specializzato in integrazioni avanzate: gateway di pagamento rateali (Findomestic, Compass, Agos, Cofidis), collegamenti via API con gestionali e CRM, sviluppo di plugin personalizzati e ottimizzazione delle performance degli ecommerce. Con un background sistemistico e anni di esperienza su progetti reali, aiuta aziende, professionisti e agenzie a trasformare WooCommerce in uno strumento di vendita stabile, veloce e scalabile, evitando soluzioni generiche e poco performanti. Lavora con codice pulito e configurazioni su misura, pensate per far crescere il tuo negozio online nel tempo.
Condividi l'articolo
Facebook
Twitter
LinkedIn
WhatsApp

Lascia un commento

Questo sito utilizza Akismet per ridurre lo spam. Scopri come vengono elaborati i dati derivati dai commenti.