Collegare Stripe

Il metodo di pagamento Stripe usa una sola credenziale: la Chiave segreta dell'account Stripe. La chiave pubblicabile non serve. Il cliente paga nella pagina sicura di Stripe (Stripe Checkout), a cui il sito lo indirizza al momento del pagamento.

Per completare il collegamento servono le seguenti condizioni.

• Un account Stripe attivato per i pagamenti reali, con i dati dell'attività e del conto di accredito completati nella dashboard di Stripe.

• L'ambiente Ordini e prenotazioni attivo sul sito.

• L'accesso alla dashboard di Stripe da computer e al dispositivo che riceve il codice di verifica di Stripe.

La chiave si ricava dalla dashboard di Stripe, nella pagina delle chiavi API.

1. Accedere alla dashboard di Stripe. Accedere a dashboard.stripe.com con le credenziali dell'account.

2. Passare alla modalità live. Se è attiva una sandbox o la modalità test, passare alla modalità live dal selettore dell'account. Le chiavi live e quelle di prova sono distinte.

3. Aprire le chiavi API. Aprire Sviluppatori › Chiavi API, oppure direttamente dashboard.stripe.com/apikeys.

4. Copiare la chiave segreta. Nell'elenco delle chiavi standard, alla riga della chiave segreta, rivelare la chiave live e copiarne il valore, che inizia con sk_live_.

Stripe mostra il valore di una chiave segreta live una sola volta quando la chiave è stata creata manualmente. Se il valore non è più visibile, si crea una nuova chiave con Crea chiave segreta: Stripe chiede un codice di verifica, poi un nome per la chiave (per esempio il nome del sito). Il valore va copiato subito, perché in seguito non si rilegge.

In alternativa alla chiave segreta è accettata una chiave limitata, che inizia con rk_live_. La chiave limitata deve avere almeno i seguenti permessi, altrimenti il collegamento o i pagamenti non vanno a buon fine.

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 Stripe. Il campo Nome è interno al pannello; l'interruttore Attivo rende il metodo disponibile al cliente.

Collegamento. Compilare i campi della scheda.

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. Una chiave che non inizia con sk_live_, sk_test_, rk_live_ o rk_test_ viene rifiutata con il messaggio Inserisci una chiave segreta valida.

Al salvataggio il sistema registra in automatico sull'account Stripe un webhook, con cui Stripe comunica i pagamenti completati, gli importi autorizzati in attesa di incasso, gli incassi e i pagamenti non riusciti. Non occorre configurare alcuna notifica nella dashboard di Stripe.

• Se Stripe rifiuta la registrazione, il salvataggio non va a buon fine e compare il messaggio Stripe non ha accettato la registrazione delle notifiche: controlla la chiave. Le cause più frequenti sono una chiave revocata o scaduta e una chiave limitata senza il permesso di scrittura su Webhook Endpoints.

• La sostituzione della Chiave segreta registra un nuovo webhook al salvataggio. Il webhook precedente resta nell'account Stripe, nella sezione Webhook della dashboard, e si elimina da lì: è quello con lo stesso indirizzo e la data di creazione meno recente.

• Il webhook registrato dal sistema non va modificato né eliminato nella dashboard di Stripe: senza notifiche gli ordini non ricevono l'esito dei pagamenti.

• Con il webhook attivo la scheda Collegamento riporta Notifiche di Stripe 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 Stripe accetti la chiave salvata. La verifica legge soltanto il saldo dell'account: non crea pagamenti e non modifica l'account Stripe.

La Chiave segreta salvata è cifrata e non si rilegge: nella scheda compare mascherata e si può soltanto sostituire con il pulsante Sostituisci.

La pagina di pagamento di Stripe propone i metodi abilitati nell'account Stripe, come carte, Apple Pay e Google Pay. L'elenco si gestisce nella dashboard di Stripe, nelle impostazioni dei metodi di pagamento, e non nel pannello. Stripe mostra a ogni cliente i metodi compatibili con la valuta dell'ordine e con il suo dispositivo.

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 usa la chiave segreta della sandbox o della modalità test di Stripe, che inizia con sk_test_. Il campo Modalità passa a Test · dalla chiave e l'elenco dei metodi mostra lo stato Test. Il webhook viene registrato sulla sandbox.

In modalità test si paga con le carte di prova di Stripe, per esempio 4242 4242 4242 4242 con una qualsiasi data di scadenza futura e un qualsiasi CVC. L'elenco completo è nella documentazione di Stripe.

Per il passaggio in produzione si sostituisce la chiave con quella che inizia con sk_live_ e si salva: la modalità diventa Live · dalla chiave e il webhook viene registrato sull'account live. Il webhook della sandbox si può eliminare dalla dashboard di Stripe in modalità test.