Stripe
Stripe incassa online con carta: prenotazioni pagate in anticipo, link di pagamento inviati per email, piani rateali e abbonamenti. L’account Stripe è del laboratorio e gli incassi arrivano sul tuo conto. Serve quando vuoi ridurre le code in cassa e gli insoluti.
Chiave del laboratorioCosa fa
Carte, abbonamenti e Stripe Connect.
Categoria: pagamenti — Incassi online e in cassa, ricevute e registratore telematico.
Cosa serve
- Account Stripe intestato al laboratorio, con verifica identità completata
Come funziona
Il gestionale crea lato server l’intento di pagamento con la chiave segreta del laboratorio. Il browser mostra il modulo carta ufficiale di Stripe.
I dati della carta vengono raccolti da Stripe dentro il suo componente: il gestionale riceve solo un riferimento al metodo di pagamento, mai il numero della carta.
Un webhook firmato comunica l’esito. Solo a quel punto la fattura, la prenotazione o il link di pagamento vengono segnati come pagati.
Con Stripe Connect è possibile girare una quota a una struttura collegata, con la percentuale definita nella configurazione.
Cosa ottieni
Pagamento anticipato della prenotazione, con riduzione dei mancati accessi.
Link di pagamento tracciabili allegati alla fattura, senza bonifici da riconciliare a mano.
Rateizzazioni e abbonamenti gestiti con rinnovo automatico e stato sempre allineato.
Limiti
Senza `STRIPE_WEBHOOK_SECRET` nessun pagamento viene mai marcato come incassato, anche se il cliente ha pagato: la firma è l’unica prova accettata.
Senza chiave segreta il modulo di pagamento non viene nemmeno mostrato e al paziente compaiono le istruzioni di contatto del laboratorio.
Le commissioni Stripe sono a carico del laboratorio e seguono il listino del tuo account.
Come si attiva
Se ne occupa chi installa LabBox: il vostro tecnico informatico oppure noi.
Per il tecnico
- `STRIPE_SECRET_KEY` — chiave segreta, solo lato server
- `NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY` — chiave pubblicabile per il modulo carta
- `STRIPE_WEBHOOK_SECRET` — segreto di firma dell’endpoint webhook; senza di esso nessun incasso viene registrato
- `STRIPE_CONNECT_CLIENT_ID` — solo se usi Stripe Connect verso strutture collegate
- `NEXT_PUBLIC_SITE_URL` corretto, perché genera gli URL di ritorno dopo il pagamento
- Completa l’onboarding del tuo account Stripe e attiva la modalità live.
- Copia chiave segreta e chiave pubblicabile nelle rispettive variabili.
- In Stripe crea l’endpoint webhook verso `/api/stripe/webhook` del tuo dominio.
- Incolla il segreto di firma dell’endpoint in `STRIPE_WEBHOOK_SECRET`.
- Se usi Connect, valorizza `STRIPE_CONNECT_CLIENT_ID` e completa il collegamento OAuth dalla schermata dedicata.
- Esegui un pagamento di prova e verifica che la fattura passi a “pagata” dopo il webhook.
Domande frequenti
Le commissioni le paga il fornitore del software?
No. L’account Stripe è del laboratorio e le commissioni seguono il tuo contratto. Il gestionale non trattiene nulla sugli incassi.
Il software tratta i numeri di carta?
No. La carta viene inserita nel componente di Stripe e il gestionale riceve solo un riferimento al metodo di pagamento.
Cosa succede se dimentico il segreto del webhook?
I pagamenti vanno a buon fine su Stripe ma restano “non pagati” nel gestionale. È la scelta voluta: nessuno stato di incasso senza prova firmata.
Moduli che la usano
Stripe lavora insieme a questi moduli di LabBox.
Vuoi vedere Stripe collegato al tuo laboratorio?
Entra nella demo con dati di esempio, senza registrarti.