Pagamenti online: collegare Stripe e PayPal a Horizon

Horizon · Pagamenti online · Guida alla configurazione

Come collegare a Horizon gli account Stripe e PayPal dello studio, provare i pagamenti senza muovere denaro e scegliere come registrare gli incassi in contabilità.

Questa guida è la parte tecnica dei pagamenti online di Horizon. Per sapere che cosa fa il servizio (link di pagamento per fatture, scadenze, piani rateali e appuntamenti, e-mail automatiche e registrazione degli incassi) leggi prima l’articolo Pagamenti online in Horizon.

La configurazione si fa una volta sola e richiede pochi minuti per ciascun fornitore. Si può collegare solo Stripe, solo PayPal oppure entrambi: il paziente vedrà i pulsanti dei fornitori attivi.

Prima di iniziare

• Un account Stripe dello studio, attivo e abilitato a ricevere pagamenti (si apre da stripe.com/it), e/o un account PayPal Business dello studio.
• L’accesso a quegli account: servono le credenziali di chi li amministra. Apertura, verifica e gestione dell’account presso Stripe o PayPal sono a cura dello studio.
• La licenza dei pagamenti online di Horizon: se manca, il pulsante «Attiva pagamenti» la attiva dalla stessa schermata.
• Il server dei servizi web dello studio, che registra gli incassi in Horizon. Se non è ancora configurato, Horizon lo propone prima di aprire i pagamenti.

Dove si configura

In Horizon, dalla pagina Servizi online › Prenotazioni, premi «Configura pagamenti». Si apre la finestra del conto d’incasso con tre schede:

• Incassi e link: come registrare gli incassi e l’interruttore dei link di pagamento;
• Stripe: la chiave dell’account Stripe;
• PayPal: i due codici dell’app PayPal.

In alto la finestra mostra lo stato della licenza dei pagamenti online. Ogni modifica diventa effettiva solo quando premi OK: Horizon salva e aggiorna il servizio online. Annulla scarta tutto.

Collegare Stripe

Stripe chiede una chiave con limitazioni: una chiave che può fare una sola cosa, aprire le pagine di pagamento (Checkout). È la scelta più sicura, perché anche chi la conoscesse non potrebbe fare nient’altro sul conto dello studio.

1. Nella scheda Stripe premi «Apri Stripe» e accedi al conto dello studio. Per incassare usa l’ambiente reale (Live), non la Sandbox.
2. In Sviluppatori › Chiavi API scegli «Crea chiave con limitazioni».
3. Scegli «Attivare un’integrazione che hai creato», poi il collegamento «Scegli il tuo». Dai alla chiave il nome prenota.caes.it, così la riconoscerai in seguito.
4. Cerca Checkout Sessions e imposta «Scrittura» nella colonna Autorizzazioni. Lascia «Nessuna» per tutte le altre risorse e per le Autorizzazioni Connect, poi crea la chiave.
5. Copia la chiave completa (inizia con rk_live_), incollala nel campo «Chiave Stripe (API)» e premi «Verifica e usa». Il tasto destro sul campo incolla direttamente.
6. Premi OK per salvare e aggiornare il servizio online.

«Verifica e usa» interroga Stripe prima di accettare la chiave: una chiave sbagliata, scaduta o con permessi insufficienti viene rifiutata subito, invece di farsi scoprire settimane dopo da un paziente che non riesce a pagare. Dopo la verifica il campo si svuota: la chiave viene cifrata e da quel momento Horizon ne mostra solo l’inizio e la fine, per riconoscerla.

Con «Verifica Stripe online» puoi controllare in qualsiasi momento la chiave che il servizio sta usando davvero. Se nel frattempo ne hai impostata una diversa e non hai ancora premuto OK, Horizon te lo segnala.

Collegare PayPal

PayPal fornisce due codici: il Client ID e il Secret. Il Secret è una chiave riservata dell’app, non la password del conto PayPal.

1. Nella scheda PayPal lascia deselezionata «Usa la modalità di prova» e premi «Apri PayPal»: si apre il portale sviluppatori di PayPal.
2. Accedi con il conto dello studio. In Apps & Credentials, sezione Live, apri un’app esistente o creane una nuova.
3. Copia Client ID e Secret nei campi «Codice identificativo (Client ID)» e «Chiave riservata (Secret)», poi premi «Verifica e usa».
4. Premi OK per salvare e aggiornare il servizio online.

Le credenziali di prova (Sandbox) e quelle reali (Live) si somigliano, ma funzionano su due server diversi. Se incolli codici di un tipo con la casella impostata sull’altro, Horizon se ne accorge durante la verifica e sistema la casella da solo.

Incassi e link

Nella scheda Incassi e link si decide come gli incassi online entrano in contabilità.

• Incassi Stripe e Incassi PayPal: il tipo di pagamento con cui registrarli. Può essere lo stesso per entrambi, uno diverso per ciascuno, oppure nessuno («da assegnare in seguito»). Il tipo di pagamento determina anche la cassa; l’elenco si gestisce in Contabilità › Tipo di pagamenti. L’incasso viene registrato comunque, anche senza tipo di pagamento.
• «Consenti l’invio di link da fatture, scadenze e agenda di Horizon»: è l’interruttore dei link di pagamento. Finché è spento, il pagamento online resta disponibile solo durante la prenotazione.

Dopo l’attivazione, i pagamenti ricevuti si controllano da Contabilità › Pagamenti › Pagamenti online ricevuti.

Fare una prova senza pagamenti reali

Prima di aprire il servizio ai pazienti conviene fare un pagamento di prova. La procedura è la stessa della configurazione reale, con le credenziali dell’ambiente di prova.

Stripe. In Stripe passa all’ambiente di prova (Sandbox) e crea la chiave come descritto sopra: inizierà con rk_test_. Incollala in Horizon, premi «Verifica e usa», conferma la prova e premi OK. Apri una pagina di pagamento e usa la carta di prova 4242 4242 4242 4242, con una scadenza futura e tre cifre qualsiasi come codice di sicurezza.

PayPal. Seleziona «Usa la modalità di prova» e usa i codici di un’app della sezione Sandbox. Per pagare servirà un account compratore Sandbox, che PayPal crea nel portale sviluppatori.

Controlla poi l’esito in Horizon, in Pagamenti online ricevuti.

Rimborsi e scollegamento

I rimborsi si fanno dal pannello di Stripe o di PayPal, che restano il registro ufficiale dei pagamenti. Dopo un rimborso, ricordati di stornare anche l’incasso in Horizon.

Il pulsante «Scollega» di ciascuna scheda toglie il fornitore: dopo OK i pazienti non potranno più pagare con quel fornitore finché non lo ricolleghi. Se cambi la chiave in Stripe o rigeneri il Secret in PayPal, basta incollare le nuove credenziali e premere di nuovo «Verifica e usa» e OK.