Configura Stripe
Come creare un account Stripe, impostare i prodotti con i prezzi giusti, ottenere i Price ID e configurare il webhook per ricevere le notifiche di pagamento.
Crea un account Stripe
Vai su stripe.com → e clicca Start now.
Inserisci email, nome e password. Dovrai verificare l'email prima di poter usare l'account.
Completa il processo di verifica dell'identità per attivare i pagamenti reali (non necessario in modalità test).
Se hai già un account Stripe puoi saltare questo step.
Crea un prodotto
Nel dashboard Stripe vai su Product catalog → Add product.
Compila i campi:
- Name: il nome del ruolo (es. "Membro VIP")
- Description: opzionale, appare nella ricevuta
- Pricing model: scegli Recurring per abbonamento o One time per pagamento singolo
- Price: inserisci l'importo in euro
- Billing period (solo recurring): Monthly
Clicca Save product.
Puoi creare un prodotto per ogni ruolo o accesso che vuoi vendere. Il nome del prodotto è quello che appare nella ricevuta Stripe dell'utente.
Copia il Price ID
Dopo aver salvato il prodotto, nella pagina del prodotto trovi la sezione Pricing.
Copia l'ID del prezzo — sarà nel formato:
Questo è il valore da inserire nel campo Stripe Price ID durante il setup del prodotto su NexusPass.
Il Price ID inizia sempre con 'price_'. Non confonderlo con il Product ID che inizia con 'prod_'.
Configura il webhook
Vai su Developers → Webhooks → Add endpoint.
Inserisci l'URL del webhook di NexusPass:
Clicca su Select events e spunta questi eventi:
- checkout.session.completed
- invoice.paid
- customer.subscription.deleted
- invoice.payment_failed
Clicca Add endpoint.
Il webhook è il meccanismo con cui Stripe avvisa NexusPass quando un pagamento va a buon fine. Senza di esso i ruoli non vengono assegnati automaticamente.
Copia il Signing Secret
Dopo aver creato il webhook, clicca sull'endpoint appena creato.
Nella sezione Signing secret clicca su Reveal e copia il valore.
Il formato è:
Incolla questo valore nel campo Stripe Webhook Secret nelle impostazioni del server su NexusPass.
Il Signing Secret appare una sola volta dopo la creazione del webhook. Se lo perdi dovrai rigenerarlo.
Testa il pagamento
Usa queste carte in modalità test:
4242 4242 4242 4242✅ Pagamento riuscito4000 0000 0000 0002❌ Carta rifiutata4000 0025 0000 3155🔐 Richiede 3D Secure4000 0000 0000 9995❌ Fondi insufficientiPer tutte le carte di test usa: scadenza 12/34, CVC 123, nome qualsiasi.
Stripe fornisce carte di test che puoi usare senza addebitare soldi reali.
✓ Hai completato questo step! Ora hai:
- Account Stripe configurato
- Prodotti con Price ID
- Webhook configurato e attivo
- Signing Secret copiato