Easy Digital Downloads include l'integrazione PayPal integrata. Questo gateway utilizza l'ultima esperienza di checkout di PayPal, con pulsanti smart e una finestra modale "Paga con PayPal" che mantiene gli utenti sul tuo sito durante l'intero processo di pagamento. Questa documentazione copre tutto ciò che devi sapere sulla gestione della tua configurazione PayPal.
Aggiornamento da un gateway PayPal diverso? Vedi le nostre note di aggiornamento.
NOTA: Questa integrazione PayPal richiede un certificato SSL. Se non ne hai ancora uno, consulta il nostro articolo su come configurare SSL.
Configura PayPal
1. Connetti al tuo account PayPal
Avrai bisogno di un account PayPal per accettare pagamenti. Se non hai già un account, ti verrà data la possibilità di crearne uno durante il processo di onboarding.
Accedi alla tua amministrazione WordPress e vai su Download » Impostazioni » Pagamenti » PayPal. Vedrai un pulsante per connetterti a PayPal nella modalità corrente del tuo negozio (sandbox o live).

Fai clic sul pulsante Connetti con PayPal per aprire una finestra modale di PayPal. Ti verrà richiesto di inserire il tuo indirizzo email e il tuo paese. Procedi con i passaggi per accedere al tuo account esistente o crearne uno nuovo.
Importante: Devi avere i popup del browser abilitati affinché la pagina PayPal si apra in una finestra modale. Se non vedi una finestra modale, controlla le impostazioni dei popup del tuo browser, chiudi il browser e riprova. Se la finestra popup ancora non viene visualizzata, potresti provare con il browser Chrome.
Se ti stai connettendo in modalità di test, dovrai accedere con le credenziali del tuo account sandbox. Se non hai ancora un account sandbox PayPal, consulta il nostro articolo su come crearne uno.

Dopo aver completato tutti i passaggi, dovresti vedere un messaggio di successo.

Assicurati di fare clic sul pulsante per tornare al tuo negozio. Se non fai clic su questo pulsante, non saremo in grado di completare il processo di onboarding e dovrai ricominciare da capo.
2. Controlla lo stato del tuo account
Tornando nelle impostazioni di amministrazione di EDD, l'area Stato della connessione verificherà la tua connessione a PayPal.
Il tuo account è stato connesso con successo e sei pronto per accettare pagamenti!

3. Configura i metodi di pagamento disponibili
Una volta connesso PayPal, puoi scegliere quali metodi di pagamento PayPal abilitare, come mostrato di seguito.

Al termine, ricorda di salvare le modifiche.
4. Abilita il gateway PayPal
Dovrai abilitare PayPal come gateway di pagamento attivo per poterlo visualizzare nella pagina di checkout. Per farlo, attiva l'opzione PayPal nella scheda Generale di Impostazioni » Pagamenti.

Ripeti in modalit " live
Se ti sei connesso inizialmente in modalità test/sandbox, dovrai ripetere questo processo di connessione una volta che avrai impostato il tuo negozio in modalità live.
Nella scheda Generale, disabilita la Modalità Test. Quindi torna alla scheda PayPal e seleziona Connetti a PayPal in modalità live.
IPN di fallback
Easy Digital Downloads ti permetterà di utilizzare un servizio IPN di fallback che gestisce eventuali scenari in cui un evento Webhook potrebbe non essere consegnato al tuo sito web.
Per configurare l'IPN, devi accedere al tuo account PayPal e passare il mouse sopra l'icona dell'ingranaggio nell'angolo in alto a destra dello schermo, quindi selezionare Impostazioni account

Fai clic su Notifiche sul lato sinistro dello schermo, quindi fai clic su Aggiorna accanto a Notifiche di pagamento istantaneo.

Se non avevi l'IPN abilitato in precedenza, vedrai un pulsante Scegli impostazioni IPN. Nella pagina delle impostazioni IPN, aggiungi l'URL del tuo sito web nel formato: https://tuosito.com/?edd-listener=eppe
Sostituisci tuosito.com nel link con l'URL effettivo del tuo sito web.

Seleziona la casella Ricevi messaggi IPN (Abilitato), quindi fai clic su Salva.
Ecco fatto! Questo fungerà ora da fallback per il Webhook principale che la configurazione di PayPal utilizza quando collega il tuo account.
Esperienza di checkout
Questo gateway di pagamento utilizza i moderni pulsanti di checkout di PayPal. Invece di un normale pulsante "Acquista", i tuoi clienti vedranno questo alla fine del modulo di checkout, insieme ad altre opzioni di pagamento disponibili, come Venmo, Google/Apple Pay, Fastlane, Paga più tardi e pagamento diretto con carta di credito/debito.

Integrazione pagamenti ricorrenti
Questo gateway PayPal ha il supporto completo per l'estensione Pagamenti Ricorrenti. Consulta la documentazione di configurazione di Pagamenti Ricorrenti PayPal per le istruzioni di configurazione.
Supporto browser
Il supporto è garantito per i seguenti browser desktop. Per qualsiasi browser non presente in questo elenco, i pulsanti potrebbero continuare a funzionare, ma la compatibilità non è garantita.
- Chrome versione 41 e successive
- Firefox versione 43 e successive
- Safari versione 8 e successive
- Opera versione 12 e successive
- Edge versione 14 e successive
- * Internet Explorer versione 11 e successive
* Nota: sebbene i pulsanti dovrebbero funzionare su IE11, dobbiamo caricare diversi polyfill per renderlo compatibile. Per la migliore esperienza di checkout, consigliamo di utilizzare un browser più moderno. Se preferisci non caricare i polyfill per IE11, puoi disabilitarli aggiungendo questo codice personalizzato al tuo sito:
add_filter( 'edd_load_ie11_polyfills', '__return_false' );
Se aggiungi questo snippet di codice, il gateway PayPal non funzionerà in IE11.
Per maggiori informazioni sui requisiti del browser per PayPal Checkout, consulta la pagina di supporto browser di PayPal.
Creazione di un account PayPal Sandbox
Il PayPal Sandbox ti permette di creare account di test che possono essere utilizzati per testare l'intero processo di acquisto in Easy Digital Downloads con il gateway PayPal. Nessun addebito reale viene effettuato e puoi usarlo per tutto il tempo che desideri, poiché questi sono account di test che imitano il flusso reale di PayPal.
Per creare un account sandbox, visita https://developer.paypal.com e fai clic su Accedi o Registrati se non hai già un account PayPal configurato. Puoi accedere con il tuo account PayPal esistente se ne hai uno.
Una volta effettuato l'accesso, segui i passaggi seguenti per creare un account Sandbox
- Vai su Strumenti di test > Account Sandbox.
- Fai clic su "Crea account".
- Seleziona "Business", scegli il paese dell'account e fai clic su "Crea account".
- Fai di nuovo clic su "Crea account" e questa volta seleziona "Personale" come tipo di account.
I passaggi precedenti creeranno un account Merchant che utilizzerai per connetterti all'interno di EDD e uno Personale che utilizzerai durante il flusso di Checkout per simulare un pagamento.
Nella pagina Account Sandbox, puoi fare clic sull'account che desideri visualizzare/modificare e puoi visualizzare la password predefinita impostata durante la creazione o impostare la tua password personalizzata.
Come posso essere sicuro di essere in modalità di test?
Per assicurarti che il tuo sito stia operando in Modalità di Test, vai su Download > Impostazioni > Pagamenti, e seleziona la casella Modalità di Test in cima alla pagina.
Ricorda
Prima di mettere online il tuo sito, rimuovilo dalla Modalità di Test, altrimenti nessuna delle tue vendite sarà valida. Potrebbe essere necessario connettersi al tuo account PayPal Live una volta disattivata la modalità di test.
Aggiornamento da altri gateway PayPal
L'aggiornamento al nuovo gateway PayPal consiste semplicemente nel connettersi, seguire i passaggi di configurazione sopra indicati, quindi disabilitare i vecchi gateway.
Se in precedenza hai utilizzato una delle nostre vecchie integrazioni PayPal, come PayPal Standard, PayPal Express, PayPal Pro o PayPal Payments Advanced, ti verrà richiesto di passare a questo nuovo gateway dopo l'aggiornamento a Easy Digital Downloads versione 2.11.
Come funziona l'aggiornamento?
Fino a quando non ti connetti al nuovo gateway, i pagamenti continueranno a essere elaborati attraverso il tuo sito utilizzando il gateway esistente che hai selezionato. Quando ti connetti alla nuova integrazione PayPal, dovresti connetterti utilizzando lo stesso identico account PayPal che hai usato prima. Una volta completato il processo di connessione e abilitato il nuovo gateway, i pagamenti inizieranno a essere elaborati tramite la nuova integrazione PayPal. Assicurati di disabilitare il vecchio gateway in modo che solo quello nuovo sia attivo.
All'interno di PayPal stesso, non noterai alcuna differenza. I pagamenti arriveranno ancora nello stesso modo di prima. Solo l'esperienza di checkout sul tuo sito è stata aggiornata.
E per quanto riguarda i pagamenti ricorrenti?
Se utilizzi la nostra estensione Pagamenti Ricorrenti, puoi passare in sicurezza al nuovo gateway PayPal senza influire sugli abbonamenti esistenti. I vecchi abbonamenti continueranno a essere elaborati e rinnovati normalmente. Tuttavia:
- Una volta configurato il nuovo gateway, puoi deselezionare il vecchio gateway dall'elenco dei gateway di pagamento abilitati.
- Per PayPal Express e Pro, devi mantenere configurato il tuo vecchio PayPal IPN (Documentazione IPN Express / Pro), poiché le sottoscrizioni create con il vecchio gateway continueranno a utilizzare IPN per informare EDD sui pagamenti di rinnovo. PayPal Standard non si basa su IPN, poiché l'URL è impostato in modo fisso nell'IPN. Se non utilizzi il tuo account PayPal con più negozi, ti consigliamo di impostarlo nel caso in cui PayPal cambi funzionalità in futuro (Documentazione IPN Standard), ma non è obbligatorio.
- Se stai usando PayPal Express o PayPal Pro, devi mantenere quel plugin attivo. Il gateway stesso non dovrebbe essere abilitato (Download » Impostazioni » Pagamenti), ma il plugin sì. Questo serve a garantire che il gateway possa continuare a elaborare vecchi IPN, come indicato nel passaggio 2.
Nota: Utilizzi Aelia Currency Switcher?
PayPal dovrà essere nuovamente aggiunto nelle Impostazioni dei Gateway di Pagamento di Aelia per le valute supportate sul tuo sito. Altrimenti, PayPal non sarà più un gateway disponibile al checkout.
Devo aggiornare alla nuova integrazione?
Tutte le vecchie integrazioni PayPal saranno deprecate. Non riceveranno più aggiornamenti in futuro. Inoltre, molte delle vecchie integrazioni sono deprecate anche da parte di PayPal e rappresentano esperienze di checkout obsolete.
Le vecchie integrazioni dovrebbero continuare a funzionare in EDD 2.x, ma consigliamo di passare al nuovo gateway prima della 3.0, poiché le vecchie estensioni PayPal non verranno aggiornate per essere compatibili con la 3.0.
FAQ
Vedo SANDHILLS DEVELOPMENT, LLC durante il processo di connessione. È previsto?
Sì, Easy Digital Downloads è un prodotto di SANDHILLS DEVELOPMENT, LLC. Stai accettando di connettere il tuo account PayPal al tuo negozio Easy Digital Downloads (un prodotto di SANDHILLS DEVELOPMENT, LLC). Purtroppo, PayPal richiede l'uso del nome dell'azienda invece del nome del nostro prodotto.
Posso connettermi a PayPal con un account personale?
È richiesto un account aziendale per connettere EDD a PayPal. Non puoi connettere EDD a un account PayPal personale. Se non hai un account aziendale, puoi crearne uno separato e avere più account PayPal se non vuoi trasformare il tuo account personale in un account aziendale.
Perché viene visualizzato "Errore di autenticazione imprevisto" sulla mia pagina di checkout?
Ciò è probabilmente dovuto al fatto che PayPal non è correttamente connesso al tuo negozio. Controlla lo stato sotto Download > Impostazioni > Pagamenti > PayPal. Vorrai anche confermare che il tuo account PayPal live non sia connesso a EDD in Modalità di Test, e che il tuo account PayPal Sandbox non sia connesso alla tua connessione PayPal live (connessione a PayPal con Modalità di Test disabilitata).
Perché PayPal non riesce a connettersi a EDD?
Ciò può essere dovuto a diversi problemi.
– Prova a connetterti tramite un browser o dispositivo diverso.
– Conferma che il paese del tuo account PayPal sia un paese supportato, elencato nel menu a discesa durante il processo di connessione.
– Conferma che il tuo account PayPal sia completamente attivo. PayPal potrebbe avere azioni in sospeso che devi completare. Cerca avvisi nel tuo account PayPal e/o contatta il supporto PayPal per confermare che il tuo account sia attivo.
Posso aggiungere o rimuovere i pulsanti Paga in 3 o Paga in 4?
Questo metodo di pagamento può essere disabilitato nelle impostazioni del gateway PayPal all'interno di EDD.
Puoi anche supportare un numero fisso di pagamenti utilizzando la nostra estensione Recurring Payments.
Perché il checkout ospite di PayPal non viene visualizzato?
Quando si paga tramite una pagina di checkout su PayPal.com, a volte c'è l'opzione di pagare con carta di credito senza accedere a PayPal. Questo è noto come modalità di checkout "ospite" o PayPal Account Optional. Vedi le istruzioni di PayPal qui per abilitare o disabilitare. Ecco come abilitare l'impostazione PayPal account optional:
- Passa il mouse sopra il tuo nome nell'angolo in alto a destra.
- Fai clic su Impostazioni account nel menu a discesa.
- Fai clic su Pagamenti sul sito web sotto 'Prodotti e servizi' a sinistra della pagina.
- Fai clic su Aggiorna accanto a 'Preferenze del sito web'.
- Seleziona Attivato sotto 'PayPal account optional'.
Ho bisogno di SSL se uso PayPal?
Sì, è necessario che SSL sia abilitato sul tuo sito web, anche se i pagamenti vengono elaborati fuori dal sito con PayPal.
I clienti non vengono reindirizzati al mio sito dopo aver pagato.
Quando le persone pagano con PayPal, si aspettano di essere reindirizzate al tuo sito web dopo aver pagato. Se questo non funziona correttamente, l'opzione di ritorno automatico probabilmente deve essere abilitata nel tuo profilo PayPal.
Accedi al tuo account PayPal e vai alle impostazioni del tuo profilo.
Nelle tue impostazioni, fai clic su Preferenze del sito web.
Lì avrai un'opzione per abilitare il ritorno automatico.
Nell'esempio sopra, è disattivato. Per attivarlo, scegli il pulsante radio Attivato, e poi nel campo sottostante, assicurati di inserire l'indirizzo a cui desideri che i tuoi clienti vengano reindirizzati.
