Stripe + WooCommerce: setup plugin

Stripe + WooCommerce: setup plugin

Il plugin ufficiale Stripe per WooCommerce è la soluzione consigliata per chi gestisce un'e-commerce su WordPress. Supporta tutti i metodi di pagamento Stripe (carte, Apple Pay, Google Pay, Klarna, SEPA, iDEAL) e integra automaticamente PSD2 e 3D Secure.

Installazione del plugin

Il plugin si chiama 'Stripe for WooCommerce' ed è sviluppato direttamente da Stripe e Automattic. Si installa da Plugin -> Aggiungi nuovo cercando 'Stripe'. La versione corrente (8.x+) supporta Payment Element, il nuovo componente unificato che mostra automaticamente i metodi di pagamento più rilevanti per il cliente in base a paese e valuta.

Configurazione API key e webhook

Dopo l'attivazione vai in WooCommerce -> Impostazioni -> Pagamenti -> Stripe. Inserisci le chiavi API Live e Test, abilita i metodi di pagamento desiderati e configura il webhook (l'endpoint predefinito è /?wc-api=wc_stripe). Il plugin crea automaticamente l'endpoint, devi solo registrarlo nella Dashboard Stripe e copiare il signing secret.

Configurazioni avanzate WooCommerce

Il plugin WC Stripe espone setting avanzati: 'Inline credit card form' (single line vs split fields), 'Statement descriptor' (testo visibile in estratto conto cliente, max 22 char), 'Capture method' (immediato vs manuale a 7 giorni, utile per pre-order/dropshipping), 'Limited capability mode' (riduce metodi pagamento mostrati), 'Saved payment methods' (cliente può salvare carta nel proprio account). Configura 'Statement descriptor prefix' specifico per ogni store per ridurre chargeback per non riconoscimento charge.

Performance e plugin conflict

WooCommerce + Stripe possono rallentare il checkout se: 1) Troppi plugin di pagamento attivi (disabilita gateway non usati); 2) Theme con AJAX checkout custom male implementato (usa template hook standard); 3) Cache plugin (WP Rocket, W3 Total Cache) che cachea pagine /checkout/ (esclude sempre /checkout, /cart, /my-account); 4) Conflitto con plugin ottimizzazione asset (JS deferred che rompe stripe.js). Diagnostica con plugin 'Health Check & Troubleshooting' in modalita' troubleshooting per isolare conflitti.

Subscription WC con Stripe

WooCommerce Subscriptions plugin (pagamento, 199 USD/anno) si integra natively con Stripe per ricorrenti: rinnovi automatici, retry su carta failed, upgrade/downgrade con proration, free trial, dunning automatico. Per WCS + Stripe: 1) Cliente sottoscrive piano, Stripe salva PaymentMethod + crea Subscription; 2) Ogni ciclo Stripe rinnova, WCS riceve invoice.paid webhook, marca order completed; 3) Failed payment triggera retry sequence WCS che combina con Stripe Smart Retries. Per ricorrenti senza WCS, valuta switch a Stripe Billing API direttamente (più' flessibile, no licenza).

Apple Pay e Express Checkout WC

WC Stripe supporta Apple Pay/Google Pay express button su: 1) Single product page (Buy Now Apple Pay); 2) Cart page (express checkout button sopra form); 3) Checkout page (Apple/Google Pay come primo metodo). Per Apple Pay verifica dominio aggiungendo file in /.well-known/apple-developer-merchantid-domain-association (WC plugin lo gestisce automaticamente in alcune versioni). Express checkout aumenta mobile conversion 18-25%. Setup: WooCommerce -> Stripe Settings -> abilita Payment Request Buttons -> configura aspetto (color, height, label).

Localizzazione e multi-currency WC

Per WooCommerce multi-currency (vendita globale), plugin come WPML/Polylang gestiscono multi-lingua del sito, mentre per multi-currency dei prezzi prodotto serve plugin specifico (WooCommerce Currency Switcher, Aelia Currency Switcher). Stripe gestisce naturalmente multi-currency: PaymentIntent con currency dinamica in base a scelta utente. Best practice: 1) Detect currency da geolocation IP + override manuale; 2) Round prices per psicologia (9,99 EUR vs 11,49 USD vs 8,99 GBP); 3) FX rate update daily da ECB o cambio fisso; 4) Display tax/shipping in currency selezionata; 5) Payout sempre in EUR (tua base currency) con conversion fee Stripe ~1,5%. Test approfondito mobile checkout per ogni currency.

WC + Stripe e SEO ecommerce

Per ottimizzare SEO ecommerce WooCommerce + Stripe: 1) Page speed - Stripe.js carica solo su checkout (no global); 2) Schema markup Product + Offer + Review per rich snippet Google; 3) Mobile-first index - test checkout su mobile in Lighthouse; 4) Trust signal - badge SSL, Stripe logo (con Powered by Stripe stipulation), security/refund policy; 5) Cart abandonment recovery email (CartFlows + email marketing); 6) Internal linking blog -> prodotti per SEO ranking; 7) Performance: target Core Web Vitals all green (LCP <2.5s, INP <200ms, CLS <0.1). SEO + Stripe combo amplifies traffic organico + conversion checkout = revenue growth sostenibile.

Procedura passo-passo

  1. Installa il plugin 'Stripe for WooCommerce' (ufficiale, by Stripe).
  2. Attiva il plugin e vai in WooCommerce -> Impostazioni -> Pagamenti.
  3. Abilita Stripe e clicca 'Configura'.
  4. Inserisci Publishable Key (pk_live_) e Secret Key (sk_live_).
  5. Configura webhook in Stripe Dashboard puntando a https://tuosito.it/?wc-api=wc_stripe.
  6. Copia il Webhook Secret nel plugin per la verifica firma.
  7. Abilita i metodi di pagamento (carte, Apple Pay, Google Pay, Klarna se rilevante).
  8. Testa l'intero flusso in Test mode prima di passare in Live.

Errori comuni e come risolverli

  • Webhook non configurato: ordini restano in 'Pending payment'; configurarlo è obbligatorio.
  • Apple Pay domain non verificato: richiede file di verifica su .well-known/apple-developer-merchantid-domain-association.
  • Plugin Stripe vecchio (versione 7.x): non supporta Payment Element; aggiorna sempre alla 8.x+.
  • Conflitto con plugin di pagamento concorrenti: disabilita altri gateway non utilizzati per evitare conflitti.

Domande frequenti

D: Il plugin è gratuito?
R: Sì, completamente gratuito; paghi solo le commissioni Stripe per transazione.

D: Supporta WooCommerce Subscriptions?
R: Sì, integrazione nativa con il plugin Subscriptions di WooCommerce.

D: Posso usare Stripe e PayPal insieme?
R: Sì, sono gateway separati attivabili contemporaneamente.

D: Come gestisco i rimborsi?
R: Direttamente dall'ordine WooCommerce con il pulsante 'Refund'.

Hai bisogno di aiuto?

Se vuoi integrare Stripe con il team di G Tech Group, scrivici tramite il modulo di contatto.

Hai trovato utile quest'articolo?