Skip to content
Hilfecenter-Anleitung · Pass-Ausgabe
3 Min. LesezeitGeprüft 2026-11-16

Registrierungsformulare & PassFlow

Konfigurieren Sie PassFlow-Schritte (Formularfelder, E-Mail-Erfassung, optionale OTP-Verifizierung) für automatisiertes Onboarding.

In dieser Anleitung

Überblick

PassFlow (PassFlow API unter /api/v1/pass-flows, Alias /api/v1/passflows) ist die gehostete, Whitelabel-fähige Self-Service-Registrierungs- und Checkout-Engine von Passinstance (PassFlowType: REGISTRATION, CHECKOUT, RECHARGE, CLAIM, UPDATE, REDEMPTION, CUSTOM; PassFlowStatus: DRAFT, PUBLISHED, PAUSED, ARCHIVED). Kundinnen und Kunden rufen /f/:url auf, durchlaufen konfigurierbare Eingabeschritte — darunter eigene Formularfelder, Bot-Schutz (SpamProtectionMode: NONE, RECAPTCHA), E-Mail-/SMS-OTP-Verifizierung sowie optional einen Bezahl-Checkout — und installieren ihren Apple-Wallet- oder Google-Wallet-Pass sofort.

Systemarchitektur: PassFlow-Pipeline & Zahlungs-Gateways

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
PASSFLOW-REGISTRIERUNG, OTP & PAYMENT-ENGINE
STUFE 01 ÖFFENTLICHER PASSFLOW-CLIENT (/f/:url)
1
FormStep
Custom Props
& Validierung
2
EmailStep
Identität &
DSGVO-Einwill
3
OtpStep
6-stelliger
SMS/Mail-Code
4
PaymentStep (Optional kosten- pflichtiger Pass)
5
PassStep
Apple .pkpass &
Google Save JWT
STUFE 02 PASSFLOW-BACKEND & PAYMENT-GATEWAY-ORCHESTRIERUNG
Pass erzeugen: POST/api/v1/pass-flows/public/:url/generate
OTP senden/prüf: 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-Schritte & Einreichungs-Zustandsautomat

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

Öffentlicher Schritt (stepFlow.ts)PhasennameAusführungsverhalten & Validierungsregeln
1. FormStepKunden-RegistrierungsformularRendert sichtbare Vorlageneigenschaften mit Pflichtfeld-/Regex-Validierung und DSGVO-Einwilligungs-Checkboxen. Ruft vor POST /api/v1/pass-flows/public/:url/generate (userData, recaptchaToken?) den Endpunkt GET /api/v1/pass-flows/public/:url/csrf-token auf.
2. EmailStepKontakt & DeduplizierungErfasst/bestätigt die primäre E-Mail-Adresse oder Telefonnummer und prüft externalId- / Deduplizierungseinstellungen.
3. OtpStepEinmalpasswort-Verifizierung(Optional) Versendet und verifiziert ein zeitlich begrenztes OTP über POST /api/v1/pass-flows/public/:url/otp/send, /otp/resend und /otp/verify.
4. PaymentStepIntegrierter Payment-Checkout(Optional) Lädt GET /api/v1/pass-flows/public/:url/payment-config und zieht Zahlungen über Stripe, PayPal, Paystack, MTN Mobile Money oder Orange Money ein.
5. PassStepSofortige Wallet-AuslieferungZeigt Schaltflächen für Zu Apple Wallet hinzufügen / Zu Google Wallet hinzufügen, QR-Übergabe sowie geführte PassTour-Overlays.

Wichtig: Einreichungen verfolgen den Status PassFlowSubmissionStatus (STARTED, SUBMITTED, AWAITING_PAYMENT, PAYMENT_PENDING, PROCESSING, COMPLETED, FAILED, REJECTED, EXPIRED, CANCELLED). Ist OTP oder eine Zahlung aktiviert, erfolgt die Aktivierung des Wallet-Passes erst nach erfolgreicher Verifizierung.

Eingebettete Zahlungs-Gateways für kostenpflichtige Pässe

PassFlow unterstützt fünf regionale und globale Zahlungsanbieter mit eigenen öffentlichen Initialisierungs- und Webhook-Endpunkten:

ZahlungsanbieterÖffentlicher Initialisierungs-EndpunktUnterstützte Zahlungsmethoden & Regionen
StripePOST /api/v1/pass-flows/public/:url/payment-intentKredit-/Debitkarten, Apple Pay, Google Pay, SEPA, Klarna (Global)
PayPalPOST /api/v1/pass-flows/public/:url/paypal-orderPayPal Wallet, Später bezahlen, Venmo (Global)
PaystackPOST /api/v1/pass-flows/public/:url/paystack/initializeKarten, Banküberweisung, USSD, Mobile Money (Nigeria, Ghana, Kenia, Südafrika)
MTN Mobile MoneyPOST /api/v1/pass-flows/public/:url/mtn-momo/request-to-payPush-USSD-Freigabe über Mobile Wallet (West- & Zentralafrika)
Orange MoneyPOST /api/v1/pass-flows/public/:url/orange-money/initiateOrange-Money-Web-/Mobile-OTP-Checkout (Frankophones Afrika & Europa)

Beispiel: Stripe Payment Intent in PassFlow initialisieren

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

HTTP-Antwort (201 Created)

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

Beispiel: MTN-MoMo-Zahlungsaufforderung (Request-to-Pay) starten

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

PassFlows im Dashboard & per API verwalten

Konfigurieren Sie gehostete PassFlows im Dashboard unter Verteilung -> PassFlows (/pass-flows) oder verwalten Sie sie programmatisch über /api/v1/pass-flows:

  • GET /api/v1/pass-flows: Listet alle konfigurierten PassFlows im aktiven Workspace auf.
  • POST /api/v1/pass-flows: Erstellt einen neuen PassFlow für eine veröffentlichte templateId inklusive eigenem url-Slug, PassFlowType, OTP-Regeln und Zahlungskonfiguration.
  • PATCH /api/v1/pass-flows/:id: Aktualisiert Sichtbarkeit von Formularfeldern, OTP-Anforderungen oder Zahlungs-Gateway-Einstellungen.

Erfahren Sie mehr über öffentliche Distributionskanäle in Self-Service-Verteilung und Download-Links & PassFlow.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.