Skip to content
Guida del Centro assistenza · Distribuzione pass
5 min di letturaVerificato 2026-11-16

Vendere pass

Monetizza i pass per portafoglio digitale con il checkout PassFlow, connettendo Stripe, PayPal o Paystack per l'emissione immediata dopo il pagamento.

In questa guida

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.

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
ISCRIZIONE PASS A PAGAMENTO ED EMISSIONE VIA WEBHOOK
FASE 01 BROWSER DEL CLIENTE (PASSFLOW /f/:slug)
1
FormStep: il cliente inserisce nome, e-mail, telefono e attributi custom
2
OtpStep (Opzionale): verifica e-mail o cellulare con codice a 6 cifre
3
PaymentStep: mostra prezzo, riepilogo articolo ed elementi di pagamento
FASE 02 GATEWAY DI PAGAMENTO (STRIPE / PAYPAL / PAYSTACK)
Gestisce autenticazione 3D-Secure 2, Apple Pay, Google Pay o PayPal
Conferma l'addebito ed emette l'evento di cattura
FASE 03 MOTORE WEBHOOK PAGAMENTI ED EMISSIONE PASSINSTANCE
Verifica crittograficamente la firma webhook (Stripe-Signature / PayPal)
Crea in modo idempotente il record Pass nel database (stato ACTIVE)
Inserisce i metadati pagamento (transactionId, amountPaid, currency) nei campi
FASE 04 AGGIUNTA ISTANTANEA AL WALLET (PASSSTEP)
Il cliente aggiunge subito il pass con [Aggiungi ad Apple Wallet] e [Google]

Provider di pagamento e circuiti supportati

Passinstance supporta gateway di pagamento globali e regionali tramite IPublicPassFlowPaymentConfig:

ProviderMetodi supportatiValute supportateIdeale per
StripeCarte di credito/debito, Apple Pay, Google Pay, Addebito diretto SEPA, iDEAL, BancontactOltre 135 valute (EUR, USD, GBP, ecc.)E-commerce globale, mobile wallet e addebiti diretti europei
PayPalSaldo PayPal, carte di credito, Paga in 4 rate, VenmoOltre 25 valute globaliElevata riconoscibilità del brand e checkout PayPal one-click senza attriti
PaystackCarte locali, bonifici bancari, USSD, Apple PayNGN, GHS, ZAR, KESMercati africani e operatività di pagamento panafricana
Mobile MoneyMTN MoMo, Orange Money, M-PesaValute locali mobile africaneIscrizioni 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. 1
    Nella dashboard, vai su Impostazioni -> Integrazioni -> Pagamenti (/settings/integrations/payments).
  2. 2
    Fai clic su Connetti accanto a Stripe, PayPal o Paystack.
  3. 3
    Inserisci le chiavi API di produzione oppure completa la procedura di onboarding OAuth.

Passaggio 2: apri il PassFlow Builder

  1. 1
    Vai su Pass -> PassFlow e seleziona il flusso collegato al tuo modello (oppure creane uno nuovo).
  2. 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. 1
    Compila i dati di un cliente di test.
  2. 2
    Completa un pagamento di prova usando le carte di test del gateway o credenziali PayPal Sandbox.
  3. 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:

MetodoPercorso endpointDescrizione
GET/api/v1/pass-flows/public/:url/payment-configRestituisce la configurazione di pagamento: gateway abilitati, valuta, importo e chiavi API pubbliche.
POST/api/v1/pass-flows/public/:url/payment-intentCrea un PaymentIntent Stripe e restituisce il clientSecret per Stripe Elements.
POST/api/v1/pass-flows/public/:url/paypal-orderCrea un ordine PayPal v2 e restituisce l'URL di approvazione PayPal.
POST/api/v1/pass-flows/public/:url/paystack/initializeInizializza una transazione Paystack e restituisce un URL di autorizzazione.
POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-payInvia una richiesta di pagamento push verso un numero di telefono MTN Mobile Money.

Esempio: inizializzare un Payment Intent Stripe

HTTP
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):

JSON
{
  "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. 1
    Elaborazione automatica del webhook: Passinstance riceve il webhook charge.refunded o PAYMENT.CAPTURE.REFUNDED.
  2. 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.

  1. 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

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.