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.
Supported Payment Providers & Rails
Passinstance supports global and regional payment gateways via IPublicPassFlowPaymentConfig:
| Provider | Supported Methods | Supported Currencies | Best For |
|---|---|---|---|
| Stripe | Credit/Debit Cards, Apple Pay, Google Pay, SEPA Direct Debit, iDEAL, Bancontact | 135+ currencies (EUR, USD, GBP, etc.) | Global e-commerce, mobile wallets, and European direct debits |
| PayPal | PayPal Balance, Credit Cards, Pay in 4, Venmo | 25+ global currencies | High brand recognition and frictionless one-click PayPal checkout |
| Paystack | Local Cards, Bank Transfers, USSD, Apple Pay | NGN, GHS, ZAR, KES | African markets and pan-African payment operations |
| Mobile Money | MTN MoMo, Orange Money, M-Pesa | Local African mobile currencies | Emerging-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
In the dashboard, go to Settings -> Integrations -> Payments (
/settings/integrations/payments). -
2
Click Connect on Stripe, PayPal, or Paystack.
-
3
Provide your production API keys or complete the OAuth onboarding flow.
Step 2: Open the PassFlow Builder
-
1
Navigate to Passes -> PassFlows and select the flow linked to your template (or create a new flow).
-
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
Fill in test customer details.
-
2
Complete test payment using gateway test cards or Sandbox PayPal credentials.
-
3
Verify that the pass is minted immediately on the
PassStepscreen.
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:
| Method | Endpoint Path | Description |
|---|---|---|
| GET | /api/v1/pass-flows/public/:url/payment-config | Returns the payment configuration: enabled gateways, currency, price amount, and public API keys. |
| POST | /api/v1/pass-flows/public/:url/payment-intent | Creates a Stripe PaymentIntent and returns clientSecret for Stripe Elements. |
| POST | /api/v1/pass-flows/public/:url/paypal-order | Creates a PayPal v2 Order and returns the PayPal approval URL. |
| POST | /api/v1/pass-flows/public/:url/paystack/initialize | Initializes a Paystack transaction and returns an authorization URL. |
| POST | /api/v1/pass-flows/public/:url/mtn-momo/request-to-pay | Triggers a push payment request to an MTN Mobile Money phone number. |
Example: Initializing Stripe Payment Intent
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):
{
"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
Automatic Webhook Processing: Passinstance receives the
charge.refundedorPAYMENT.CAPTURE.REFUNDEDwebhook. -
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.
-
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 Documentation
-
Selling Subscriptions — Recurring memberships and automated billing renewal sync.
-
Requesting a PayPal API Signature — Connecting PayPal REST OAuth credentials.
-
Self-Service Distribution — PassFlows, smart links, and NFC enrollment.
-
Registration Forms & PassFlow — Step configurations, bot protection, and form validation.
