Monetizzare i pass con il checkout PassFlow
Passinstance consente alle aziende di vendere biglietti digitali per eventi, abbonamenti a pagamento, pass di accesso VIP e gift card digitali direttamente tramite PassFlow (/f/:url). Integrando l'incasso nel flusso di registrazione self-service, puoi accettare pagamenti ed emettere pass Apple Wallet e Google Wallet firmati crittograficamente in un'unica transazione fluida.
Provider di pagamento e circuiti supportati
Passinstance supporta gateway di pagamento globali e regionali tramite IPublicPassFlowPaymentConfig:
| Provider | Metodi supportati | Valute supportate | Ideale per |
|---|---|---|---|
| Stripe | Carte di credito/debito, Apple Pay, Google Pay, Addebito diretto SEPA, iDEAL, Bancontact | Oltre 135 valute (EUR, USD, GBP, ecc.) | E-commerce globale, mobile wallet e addebiti diretti europei |
| PayPal | Saldo PayPal, carte di credito, Paga in 4 rate, Venmo | Oltre 25 valute globali | Elevata riconoscibilità del brand e checkout PayPal one-click senza attriti |
| Paystack | Carte locali, bonifici bancari, USSD, Apple Pay | NGN, GHS, ZAR, KES | Mercati africani e operatività di pagamento panafricana |
| Mobile Money | MTN MoMo, Orange Money, M-Pesa | Valute locali mobile africane | Iscrizioni consumer mobile-first nei mercati emergenti |
Configurazione passo dopo passo: creare un PassFlow a pagamento
Per configurare l'iscrizione a pagamento per qualsiasi modello:
Passaggio 1: collega il tuo gateway di pagamento
Prima di impostare il prezzo del pass, collega il provider di pagamento:
-
1
Nella dashboard, vai su Impostazioni -> Integrazioni -> Pagamenti (
/settings/integrations/payments). -
2
Fai clic su Connetti accanto a Stripe, PayPal o Paystack.
-
3
Inserisci le chiavi API di produzione oppure completa la procedura di onboarding OAuth.
Passaggio 2: apri il PassFlow Builder
-
1
Vai su Pass -> PassFlow e seleziona il flusso collegato al tuo modello (oppure creane uno nuovo).
-
2
Nella sequenza dei passaggi del flusso, assicurati che l'ordine sia il seguente:
- FormStep (Dati del cliente) - EmailStep o OtpStep (Verifica opzionale) - PaymentStep (Raccolta pagamento) - PassStep (Consegna del pass)
Passaggio 3: configura prezzo e valuta del pass
Fai clic sul blocco PaymentStep per configurare le proprietà del checkout:
-
Prezzo (
amount): imposta il prezzo del pass (ad es.25.00). -
Valuta (
currency): seleziona la valuta di regolamento (ad es.EUR,USD). -
Nome e descrizione dell'articolo: inserisci il titolo mostrato ai clienti nella pagina di checkout (ad es. "Abbonamento annuale VIP Lounge 2026").
-
Provider di pagamento: seleziona quali gateway collegati desideri offrire (ad es. abilita sia Stripe sia PayPal).
Passaggio 4: mappa i metadati di pagamento sugli attributi del pass
Puoi associare automaticamente i dettagli di conferma del pagamento ai campi personalizzati del pass:
-
Imposta
{transactionId}per registrare l'ID di riferimento del gateway di pagamento. -
Imposta
{amountPaid}per mostrare il prezzo del biglietto acquistato sui campi del retro del pass. -
Imposta
{paymentDate}per tracciare il timestamp di acquisto.
Passaggio 5: pubblica e testa il flusso
Apri il tuo link pubblico PassFlow (/f/:slug) in una finestra di navigazione in incognito:
-
1
Compila i dati di un cliente di test.
-
2
Completa un pagamento di prova usando le carte di test del gateway o credenziali PayPal Sandbox.
-
3
Verifica che il pass venga generato immediatamente nella schermata
PassStep.
Endpoint REST API pubblici per il checkout
Se stai integrando l'acquisto dei pass direttamente nella tua app mobile, nel tuo sito web o in un frontend React personalizzato, puoi interagire direttamente con gli endpoint pubblici di pagamento di PassFlow:
| Metodo | Percorso endpoint | Descrizione |
|---|---|---|
| GET | /api/v1/pass-flows/public/:url/payment-config | Restituisce la configurazione di pagamento: gateway abilitati, valuta, importo e chiavi API pubbliche. |
| POST | /api/v1/pass-flows/public/:url/payment-intent | Crea un PaymentIntent Stripe e restituisce il clientSecret per Stripe Elements. |
| POST | /api/v1/pass-flows/public/:url/paypal-order | Crea un ordine PayPal v2 e restituisce l'URL di approvazione PayPal. |
| POST | /api/v1/pass-flows/public/:url/paystack/initialize | Inizializza una transazione Paystack e restituisce un URL di autorizzazione. |
| POST | /api/v1/pass-flows/public/:url/mtn-momo/request-to-pay | Invia una richiesta di pagamento push verso un numero di telefono MTN Mobile Money. |
Esempio: inizializzare un Payment Intent Stripe
POST /api/v1/pass-flows/public/vip-membership-2026/payment-intent HTTP/1.1
Host: api.passinstance.com
Content-Type: application/json
{
"email": "customer@example.com",
"name": "Jordan Lee",
"attributes": {
"tier": "Gold VIP",
"seatNumber": "Row A, Seat 12"
}
}
Risposta (200 OK):
{
"clientSecret": "pi_3Q9xZ2eZvKYlo2C11223344_secret_R1a2B3c4D5e6F7g8",
"publishableKey": "pk_live_51H...",
"amount": 4900,
"currency": "EUR",
"flowSessionId": "flow_sess_01j9x87k1"
}
Gestione di rimborsi, contestazioni e revoca dei pass
Quando un cliente richiede un rimborso o apre una contestazione tramite Stripe o PayPal:
-
1
Elaborazione automatica del webhook: Passinstance riceve il webhook
charge.refundedoPAYMENT.CAPTURE.REFUNDED. -
2
Opzione di revoca del pass: in Impostazioni workspace -> Pagamenti, puoi configurare la policy automatica per i rimborsi:
- Annullamento automatico del pass (Consigliato): imposta pass.voided = true. Apple Wallet sovrappone immediatamente un banner "Annullato" sul pass e barra il codice a barre. Google Wallet contrassegna il pass come inattivo. I dispositivi scanner rifiutano i successivi tentativi di check-in. - Mantieni il pass attivo: lascia il pass attivo e registra un record di audit per la revisione manuale da parte dello staff.
-
3
Notifica push di avviso: in caso di annullamento, Passinstance invia una notifica push APNs e Google Wallet per informare il titolare che la sua credenziale è stata revocata in seguito al rimborso.
Documentazione correlata
-
Vendere abbonamenti — Abbonamenti ricorrenti e sincronizzazione automatica dei rinnovi.
-
Richiedere una firma API PayPal — Collegamento delle credenziali OAuth REST di PayPal.
-
Distribuzione self-service — PassFlow, smart link e iscrizione tramite NFC.
-
Moduli di registrazione e PassFlow — Configurazione dei passaggi, protezione anti-bot e validazione dei moduli.
