Aggiungere il pulsante PayPal non basta per sapere se il negozio è pronto a vendere. Il cliente deve riuscire a pagare, WooCommerce deve registrare correttamente l’ordine e chi prepara la spedizione deve poter verificare l’incasso. Vediamo come collegare PayPal Payments, provare il percorso di acquisto e riconoscere i problemi più comuni di conferma.
Indice della guida
Prepara account e negozio prima del collegamento
Per un ecommerce professionale parti da un account PayPal Business dell’attività, con verifiche e richieste del servizio completate. La documentazione sull’account ammette venditori con account personale soltanto in alcune regioni; non dare per scontato che siano disponibili le medesime funzioni. Controlla anche valuta, paese del venditore e condizioni applicabili ai pagamenti che intendi ricevere.
Confronta le versioni installate con i requisiti del plugin e prepara un backup. Verifica HTTPS, tema e personalizzazioni della cassa: la compatibilità documentata da WooCommerce va confermata sul tuo negozio. Una copia di prova WordPress permette di collaudare il percorso senza coinvolgere i clienti. La copia deve usare collegamenti di test e non inviare ordini reali al magazzino.
Installa PayPal Payments e collega l’account
La guida iniziale ufficiale prende come riferimento il plugin WooCommerce PayPal Payments. Nella gestione WordPress apri Plugin → Aggiungi nuovo, cerca il nome completo, verifica la provenienza, quindi installa e attiva l’estensione. Prima di proseguire, controlla se esiste già un’integrazione PayPal: in quel caso leggi anche la sezione sulla migrazione.
- Apri WooCommerce → Impostazioni → Pagamenti e avvia la configurazione PayPal.
- Per le prime prove scegli la modalità Sandbox nelle opzioni avanzate; per il negozio operativo servirà il collegamento all’account reale.
- Segui la procedura guidata indicando tipo di account e prodotti venduti, poi autorizza il collegamento nell’interfaccia PayPal.
- Al ritorno nel sito controlla account collegato, ambiente e richieste ancora da completare.
Le etichette possono cambiare con la versione del plugin. Conserva le credenziali nei sistemi previsti, senza copiarle nelle note dell’ordine o in screenshot da condividere. Se gestisci più negozi, verifica l’intestazione dell’account prima di procedere: un collegamento riuscito non dimostra da solo che hai selezionato l’attività corretta.
Scegli i pulsanti e controlla il checkout
Nelle impostazioni di PayPal Payments scegli metodi abilitati e posizioni dei pulsanti. La disponibilità delle opzioni dipende anche dal mercato e dall’idoneità dell’account. Attivare una voce non garantisce che ogni visitatore visualizzi la stessa scelta; carte, pagamenti dilazionati e altri wallet possono avere requisiti propri.
Controlla separatamente checkout classico e checkout a blocchi. La guida dedicata ai blocchi distingue i pulsanti express dalle opzioni nell’elenco dei metodi di pagamento e documenta limitazioni per alcune funzioni. Un pulsante in posizione diversa non significa automaticamente che l’integrazione sia guasta.
Prova il percorso effettivo del cliente: selezione della variante, quantità, indirizzo, consegna e campi richiesti. Per esempio, se vendi un prodotto personalizzato, il pagamento rapido non deve lasciare il personale senza le indicazioni necessarie a prepararlo. Verifica anche i percorsi avviati dalla pagina prodotto, se li hai abilitati.
Distingui autorizzazione e incasso
PayPal Payments consente di acquisire subito il pagamento oppure di ottenere inizialmente una sola autorizzazione. Nel secondo caso il negozio deve effettuare l’acquisizione successiva. La gestione ufficiale di ordini e rimborsi descrive l’azione di acquisizione nel dettaglio dell’ordine. Prevede anche che il passaggio da In sospeso a In lavorazione possa acquisire un pagamento autorizzato: cambiare lo stato non è sempre una semplice annotazione.
Definisci chi si occupa di questo passaggio e quale controllo precede la spedizione. Se devi prima confermare la disponibilità di un articolo, annota l’esito della verifica accanto al numero d’ordine. Controlla le condizioni dell’autorizzazione nell’account PayPal: non lasciarla aperta presumendo che sia valida senza limiti.
Prova un acquisto completo in Sandbox
Sandbox è l’ambiente PayPal per simulare le transazioni. Prepara un account venditore Sandbox collegato al plugin e un diverso account Sandbox acquirente. Usa le credenziali di prova indicate nel portale sviluppatori e verifica l’ambiente selezionato prima di iniziare.
Prova da computer e da smartphone e compila una breve scheda di collaudo:
- Carrello: prodotto e variante corretti, coupon applicato, spedizione e totale coerenti.
- Pagamento: apertura del percorso PayPal e conclusione senza messaggi ambigui.
- Ordine: riferimento della transazione, importo e stato corrispondenti all’esito atteso.
- Conferme: pagina finale, email e dati disponibili a chi prepara la merce.
- Interruzione: annullamento del percorso e possibilità per il cliente di capire come proseguire.
Esempio: un articolo da 30 euro con 5 euro di spedizione deve lasciare un ordine e un pagamento da 35 euro. Se applichi un coupon, ripeti la prova con il nuovo totale. Se manca soltanto la posta, consulta la guida alle email degli ordini WooCommerce non ricevute: il problema può essere separato dall’incasso.
Pagamento riuscito e ordine in attesa: cosa verificare
Parti dalla transazione nel conto PayPal e confronta riferimento, importo e stato con le note dell’ordine. Distingui pagamento acquisito, autorizzato, in elaborazione o non riuscito. Non chiedere un secondo pagamento basandoti soltanto sulla pagina rimasta aperta nel browser del cliente.
Il plugin usa anche i webhook, notifiche con cui PayPal comunica eventi al negozio. Le impostazioni includono strumenti per verificarli. Fai controllare connessione, recapito delle notifiche e registri del plugin, soprattutto dopo cambi di dominio, hosting o protezioni del sito.
La documentazione sugli errori PayPal Payments segnala che un messaggio generico può derivare da cause differenti: configurazione, conflitti o comunicazioni bloccate. Se compare DUPLICATE_INVOICE_ID, controlla il prefisso degli ordini e l’eventuale uso dello stesso account su più siti; un ripristino da backup può aver reintrodotto numeri già utilizzati. Ogni sito deve avere un prefisso distinto. Non aggirare il controllo sui duplicati per risolvere un singolo ordine.
Per l’assistenza prepara numero d’ordine, codice d’errore, importo e passaggio in cui il percorso si interrompe. Se falliscono anche gli altri metodi, consulta i controlli sui pagamenti WooCommerce non riusciti.
Se utilizzi già un altro plugin PayPal
Annota il nome dell’integrazione attuale e controlla ordini aperti, pagamenti autorizzati e abbonamenti prima di sostituirla. WooCommerce indica PayPal Payments come percorso verso l’integrazione moderna nel comunicato sul ritiro di PayPal Standard. La gestione del passaggio tiene conto anche della presenza di vecchi abbonamenti.
Non confondere il collegamento del nuovo plugin con il trasferimento di tutti i rapporti di pagamento esistenti. Segui la guida ufficiale alla migrazione per il gateway di partenza e verifica come continueranno rinnovi, notifiche e rimborsi dei vecchi ordini. Controlla che alla cassa non compaiano due opzioni PayPal equivalenti; rimuovi la vecchia integrazione soltanto dopo aver verificato le funzioni ancora necessarie.
Controlli finali prima di accettare pagamenti reali
Conclusi i test, configura l’account reale e verifica che Sandbox non sia più attiva nel negozio aperto ai clienti. Ricontrolla pulsanti, collegamento e modalità di incasso: un esito positivo nell’ambiente di prova non certifica da solo le impostazioni del sito operativo.
Organizza una prova reale concordata, consapevole che genera una transazione soggetta alle condizioni del servizio. Se è previsto un rimborso, usa il comando di rimborso tramite PayPal e controlla il risultato. Un rimborso manuale registrato nel sito non equivale all’invio del denaro; per la gestione della merce e delle restituzioni trovi anche la guida a resi e rimborsi WooCommerce.
Prima di considerare terminato il lavoro, fai individuare un ordine riuscito alla persona che gestirà le spedizioni. Deve poter riconoscere importo incassato, eventuali anomalie e percorso di assistenza senza dover ricostruire ogni volta la configurazione.
Domande frequenti
Serve un account PayPal Business per WooCommerce?
Per un negozio consigliamo un account Business intestato all’attività. Il collegamento di account personali è previsto solo in alcune regioni e non offre necessariamente le stesse funzioni: verifica i requisiti del tuo paese e dei metodi che vuoi attivare.
Posso provare PayPal senza pagare davvero?
Sì, la modalità Sandbox usa account e transazioni di prova. Collega il venditore Sandbox e utilizza un diverso account Sandbox come acquirente; controlla che la modalità di test sia effettivamente attiva prima dell’acquisto.
PayPal funziona con il checkout a blocchi?
PayPal Payments offre un’integrazione con carrello e checkout a blocchi, ma funzioni e posizione dei pulsanti possono differire dal checkout classico. Verifica il supporto della funzione che ti serve e collauda il percorso con il tema e le estensioni installati.
Un pagamento autorizzato è già incassato?
No. Con la sola autorizzazione l’incasso richiede una successiva acquisizione del pagamento. Controlla l’esito dell’acquisizione prima di considerare conclusa la parte economica dell’ordine.
Il cliente ha pagato, ma WooCommerce non conferma: deve riprovare?
Prima confronta transazione PayPal, importo e ordine, poi verifica note e comunicazioni del plugin. Non chiedere un secondo pagamento finché non hai chiarito l’esito del primo: l’assenza di conferma nel sito non basta a stabilire che il pagamento sia fallito.
Fonti ufficiali e approfondimenti
- WooCommerce: installazione e primi passi con PayPal Payments
- WooCommerce: account, collegamento e Sandbox
- PayPal Developer: ambiente Sandbox e account di prova
- WooCommerce: pulsanti, impostazioni e webhook
- WooCommerce: supporto del checkout a blocchi
- WooCommerce: acquisizione dei pagamenti e rimborsi
- WooCommerce: errori e controlli di configurazione
- WooCommerce: passaggio dalle integrazioni precedenti