PayPal su WooCommerce: setup integrazione
Integrare PayPal su WooCommerce con il plugin ufficiale "WooCommerce PayPal Payments" è oggi l'opzione più solida e gratuita per accettare pagamenti PayPal, carte, Pay in 3 e portafogli digitali. La configurazione iniziale è guidata, ma per ottimizzare conversioni e supporto è utile conoscere ogni opzione. Vediamo l'intero flusso, dalle credenziali ai webhook e ai rimborsi.
Prerequisiti
Servono: WordPress 6.0+, WooCommerce 7.4+, PHP 7.4+ (consigliato 8.1+), HTTPS valido, account PayPal Business verificato. Verifica anche di avere il certificato SSL corretto su tutto il sito (mixed content blocca i bottoni) e che la pagina checkout sia accessibile senza redirect. Disattiva temporaneamente i plugin di cache durante il setup per non confondere i test.
Connessione dell'account
Il plugin ufficiale usa il flusso "Onboarding" semplificato: clicchi "Connetti il tuo account PayPal", si apre una pop-up PayPal, accedi con l'account Business, autorizzi l'app e WooCommerce riceve automaticamente client_id e secret. Tutto in 60 secondi. Non devi mai copiare manualmente le credenziali nel pannello, riducendo il rischio di errori. La connessione genera anche un webhook automatico per gli eventi PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED.
Procedura passo-passo
- Installa "WooCommerce PayPal Payments" dal repository.
- Vai su WooCommerce, Impostazioni, Pagamenti e abilita PayPal Payments.
- Clicca su "Configura" e poi su "Connetti il tuo account PayPal".
- Accedi nella pop-up con l'account Business e autorizza.
- Nella scheda Standard Payments attiva i bottoni PayPal nelle pagine: carrello, prodotto, checkout, mini-cart.
- Nella scheda Advanced Card Processing abilita le carte di credito se l'account ha l'autorizzazione (richiesto in alcuni paesi).
- Configura Pay Later per attivare il bottone Pay in 3.
- Imposta lo stile dei bottoni: layout verticale, colore gold, label "paypal".
- Attiva la cattura immediata (Intent: Capture) per ricevere i fondi subito.
- Salva e fai un'ordine di prova.
Webhook e ordini
Il plugin crea automaticamente l'endpoint webhook in /wp-json/paypal-payments/v1/webhook. PayPal invia notifiche per eventi rilevanti: cattura completata, rimborso, contestazione. Il plugin aggiorna lo stato dell'ordine WooCommerce di conseguenza. Verifica che il firewall (Cloudflare, WAF) non blocchi le richieste in arrivo da PayPal. Whitelist gli IP outbound PayPal o disabilita il challenge sull'endpoint webhook.
Rimborsi totali e parziali
Per rimborsare, apri l'ordine WooCommerce, clicca su "Rimborso", indica l'importo e seleziona "Rimborsa tramite PayPal Payments". Il plugin chiama PayPal Refund API e accredita il cliente nello stesso modo del pagamento. I rimborsi parziali sono supportati: puoi rimborsare un singolo prodotto del carrello con un clic, mantenendo l'ordine attivo per il resto. La commissione fissa PayPal NON viene restituita.
Vault per pagamenti ricorrenti
Se vendi abbonamenti con WooCommerce Subscriptions attiva il Vault: i metodi di pagamento del cliente vengono memorizzati in modo sicuro lato PayPal e usati per addebiti automatici. Il cliente paga una volta e poi le rinnovate vengono gestite automaticamente. Servono opportune autorizzazioni dal merchant: contatta PayPal per attivare il programma "Reference Transactions".
Errori comuni e come risolverli
- "This transaction cannot be processed": di solito è una valuta non supportata o un'importo sotto il minimo. Verifica le impostazioni regionali.
- Bottone PayPal non appare: cache plugin o tema rompe lo script. Pulisci cache, ricontrolla.
- Webhook non funziona: il firewall blocca PayPal. Whitelist o disabilita challenge sull'endpoint.
- Refund fallisce: il saldo PayPal è insufficiente. Ricarica prima di rimborsare o configura il prelievo automatico.
Domande frequenti
D: Posso usare PayPal e Stripe insieme?
R: Sì, sono due gateway indipendenti. WooCommerce mostra entrambi al checkout.
D: Il plugin funziona con WooCommerce HPOS?
R: Sì, dalle versioni 2.0+ è compatibile con High Performance Order Storage.
D: Posso disabilitare PayPal solo per alcuni prodotti?
R: Sì, con hook custom woocommerce_available_payment_gateways filtri il gateway per categoria.
Consigli operativi e best practice
Per consolidare quanto visto nei paragrafi precedenti tieni a mente alcuni accorgimenti pratici che fanno la differenza nel quotidiano. Documenta sempre ogni passaggio della configurazione in un registro interno aziendale: serve sia per il team sia in caso di audit fiscale o di richiesta di chiarimenti da parte di PayPal. Conserva una copia delle ricevute, delle email transazionali e degli screenshot dei pannelli di amministrazione per almeno dieci anni, come richiesto dalla normativa civilistica italiana.
Pianifica una revisione trimestrale della tua integrazione PayPal: verifica le commissioni applicate, controlla i tassi di contestazione, leggi gli avvisi nel Centro Risoluzioni e aggiorna eventuali plugin o SDK obsoleti. Le aziende che fanno questo controllo regolare riducono del 40-60% gli incidenti operativi rispetto a chi gestisce PayPal in modo reattivo. Coinvolgi anche il team di customer service: spesso sono loro i primi a notare pattern di richieste che possono indicare problemi nascosti nel flusso di pagamento.
Infine, abituati a monitorare i tempi di risposta nelle dispute e nei reclami: PayPal premia i merchant che rispondono entro 24-48 ore con score reputazionali migliori, che si traducono in minori riserve, commissioni più favorevoli al raggiungimento dei volumi e un'esperienza più fluida in caso di controlli antifrode. La gestione proattiva è sempre meno costosa di quella reattiva, in PayPal come nel resto del business online.
Hai bisogno di aiuto?
Se vuoi integrare PayPal nel tuo sito con il team di G Tech Group, scrivici tramite il modulo di contatto.