Skip to content
Helpcentrum-gids · Pass-uitgifte
3 min leestijdGecontroleerd 2026-11-16

Registratieformulieren & PassFlow

Stel PassFlow-stappen in (formuliervelden, e-mailinvoer, optionele OTP-verificatie) voor zelfregistratie.

In deze gids

Overzicht

PassFlow (PassFlow API op /api/v1/pass-flows, alias /api/v1/passflows) is Passinstance' gehoste, white-label selfservice-inschrijf- en check-outengine (PassFlowType: REGISTRATION, CHECKOUT, RECHARGE, CLAIM, UPDATE, REDEMPTION, CUSTOM; PassFlowStatus: DRAFT, PUBLISHED, PAUSED, ARCHIVED). Klanten bezoeken /f/:url, doorlopen instelbare intakestappen—waaronder aangepaste formuliervelden, botbescherming (SpamProtectionMode: NONE, RECAPTCHA), e-mail-/sms-OTP-verificatie en optioneel afrekenen—en installeren direct hun Apple Wallet- of Google Wallet-pas.

Systeemarchitectuur: PassFlow-pipeline & betaalgateways

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
PASSFLOW-INSCHRIJVING, OTP & BETAALENGINE
FASE 01 OPENBARE PASSFLOW-CLIENT (/f/:url)
1
FormStep
Aangepaste eigensch.&val
2
EmailStep
Identiteit &
AVG-toest.
3
OtpStep
6-cijferige sms/e-mail
4
PaymentStep (Optionele betaalde pas-checkout)
5
PassStep
Apple .pkpass &
Google Save JWT
FASE 02 PASSFLOW-BACKEND & BETAALGATEWAY-ORKESTRATOR
Pas genereren: POST/api/v1/pass-flows/public/:url/generate
OTP sturen/check: POST.../otp/send, POST.../otp/resend, POST.../otp/verify
Stripe: POST/api/v1/pass-flows/public/:url/payment-intent
PayPal: POST/api/v1/pass-flows/public/:url/paypal-order
Paystack: POST/api/v1/pass-flows/public/:url/paystack/initialize
MTN MoMo: POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-pay
Orange Money: POST/api/v1/pass-flows/public/:url/orange-money/initiate

PassFlow-stappen & toestandsmachine voor inzendingen

In Passinstance Dashboard en PassFlow API (PassFlowStepType: INTRODUCTION, FORM, PASS_LOOKUP, AUTHENTICATION, PRODUCT_SELECTION, PAYMENT, REVIEW, PROCESSING, CONFIRMATION, PASS_DELIVERY, ERROR, CUSTOM):

Openbare stap (stepFlow.ts)FasenaamUitvoeringsgedrag & validatieregels
1. FormStepKlantregistratieformulierToont zichtbare sjablooneigenschappen met verplichte/regex-validatie en AVG-toestemmingsvakjes. Roept GET /api/v1/pass-flows/public/:url/csrf-token aan alvorens POST /api/v1/pass-flows/public/:url/generate (userData, recaptchaToken?) in te dienen.
2. EmailStepContact & ontdubbelingVraagt/bevestigt het primaire e-mailadres of telefoonnummer en handhaaft externalId- / ontdubbelingsinstellingen.
3. OtpStepVerificatie met eenmalige code(Optioneel) Verstuurt/verifieert een tijdelijke OTP-code via POST /api/v1/pass-flows/public/:url/otp/send, /otp/resend en /otp/verify.
4. PaymentStepGeïntegreerde betaalcheckout(Optioneel) Leest GET /api/v1/pass-flows/public/:url/payment-config uit en int de betaling via Stripe, PayPal, Paystack, MTN Mobile Money of Orange Money.
5. PassStepDirecte wallet-leveringToont knoppen voor Toevoegen aan Apple Wallet / Toevoegen aan Google Wallet, QR-overdracht en Begeleide PassTour-overlays.

Belangrijk: Inzendingen volgen PassFlowSubmissionStatus (STARTED, SUBMITTED, AWAITING_PAYMENT, PAYMENT_PENDING, PROCESSING, COMPLETED, FAILED, REJECTED, EXPIRED, CANCELLED). Wanneer OTP of betaling is ingeschakeld, vindt activering van de wallet-pas pas plaats nadat de verificatie succesvol is afgerond.

Geïntegreerde betaalgateways voor betaalde passen

PassFlow ondersteunt vijf regionale en wereldwijde betaalverwerkers met specifieke openbare initialisatie- en webhook-endpoints:

BetaalproviderOpenbaar initialisatie-endpointOndersteunde betaalmethoden & regio's
StripePOST /api/v1/pass-flows/public/:url/payment-intentCredit-/debitcards, Apple Pay, Google Pay, SEPA, Klarna (Wereldwijd)
PayPalPOST /api/v1/pass-flows/public/:url/paypal-orderPayPal Wallet, Pay Later, Venmo (Wereldwijd)
PaystackPOST /api/v1/pass-flows/public/:url/paystack/initializeKaarten, bankoverschrijving, USSD, Mobile Money (Nigeria, Ghana, Kenia, Zuid-Afrika)
MTN Mobile MoneyPOST /api/v1/pass-flows/public/:url/mtn-momo/request-to-payPush USSD mobiele wallet-goedkeuring (West- & Centraal-Afrika)
Orange MoneyPOST /api/v1/pass-flows/public/:url/orange-money/initiateOrange Money web-/mobiele OTP-checkout (Franstalig Afrika & Europa)

Voorbeeld: een Stripe Payment Intent initialiseren in PassFlow

POST /api/v1/pass-flows/public/summer-vip-festival/payment-intent
Headers
Content-Type application/json
JSON
{
  "email": "claire.dubois@example.com",
  "userData": {
    "firstName": "Claire",
    "lastName": "Dubois",
    "ticketTier": "VIP All-Access"
  }
}

HTTP-respons (201 Created)

JSON
{
  "success": true,
  "data": {
    "clientSecret": "pi_3Q9xYz2eZvKYlo2C1a2b3c4d_secret_9f8e7d6c5b4a",
    "paymentIntentId": "pi_3Q9xYz2eZvKYlo2C1a2b3c4d"
  },
  "statusCode": 201
}

Voorbeeld: een MTN MoMo Request-to-Pay starten

POST /api/v1/pass-flows/public/accra-vip-lounge/mtn-momo/request-to-pay
Headers
Content-Type application/json
JSON
{
  "phoneNumber": "+233241234567",
  "amount": 150,
  "currency": "GHS"
}

PassFlows beheren in het dashboard & via de API

Configureer gehoste PassFlows in het Dashboard onder Distributie -> Pass Flows (/pass-flows), of beheer ze programmatisch via /api/v1/pass-flows:

  • GET /api/v1/pass-flows: Geeft een lijst van alle geconfigureerde PassFlows in de actieve workspace.
  • POST /api/v1/pass-flows: Maakt een nieuwe PassFlow aan die is gekoppeld aan een gepubliceerde templateId, inclusief een eigen url-slug, PassFlowType, OTP-instellingen en betaalconfiguratie.
  • PATCH /api/v1/pass-flows/:id: Werkt zichtbaarheid van formuliervelden, OTP-vereisten of betaalgatewayconfiguratie bij.

Lees meer over openbare distributiekanalen in Selfservice-distributie en Downloadlinks & PassFlow.

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.