Easy Digital Downloads viene fornito con un'integrazione PayPal integrata. Questo gateway utilizza l'ultima esperienza di checkout di PayPal, utilizzando pulsanti intelligenti 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 utilizzando questo gateway. 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 per aprire una finestra modale di PayPal. Ti verrà richiesto di inserire il tuo indirizzo email e paese. Procedi attraverso 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 non viene ancora visualizzata, potresti provare con il browser Chrome.
Se riscontri un errore durante la connessione a PayPal e il problema persiste, ciò potrebbe essere causato da regole del server che impediscono la visualizzazione della finestra modale di connessione. Questo potrebbe presentarsi come un errore relativo alla funzione `hash_equals`. Per risolverlo, tu o il tuo host potreste dover regolare la `Cross-Origin-Opener-Policy`. Se il valore è "same-origin", può causare questo problema.
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 questo 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 alle impostazioni di amministrazione EDD, l'area "Stato connessione" controllerà la tua connessione a PayPal. Ci sono tre possibilità:
Successo
Il tuo account è stato connesso con successo, sei pronto per accettare pagamenti e EDD ha creato un webhook per tuo conto. Puoi leggere di più sul webhook nella sezione webhook.
Successo, con avviso webhook
Ci si significa che il tuo account PayPal " " stato collegato con successo e puoi iniziare ad accettare pagamenti. Tuttavia, EDD non " " riuscito a creare un webhook per tuo conto. Non " " qualcosa di cui devi preoccuparti in un ambiente locale, ma se accade sul tuo sito live, contatta il supporto EDD per assistenza. Puoi leggere di pi " cosa serve il webhook nella sezione webhook.
Errore
Potresti anche ricevere un messaggio di errore come questo. La maggior parte degli errori in "Stato del pagamento" significa che qualcosa nel tuo account PayPal non " " pronto per ricevere pagamenti. Ci si significa che devi contattare l'assistenza clienti PayPal o fare qualcosa all'interno del tuo account PayPal, come confermare il tuo indirizzo email.
Una volta corretti eventuali errori, fai clic su "Verifica nuovamente lo stato del pagamento" per verificare nuovamente il tuo account con PayPal. Tutti gli errori devono essere risolti prima di poter iniziare ad accettare pagamenti.
3. Abilita il gateway PayPal
Una volta connesso, assicurati di abilitare il gateway nelle impostazioni generali del gateway:
Ripeti in modalit " live
Se ti connetti inizialmente in modalit " di test, dovrai ripetere questo processo di connessione una volta che avrai impostato il tuo negozio in modalit " live.
Webhook
Easy Digital Downloads tenter " automaticamente di creare un webhook per tuo conto. Il webhook viene utilizzato principalmente per trasmettere le azioni che si verificano nel dashboard di PayPal a EDD. Ad esempio: se rimborsi un pagamento all'interno di PayPal, EDD lo rilever " e aggiorner " automaticamente lo stato del pagamento in EDD per te.
I webhook non sono necessari per elaborare i pagamenti, ma sono raccomandati per l'integrazione pi " completa.
Controllo dello stato del webhook
Puoi controllare lo stato del tuo webhook in qualsiasi momento andando su Download » Impostazioni » Pagamenti » PayPal. Lo stato del webhook sar " elencato, insieme agli eventi registrati.
Il pulsante "Sincronizza Webhook" controller " semplicemente di nuovo lo stato del webhook e registrer " eventuali eventi mancanti. In genere non dovresti aver bisogno di fare clic su questo, a meno che:
- Non hai cambiato l'URL del tuo sito; oppure
- Vedi un messaggio di avviso riguardo al webhook non completamente configurato o un avviso riguardo a eventi mancanti.
IPN di fallback
Easy Digital Downloads ti permetter " ora di utilizzare un servizio IPN di fallback che gestisce tutti gli 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 a forma di 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 abilitato l'IPN 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.
PayPal Commerce Pro
PayPal Commerce Pro è un'estensione a pagamento che consente ai clienti di pagare tramite carta di credito o debito e metodi di pagamento alternativi (a seconda del tuo paese), come Venmo, Apple Pay e Google Pay direttamente sul tuo sito, invece di essere reindirizzati al sito di PayPal.
Una volta installato e attivato, una nuova impostazione, "Abilita pagamenti avanzati con carta di credito e debito", sarà presente nelle impostazioni di PayPal situate in Download » Impostazioni » Pagamenti » PayPal.
Una volta abilitati, i pulsanti "Carta di debito o credito" e "Paga più tardi" (se supportato dal tuo account PayPal) appariranno nella pagina di checkout, insieme al pulsante PayPal.
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:
Dopo aver cliccato sul pulsante, si apre una modale su PayPal.com, che chiede all'utente di accedere al proprio account PayPal. Il cliente può completare l'intero processo di checkout senza lasciare il tuo sito.
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
PayPal Sandbox ti consente di configurare 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 utilizzarlo per tutto il tempo che desideri poiché questi sono account di test che mimano 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, esci dalla modalità di test o nessuna delle tue vendite sarà valida. Potrebbe essere necessario connettersi con il 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 e 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é gli abbonamenti creati 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 modifichi la 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: stai usando Aelia Currency Switcher?
PayPal dovrà essere riaggiunto nelle Impostazioni dei gateway di pagamento di Aelia per le valute supportate sul tuo sito. Altrimenti, PayPal non sarà più un gateway disponibile al momento del 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). Sfortunatamente, 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é appare "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à Test e che il tuo account Sandbox PayPal non sia connesso alla tua connessione PayPal live (connessione a PayPal con modalità 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 a cui è associato il 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. È possibile che PayPal abbia 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.
È possibile aggiungere o rimuovere i pulsanti Paga in 3 o Paga in 4?
PayPal Commerce Pro è necessario affinché il pulsante Paga in 3 o Paga in 4 appaia sul tuo sito. Se il pulsante appare e desideri disattivarlo, puoi farlo tramite le impostazioni EDD PayPal.
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. Questa è conosciuta 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 esternamente 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 il pagamento. 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.
