Collegare PayPal

Il metodo di pagamento PayPal usa le credenziali API dell'integrazione PayPal Checkout: la Chiave API e il Codice segreto. Le credenziali si ricavano dall'account PayPal Business, senza programmazione e senza un account sviluppatore separato, e nel metodo di pagamento si inseriscono nei campi con lo stesso nome.

Per completare il collegamento servono le seguenti condizioni.

• Un account PayPal Business attivo e verificato: un account personale non dispone delle credenziali API di produzione.

• L'ambiente Ordini e prenotazioni attivo sul sito.

• L'accesso all'account PayPal da computer.

Le credenziali si ottengono dall'account PayPal Business, nella procedura di attivazione di PayPal Checkout.

1. Accedere all'account PayPal Business. Accedere a paypal.com con le credenziali dell'account Business.

2. Aprire PayPal Checkout. Fra gli strumenti di pagamento dell'account aprire PayPal Checkout, anche cercandolo nel campo Cerca strumenti, e premere Inizia.

3. Scegliere l'integrazione sul proprio sito. Nella pagina Configura il sito per accettare pagamenti, riquadro Hai un sito personalizzato?, premere Scegli. L'opzione Imposta link e pulsanti di pagamento non fornisce le credenziali API e non va utilizzata.

4. Selezionare l'integrazione standard. Fra le modalità di integrazione proposte scegliere l'integrazione standard. Si apre la pagina Completa la tua integrazione per attivare PayPal sul tuo sito.

5. Passare alle credenziali Live. Nella sezione Ecco le credenziali necessarie, nel selettore Sandbox / Live, selezionare Live.

6. Copiare le credenziali. Nel riquadro Credenziali API copiare la Chiave API con l'icona di copia accanto al valore. Per il Codice segreto l'icona a forma di occhio mostra il valore e l'icona di copia lo copia.

Il riquadro Credenziali Sandbox, con Nome utente e Password, non riguarda il metodo di pagamento e non va utilizzato. Il pulsante Fatto chiude la procedura.

Se le credenziali Live non sono disponibili, l'account non è di tipo Business oppure la sua verifica non è ancora completa. La situazione si risolve nell'account PayPal, non nel pannello.

In alternativa le stesse credenziali sono disponibili nel portale developer.paypal.com, con lo stesso accesso dell'account Business: ambiente Live, voce Apps & Credentials. Nel portale la Chiave API compare come Client ID e il Codice segreto come Secret.

Il metodo si crea nell'ambiente Ordini e prenotazioni, gruppo Impostazioni, voce Metodi di pagamento, con il pulsante Nuovo. La finestra è divisa in tre schede.

Generale. In Tipo, nel gruppo dei metodi online, selezionare PayPal. Il campo Nome è interno al pannello; l'interruttore Attivo rende il metodo disponibile al cliente.

Collegamento. Compilare i campi con le credenziali Live.

Testi per il cliente. Per ogni lingua del sito: Titolo e Descrizione breve mostrati nella scelta del pagamento, Istruzioni dopo l'ordine facoltative.

Il salvataggio con Salva completa la configurazione.

Al salvataggio il sistema registra in automatico sull'account PayPal un webhook, con cui PayPal comunica autorizzazioni, catture, rifiuti e rimborsi dei pagamenti. Non occorre configurare alcuna notifica nell'account PayPal.

• Se PayPal rifiuta la registrazione, il salvataggio non va a buon fine e compare il messaggio PayPal non ha accettato la registrazione delle notifiche. La causa più frequente sono credenziali errate o di un ambiente diverso da quello impostato con Modalità test.

• La modifica di Chiave API, Codice segreto o Modalità test registra di nuovo il webhook al salvataggio successivo.

• Con il webhook attivo la scheda Collegamento riporta Notifiche di PayPal attive, la data di registrazione e la data dell'ultima notifica ricevuta.

Dopo il primo salvataggio, nella scheda Collegamento è disponibile il pulsante Verifica collegamento, che controlla che PayPal accetti le credenziali salvate.

Il Codice segreto salvato è cifrato e non si rilegge: nella scheda compare mascherato e si può soltanto sostituire con il pulsante Sostituisci.

Un metodo di pagamento compare al cliente solo se è collegato ad almeno un preset d'ordine. Il collegamento, l'ordine di comparsa e il metodo predefinito si impostano nella voce Preset d'ordine dello stesso gruppo Impostazioni. La scheda del metodo elenca i preset in cui è presente.

Per collaudare il flusso senza pagamenti reali si usano la Chiave API e il Codice segreto con il selettore su Sandbox e si salva il metodo con Modalità test attiva. In questa modalità l'elenco dei metodi mostra lo stato Test.

Per il passaggio in produzione si sostituiscono Chiave API e Codice segreto con le credenziali Live, si disattiva Modalità test e si salva: il webhook viene registrato di nuovo sulle credenziali di produzione.