Skip to content
Help Center Guide · Pass Distribution
4 min readVerified 2026-11-16

Selling Passes

Monetize digital wallet passes with PassFlow checkout, connecting Stripe, PayPal, or Paystack for instant pass issuance upon payment.

In This Guide

Monetizing Passes with PassFlow Checkout

Passinstance enables businesses to sell digital event tickets, paid membership credentials, VIP access passes, and digital gift cards directly through PassFlows (/f/:url). By embedding payment collection into the self-service enrollment flow, you can accept payments and issue cryptographically signed Apple Wallet and Google Wallet passes in a single frictionless transaction.

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
PAID PASS ENROLLMENT & WEBHOOK ISSUANCE
STAGE 01 CUSTOMER BROWSER (PASSFLOW /f/:slug)
1
FormStep: Customer enters name, email, phone, and custom attributes
2
OtpStep (Optional): Verifies email or mobile phone with 6-digit code
3
PaymentStep: Renders price, item summary, and embedded payment elements
STAGE 02 PAYMENT GATEWAY (STRIPE / PAYPAL / PAYSTACK)
Processes 3D-Secure 2 card authentication, Apple Pay, Google Pay, or PayPal
Confirms charge and issues capture event
STAGE 03 PASSINSTANCE PAYMENT WEBHOOK & ISSUANCE ENGINE
Cryptographically verifies webhook signature (Stripe-Signature / PayPal)
Idempotently creates Pass record in database (status ACTIVE)
Injects payment metadata (transactionId, amountPaid, currency) into attributes
STAGE 04 INSTANT WALLET ADDITION (PASSSTEP)
Customer adds pass immediately via [Add to Apple Wallet] and [Save to Google]

Supported Payment Providers & Rails

Passinstance supports global and regional payment gateways via IPublicPassFlowPaymentConfig:

ProviderSupported MethodsSupported CurrenciesBest For
StripeCredit/Debit Cards, Apple Pay, Google Pay, SEPA Direct Debit, iDEAL, Bancontact135+ currencies (EUR, USD, GBP, etc.)Global e-commerce, mobile wallets, and European direct debits
PayPalPayPal Balance, Credit Cards, Pay in 4, Venmo25+ global currenciesHigh brand recognition and frictionless one-click PayPal checkout
PaystackLocal Cards, Bank Transfers, USSD, Apple PayNGN, GHS, ZAR, KESAfrican markets and pan-African payment operations
Mobile MoneyMTN MoMo, Orange Money, M-PesaLocal African mobile currenciesEmerging-market mobile-first consumer enrollment

Step-by-Step Setup: Creating a Paid PassFlow

To configure paid pass enrollment for any template:

Step 1: Connect Your Payment Gateway

Before configuring pass pricing, connect your payment provider:

  1. 1
    In the dashboard, go to Settings -> Integrations -> Payments (/settings/integrations/payments).
  2. 2
    Click Connect on Stripe, PayPal, or Paystack.
  3. 3
    Provide your production API keys or complete the OAuth onboarding flow.

Step 2: Open the PassFlow Builder

  1. 1
    Navigate to Passes -> PassFlows and select the flow linked to your template (or create a new flow).
  2. 2
    In the flow step sequence, ensure the following order:

- FormStep (Customer Details) - EmailStep or OtpStep (Optional verification) - PaymentStep (Payment Collection) - PassStep (Pass Delivery)

Step 3: Configure Pass Pricing & Currency

Click on the PaymentStep block to configure checkout properties:

  • Price (amount): Set the pass price (e.g. 25.00).
  • Currency (currency): Select your settlement currency (e.g. EUR, USD).
  • Item Name & Description: Enter the title displayed to customers on the checkout page (e.g. "Annual VIP Lounge Membership 2026").
  • Payment Providers: Check which connected gateways you want to offer (e.g. enable both Stripe and PayPal).

Step 4: Map Payment Metadata to Pass Attributes

You can automatically bind payment confirmation details to custom pass fields:

  • Set {transactionId} to capture the payment gateway reference ID.
  • Set {amountPaid} to display the purchased ticket price on the pass back fields.
  • Set {paymentDate} to track the purchase timestamp.

Step 5: Publish & Test Your Flow

Open your public PassFlow link (/f/:slug) in an incognito window:

  1. 1
    Fill in test customer details.
  2. 2
    Complete test payment using gateway test cards or Sandbox PayPal credentials.
  3. 3
    Verify that the pass is minted immediately on the PassStep screen.

Public Checkout REST API Endpoints

If you are embedding pass purchasing inside your own custom mobile app, website, or React frontend, you can interact with the public PassFlow payment endpoints directly:

MethodEndpoint PathDescription
GET/api/v1/pass-flows/public/:url/payment-configReturns the payment configuration: enabled gateways, currency, price amount, and public API keys.
POST/api/v1/pass-flows/public/:url/payment-intentCreates a Stripe PaymentIntent and returns clientSecret for Stripe Elements.
POST/api/v1/pass-flows/public/:url/paypal-orderCreates a PayPal v2 Order and returns the PayPal approval URL.
POST/api/v1/pass-flows/public/:url/paystack/initializeInitializes a Paystack transaction and returns an authorization URL.
POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-payTriggers a push payment request to an MTN Mobile Money phone number.

Example: Initializing Stripe Payment Intent

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"
  }
}

Response (200 OK):

JSON
{
  "clientSecret": "pi_3Q9xZ2eZvKYlo2C11223344_secret_R1a2B3c4D5e6F7g8",
  "publishableKey": "pk_live_51H...",
  "amount": 4900,
  "currency": "EUR",
  "flowSessionId": "flow_sess_01j9x87k1"
}

Handling Refunds, Disputes & Pass Revocation

When a customer requests a refund or disputes a charge through Stripe or PayPal:

  1. 1
    Automatic Webhook Processing: Passinstance receives the charge.refunded or PAYMENT.CAPTURE.REFUNDED webhook.
  2. 2
    Pass Revocation Option: In Workspace Settings -> Payments, you can configure the automated refund policy:

- Auto-Void Pass (Recommended): Sets pass.voided = true. Apple Wallet immediately places a "Voided" banner across the pass and crosses out the barcode. Google Wallet marks the pass as inactive. Scanner devices reject future check-in attempts. - Retain Pass: Leaves the pass active and logs an audit record for manual staff review.

  1. 3
    Push Notification Alert: When voided, Passinstance sends an APNs and Google Wallet push notification informing the holder that their credential has been revoked due to refund.

Related Product & Developer Documentation

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.