Configurare i pagamenti è il passaggio più delicato di un nuovo shop WooCommerce. Un errore nelle chiavi API o un webhook non attivo possono far perdere ordini reali senza che tu te ne accorga subito: il cliente paga, ma in WooCommerce l'ordine resta in "in attesa di pagamento" e nessuno spedisce nulla.
In questa guida vediamo come attivare i due gateway più richiesti dai clienti italiani — Stripe e PayPal — partendo dai concetti, passando per la modalità test e arrivando al go-live in sicurezza.
Quale gateway scegliere
Per uno shop italiano B2C standard la combinazione vincente è quasi sempre Stripe + PayPal. Stripe gestisce le carte e i wallet (Apple Pay, Google Pay) con un'esperienza moderna; PayPal copre i clienti più tradizionali e quelli che preferiscono non inserire la carta.
Casi particolari:
- Shop B2B con bonifici: aggiungi anche il metodo "Bonifico bancario diretto" già presente in WooCommerce
- Vendita di abbonamenti ricorrenti: Stripe è più solido per ricorrenze
- Mercati extra-UE: valuta gateway aggiuntivi (Klarna per pagamenti rateizzati, Mollie per metodi locali)
Solo in casi rari ha senso un gateway unico: di solito i costi extra di gestione sono compensati dal recupero dei carrelli abbandonati.
Configurare Stripe in WooCommerce
1. Crea l'account Stripe
Vai su stripe.com e registra un account business. Servono: dati azienda, IBAN per i payout, documento del legale rappresentante. La verifica richiede normalmente da poche ore a pochi giorni.
2. Installa il plugin ufficiale
Da Plugin → Aggiungi nuovo cerca "Stripe Payment Gateway for WooCommerce" (versione ufficiale di Stripe o WooCommerce.com). Installa e attiva.
3. Inserisci le chiavi API in modalità test
Nel pannello Stripe vai su Sviluppatori → Chiavi API. Trovi quattro chiavi: due test (pk_test_..., sk_test_...) e due live (pk_live_..., sk_live_...).
In WooCommerce vai su WooCommerce → Impostazioni → Pagamenti → Stripe:
- Spunta "Abilita modalità test"
- Inserisci
Test Publishable KeyeTest Secret Key - Salva
4. Configura i webhook
Sempre nel pannello Stripe, Sviluppatori → Webhook → Aggiungi endpoint. Inserisci l'URL che il plugin ti mostra (tipicamente https://miosito.it/?wc-api=wc_stripe). Seleziona gli eventi consigliati dal plugin (pagamento riuscito, rimborso, dispute).
Copia il Signing secret che Stripe ti dà e incollalo nelle impostazioni del plugin.
5. Test con carte fittizie
Stripe fornisce carte test che simulano vari scenari: 4242 4242 4242 4242 per pagamento riuscito, 4000 0027 6000 3184 per 3DS richiesto, 4000 0000 0000 9995 per fondi insufficienti. Fai almeno 3-4 ordini simulati e verifica che lo stato in WooCommerce si aggiorni correttamente.
6. Vai live
Quando tutti i test passano, togli la spunta "modalità test", inserisci le chiavi live, ricontrolla il webhook live e fai un primo ordine reale di importo basso (1-2 €) per conferma finale.
Configurare PayPal in WooCommerce
1. Account business PayPal
Servono dati azienda e verifica. PayPal distingue conti personali da business: per accettare pagamenti su WooCommerce serve quello business.
2. Installa "PayPal Payments"
È il plugin ufficiale di PayPal per WooCommerce, disponibile gratuitamente nella libreria plugin. Sostituisce il vecchio "PayPal Standard" deprecato da tempo.
3. Connetti l'account
Il plugin ha un wizard guidato: clicchi "Connect to PayPal", fai login nel tuo account business e autorizzi la connessione. Il plugin recupera automaticamente le credenziali.
4. Modalità sandbox
PayPal ha un ambiente sandbox separato (developer.paypal.com). Crea account test (buyer e merchant) e prova ordini completi prima di andare live.
5. Verifica il webhook
Nelle impostazioni del plugin, sezione "Webhook status", deve esserci la spunta verde. Se manca, ri-clicca su "Connect" o configuralo manualmente dal pannello PayPal Developer.
Cosa controllare prima del go-live
Checklist rapida:
- Valuta coincide su shop, Stripe e PayPal
- Chiavi API live inserite (non quelle test) il giorno del go-live
- Webhook live attivi e verificati
- Email transazionali WooCommerce funzionanti (vedi guida dedicata)
- Pagina "Termini e condizioni" e "Informativa privacy" pubblicate e linkate al checkout
- Test reale con un ordine vero da 1-2 € e successivo rimborso, per verificare il flusso completo
Errori comuni
- Chiavi test in produzione. Lo shop sembra funzionare ma nessun pagamento reale arriva sul conto. Sempre rifare l'inserimento il giorno del go-live.
- Webhook non configurato. L'ordine resta "in attesa" anche dopo pagamento riuscito. Controlla nel pannello Stripe/PayPal lo storico chiamate webhook: se ci sono errori 4xx, l'URL è sbagliato.
- 3D Secure disabilitato manualmente. Le banche europee rifiutano una buona parte dei pagamenti. Lascia 3DS gestito automaticamente.
- Mancato HTTPS sul checkout. Stripe rifiuta di inizializzare se il sito non ha SSL valido. Controlla il certificato.
- PayPal Standard ancora attivo. Il vecchio metodo è deprecato e non supporta PSD2 correttamente. Migra a PayPal Payments.
In sintesi
Stripe e PayPal coprono insieme oltre il 90% dei clienti italiani. Configurarli richiede pazienza nei dettagli: chiavi API corrette, webhook attivi, test approfonditi prima di andare live. Una volta impostati, manutenzione minima.
Quando ti consegniamo uno shop, lasciamo entrambi i gateway già configurati in modalità test e ti accompagniamo nel passaggio alle chiavi live. Se modifichi qualcosa dopo, fai sempre un ordine di prova prima di considerare il cambio "fatto": un pagamento perso costa più di dieci minuti di test.
