PayPal
Oggi l’integrazione PayPal copre la ricezione delle notifiche di pagamento: quando un incasso è completato, contestato o rimborsato, il gestionale lo registra e aggiorna la prenotazione collegata. L’avvio del pagamento dal gestionale è in arrivo. Le credenziali dell’app PayPal sono del laboratorio.
In arrivoCosa fa
Ricezione notifiche di pagamento; avvio pagamento in arrivo.
Categoria: pagamenti — Incassi online e in cassa, ricevute e registratore telematico.
Cosa serve
- Account PayPal Business del laboratorio e una app creata nel portale sviluppatori
- Endpoint pubblico raggiungibile in HTTPS per ricevere le notifiche
Come funziona oggi
PayPal invia una notifica al webhook del gestionale a ogni evento rilevante sull’account del laboratorio.
Prima di leggere il contenuto il gestionale fa verificare la firma della notifica a PayPal, usando le credenziali dell’app e l’identificativo del webhook. Una notifica non verificabile viene rifiutata.
Gli eventi accettati aggiornano pagamento, prenotazione e stato della contestazione. Ogni evento è registrato una sola volta, anche in caso di rinvio da parte di PayPal.
Cosa è in arrivo
L’avvio del pagamento dal gestionale, con creazione dell’ordine e reindirizzo del paziente, non fa ancora parte della configurazione supportata.
Fino ad allora il pagamento va iniziato dai canali PayPal del laboratorio; il gestionale ne registra l’esito.
Limiti
Senza credenziali ogni notifica viene rifiutata: è una scelta voluta, perché una notifica non verificata non può muovere un incasso.
La verifica avviene verso l’ambiente di produzione di PayPal: le notifiche generate in sandbox non superano il controllo.
Gli eventi relativi agli abbonamenti PayPal vengono archiviati ma non modificano i piani nel gestionale.
Come si attiva
Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.
Per il tecnico
- `PAYPAL_CLIENT_ID` e `PAYPAL_CLIENT_SECRET` — credenziali dell’app, usate per far verificare la firma
- `PAYPAL_WEBHOOK_ID` — identificativo del webhook configurato nel tuo account
- Crea l’app nel portale sviluppatori PayPal a nome del laboratorio.
- Copia Client ID e Client Secret nelle rispettive variabili.
- Registra il webhook verso `/api/webhooks/paypal` del tuo dominio e sottoscrivi gli eventi di incasso, rimborso e contestazione.
- Copia l’identificativo del webhook in `PAYPAL_WEBHOOK_ID`.
- Genera un evento di prova dal pannello PayPal e verifica che compaia nel registro pagamenti.
Domande frequenti
Posso già far pagare il paziente con PayPal dal gestionale?
Non ancora. Oggi è supportata la ricezione delle notifiche; l’avvio del pagamento è in arrivo.
Le commissioni a chi vanno?
Sul contratto PayPal del laboratorio. Il gestionale non intermedia gli incassi.
Cosa succede se non configuro nulla?
Il webhook rifiuta ogni notifica e nessun pagamento PayPal viene registrato automaticamente. Gli altri canali di incasso non sono toccati.
Moduli che la usano
PayPal lavora insieme a questi moduli di LabBox.
Vuoi vedere PayPal collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.