PayPal su Prestashop: setup integrazione
Prestashop offre un'integrazione PayPal solida tramite il modulo ufficiale PayPal Checkout (PrestaShop Checkout), mantenuto direttamente da PrestaShop in collaborazione con PayPal. Il modulo è gratuito, compatibile con Prestashop 1.7.6+ e 8.x, e supporta i metodi di pagamento moderni: Smart Buttons, Pay in 3, carte di credito locali, Apple Pay. In questa guida vediamo l'installazione e la configurazione completa.
Differenze tra PrestaShop Checkout e moduli legacy
Il vecchio modulo "PayPal Module" è deprecato dal 2022. Il nuovo PrestaShop Checkout sostituisce sia PayPal sia eventuali moduli Stripe e gestisce tutti i pagamenti in un'unico flusso. Per i nuovi store non c'è motivo di usare altro. Per chi viene da moduli legacy, il consiglio è una migrazione pulita dopo backup completo, dato che le tabelle delle transazioni cambiano struttura.
Prerequisiti
Servono Prestashop 1.7.6 o successivo, PHP 7.4+ (8.1 consigliato), HTTPS valido su tutto il sito, account PayPal Business verificato, account "PrestaShop Account" gratuito (necessario per l'onboarding del modulo). Il PrestaShop Account è un wrapper che semplifica l'autenticazione OAuth verso PayPal e altri fornitori; non costa nulla.
Procedura passo-passo
- Accedi al Back Office Prestashop, vai su Moduli, Catalogo moduli.
- Cerca "PrestaShop Checkout" e installalo.
- Apri il modulo dopo l'installazione e clicca su "Connetti il tuo account".
- Crea o accedi a PrestaShop Account.
- Clicca su "Connetti PayPal", inserisci credenziali Business e autorizza.
- Nelle impostazioni del modulo abilita: Smart Buttons, Carte di credito, Pay Later.
- Imposta la modalità di cattura: Capture (immediata) o Authorize (cattura manuale entro 29 giorni).
- Configura la posizione dei bottoni nel checkout e in carrello.
- Salva e fai un'ordine di test.
- Verifica che la transazione appaia in PayPal e che l'ordine sia "Pagato" in Prestashop.
Cattura immediata vs autorizzazione
La modalità Capture addebita subito il cliente: i fondi sono prenotati e accreditati istantaneamente. È la scelta standard per la vendita di prodotti in stock. La modalità Authorize prenota i fondi senza addebitare: hai 29 giorni per catturarli o annullarli. È utile per beni su ordinazione, riparazioni o servizi che richiedono conferma manuale. Attenzione: in modalità Authorize devi catturare manualmente dall'admin Prestashop, altrimenti l'autorizzazione decade e il fondo viene rilasciato.
Hook e personalizzazioni
Il modulo si aggancia agli hook standard di Prestashop: displayPaymentTop, displayPaymentByBinaries, actionFrontControllerSetMedia. Se hai un tema custom verifica che chiami hookPayment nel template del checkout. Per personalizzare il bottone usa il file CSS overrides senza toccare il modulo core (le modifiche andrebbero perse al prossimo aggiornamento).
Webhook e gestione resi
Il modulo crea automaticamente un'endpoint webhook in /module/ps_checkout/webhook. Riceve notifiche per pagamenti, rimborsi e contestazioni. Per rimborsare apri l'ordine in BackOffice, clicca "Rimborso parziale" o "Rimborso totale" e seleziona "PrestaShop Checkout" come metodo. Il modulo chiama PayPal Refund API e aggiorna lo status. Verifica che il webhook sia raggiungibile da PayPal (no firewall che blocca POST esterne).
Errori comuni e come risolverli
- "Module not registered": l'account PrestaShop non è collegato. Reinstalla seguendo l'onboarding.
- Bottone PayPal scompare al refresh: cache Prestashop sporca. Vai su Parametri avanzati, Performance e svuota la cache.
- Doppio addebito apparente: spesso è un'autorizzazione + cattura visualizzate come due record. Verifica l'estratto PayPal.
- Webhook fallisce con 403: il firewall o le regole .htaccess bloccano l'endpoint. Esplicita una eccezione.
Domande frequenti
D: Posso usare il vecchio modulo PayPal e PrestaShop Checkout insieme?
R: No, vanno disinstallati uno o l'altro. Mantenere entrambi attivi causa duplicazioni.
D: PrestaShop Checkout supporta gli abbonamenti?
R: Indirettamente, tramite il modulo "PrestaShop Subscriptions" che richiama PayPal Vault.
D: Il modulo è davvero gratuito?
R: Sì. Si guadagna solo sulle commissioni PayPal standard, non c'è costo del modulo.
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.