Sottoponi il progetto

PayPal su WooCommerce non funziona: cause più comuni e come risolvere

FanaticoWeb ·

Illustrazione di un preventivo e di monete, per l'articolo su PayPal e WooCommerce

Un cliente arriva al checkout, sceglie PayPal e… non succede nulla. Oppure paga, ma l'ordine resta «in attesa». Quando PayPal su WooCommerce non funziona il danno è immediato: ogni ora persa sono vendite che vanno altrove. La buona notizia è che le cause sono quasi sempre le stesse, e si possono controllare con un ordine preciso.

Gestiamo negozi WooCommerce da molti anni e questi sono i controlli che facciamo, nell'ordine in cui li facciamo.

I sintomi più comuni

Prima di cercare la causa, conviene capire esattamente cosa succede. I casi tipici sono:

  • il pulsante PayPal non compare al checkout;
  • il pulsante compare ma la finestra di pagamento non si apre;
  • il cliente paga, ma l'ordine resta «in attesa di pagamento»;
  • compare un errore generico tipo «Si è verificato un errore durante l'elaborazione del pagamento»;
  • i pagamenti funzionano solo con alcune carte o solo da alcuni dispositivi.

Ogni sintomo punta in una direzione diversa: un pulsante che non compare fa pensare a una configurazione o a un conflitto, un ordine «in attesa» con pagamento ricevuto fa pensare ai webhook o alla comunicazione tra PayPal e il sito.

Le cause più frequenti

Credenziali e collegamento all'account

Il plugin ufficiale WooCommerce PayPal Payments si collega all'account PayPal Business. Se l'account è stato ricollegato, se è cambiata la password con revoca degli accessi o se si è passati per errore dalla modalità sandbox (di prova) a quella reale senza aggiornare i dati, il collegamento salta. È la prima cosa da verificare.

Plugin vecchio o doppio

Capita spesso di trovare due plugin PayPal attivi insieme, per esempio uno storico e quello ufficiale. Si pestano i piedi. Allo stesso modo, un plugin non aggiornato può smettere di funzionare quando PayPal cambia qualcosa dalla sua parte.

Webhook non configurati

I webhook sono le notifiche che PayPal manda al sito per dire «questo pagamento è andato a buon fine». Se non arrivano, perché bloccati da un firewall, da una regola di sicurezza o da un errore di configurazione, il pagamento c'è ma l'ordine non si aggiorna.

Certificato SSL e dominio

Senza un certificato SSL valido, o con contenuti misti (alcune risorse caricate in http), i browser bloccano parte degli script di pagamento. Lo stesso succede se il sito risponde su più indirizzi (con e senza www) e il plugin è configurato su quello sbagliato.

Valuta e paese

PayPal non supporta tutte le valute e alcuni metodi (come le carte tramite PayPal o i pagamenti a rate) dipendono dal paese dell'account. Una valuta impostata male in WooCommerce può far sparire il pulsante.

Conflitti con tema, cache e altri plugin

Plugin di cache, di ottimizzazione degli script o di sicurezza possono rimandare o bloccare il codice di PayPal. Anche il tema può interferire, soprattutto se modifica il checkout.

Come fare la diagnosi senza rischi

La regola d'oro: non fare prove sul negozio che vende. Si lavora su una copia (staging), così i clienti non vedono errori e non partono ordini finti.

  1. Leggi i log. In WooCommerce → Stato → Log trovi i registri del plugin PayPal: spesso l'errore è scritto lì in chiaro.
  2. Controlla il collegamento. Nelle impostazioni del plugin verifica che l'account risulti collegato e in modalità reale.
  3. Fai un ordine di prova in sandbox sulla copia del sito.
  4. Escludi i conflitti. Disattiva cache e ottimizzazioni, poi gli altri plugin uno alla volta, testando ogni volta. Se serve, passa per un momento a un tema standard.
  5. Verifica SSL e indirizzo. Il sito deve rispondere su un solo indirizzo in https, senza contenuti misti.
  6. Controlla i webhook dal pannello sviluppatori di PayPal e dal plugin.

Le soluzioni, in pratica

  • tieni un solo plugin PayPal, quello ufficiale, aggiornato;
  • ricollega l'account dal plugin se le credenziali risultano non valide;
  • escludi le pagine carrello, checkout e account dalla cache;
  • escludi gli script di pagamento dalle ottimizzazioni (unione e rinvio dei file JavaScript);
  • sistema il certificato SSL e i redirect verso un unico indirizzo;
  • controlla che la valuta del negozio sia supportata dall'account PayPal.

Dopo ogni correzione, un nuovo ordine di prova. Solo quando tutto funziona sulla copia si portano le modifiche sul negozio reale.

Quando conviene farsi aiutare

Se i log riportano errori nel codice, se il problema è comparso dopo modifiche personalizzate al checkout o se il database ha ordini incoerenti, il fai-da-te rischia di peggiorare la situazione. In questi casi conviene un intervento tecnico: si lavora su una copia, si trova la causa e si corregge senza fermare le vendite.

Se il tuo negozio ha questo problema, la nostra assistenza interviene su WooCommerce con diagnosi su ambiente separato e correzione documentata.

Domande frequenti

Perché PayPal non compare al checkout di WooCommerce?

Di solito per un account non collegato o in modalità sandbox, una valuta non supportata, un conflitto con cache o ottimizzazioni degli script, oppure due plugin PayPal attivi insieme.

Il cliente ha pagato ma l'ordine è «in attesa»: cosa significa?

Quasi sempre i webhook di PayPal non arrivano al sito, per un blocco del firewall o una configurazione errata. Il pagamento c'è, ma WooCommerce non riceve la conferma.

Posso fare le prove direttamente sul negozio online?

Meglio di no. Le prove si fanno su una copia del sito in modalità sandbox, così i clienti non vedono errori e non partono ordini finti.

Serve per forza il plugin ufficiale WooCommerce PayPal Payments?

È la soluzione consigliata perché è mantenuta e aggiornata. L'importante è averne uno solo attivo, aggiornato e collegato correttamente all'account Business.

FanaticoWeb · sul web dal 1995

Sviluppiamo web app e progetti con l'AI, gestiamo hosting e sistemi dedicati e lavoriamo sulla visibilità su Google e sui Motori di Risposta AI.

Continua a leggere

Altri articoli dal blog.

Hai un progetto da far crescere? Parliamone.

Raccontaci a che punto sei: ti diciamo come portarlo a termine o come migliorarlo.

Sottoponi il progetto