Satispay
Oggi l’integrazione Satispay copre la ricezione delle notifiche: quando un pagamento viene accettato o annullato, il gestionale aggiorna incasso e appuntamento. L’avvio del pagamento dal gestionale è in arrivo. Le chiavi del negozio Satispay 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
- Negozio Satispay Business intestato al laboratorio
- Endpoint pubblico HTTPS esposto sull’indirizzo esatto atteso dalla firma
- Accesso al pannello Satispay Business per configurare la notifica
Come funziona oggi
Satispay notifica al gestionale il cambio di stato di un pagamento del tuo negozio.
La notifica è firmata: il gestionale ricalcola l’impronta del corpo e verifica la firma con la chiave pubblica Satispay prima di leggere qualunque dato.
Uno stato accettato chiude il pagamento e conferma l’appuntamento collegato; uno stato annullato riporta indietro entrambi. Lo stesso evento non viene applicato due volte.
Cosa è in arrivo
La creazione del pagamento dal gestionale, con QR o codice da mostrare al paziente, non fa ancora parte della configurazione supportata.
Per ora il pagamento si avvia dagli strumenti Satispay del laboratorio e il gestionale ne recepisce l’esito.
Limiti
Senza la chiave pubblica configurata il webhook risponde con un errore di configurazione e nessuna notifica viene applicata.
L’indirizzo del webhook deve corrispondere esattamente a quello atteso: un proxy che cambia il percorso fa fallire la verifica della firma.
Rimborsi e stati intermedi non gestiti vengono registrati ma non modificano da soli il ciclo attivo.
Come si attiva
Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.
Per il tecnico
- `SATISPAY_PUBLIC_KEY` — chiave pubblica usata per verificare la firma delle notifiche
- Attiva il negozio Satispay Business a nome del laboratorio.
- Recupera la chiave pubblica da usare per la verifica e mettila in `SATISPAY_PUBLIC_KEY`.
- Configura la notifica verso `/api/webhooks/satispay` del tuo dominio, senza prefissi di percorso aggiuntivi.
- Esegui un pagamento di prova di importo minimo e controlla che l’appuntamento passi a confermato.
Domande frequenti
Posso già generare il QR di pagamento dal gestionale?
Non ancora. Oggi è supportata la ricezione delle notifiche; l’avvio del pagamento è in arrivo.
Chi paga le commissioni?
Il laboratorio, sul proprio contratto Satispay.
Se non la configuro cosa cambia?
Le notifiche vengono rifiutate e i pagamenti Satispay vanno registrati a mano. Nessun altro canale viene toccato.
Moduli che la usano
Satispay lavora insieme a questi moduli di LabBox.
Vuoi vedere Satispay collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.