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

Karten verkaufen

Monetarisieren Sie digitale Wallet-Pässe mit PassFlow Checkout und verbinden Sie Stripe, PayPal oder Paystack für die sofortige Kartenausstellung nach Zahlung.

In dieser Anleitung

Pässe mit dem PassFlow-Checkout monetarisieren

Mit Passinstance können Unternehmen digitale Event-Tickets, kostenpflichtige Mitgliedsausweise, VIP-Zugangspässe und digitale Geschenkkarten direkt über PassFlows (/f/:url) verkaufen. Durch die Integration der Zahlungsabwicklung in den Self-Service-Registrierungsprozess akzeptieren Sie Zahlungen und geben kryptografisch signierte Apple-Wallet- und Google-Wallet-Pässe in einer einzigen reibungslosen Transaktion aus.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
KOSTENPFLICHTIGE PASS-REGISTRIERUNG & WEBHOOK-AUSGABE
STUFE 01 KUNDEN-BROWSER (PASSFLOW /f/:slug)
1
FormStep: Kundin/Kunde gibt Name, E-Mail, Telefon & eigene Attribute ein
2
OtpStep (Optional): Verifiziert E-Mail oder Handynummer per 6-stelligem Code
3
PaymentStep: Zeigt Preis, Artikelübersicht & eingebettete Zahlungselemente
STUFE 02 ZAHLUNGSGATEWAY (STRIPE / PAYPAL / PAYSTACK)
Verarbeitet 3D-Secure-2-Kartenprüfung, Apple Pay, Google Pay oder PayPal
Bestätigt Belastung und sendet Zahlungseinzug-Ereignis
STUFE 03 PASSINSTANCE-ZAHLUNGS-WEBHOOK & AUSGABE-ENGINE
Verifiziert Webhook-Signatur kryptografisch (Stripe-Signature / PayPal)
Erstellt idempotent den Pass-Datensatz in der Datenbank (Status ACTIVE)
Übernimmt Zahlungs-Metadaten (transactionId, amountPaid, currency) in Attribute
STUFE 04 SOFORTIGES WALLET-HINZUFÜGEN (PASSSTEP)
Kundin/Kunde fügt Pass sofort hinzu via [Zu Apple Wallet] & [In Google Wallet]

Unterstützte Zahlungsanbieter & Zahlungswege

Passinstance unterstützt globale und regionale Zahlungsgateways über IPublicPassFlowPaymentConfig:

AnbieterUnterstützte ZahlungsmethodenUnterstützte WährungenIdeal geeignet für
StripeKredit-/Debitkarten, Apple Pay, Google Pay, SEPA-Lastschrift, iDEAL, Bancontact135+ Währungen (EUR, USD, GBP usw.)Globalen E-Commerce, Mobile Wallets und europäische Lastschriften
PayPalPayPal-Guthaben, Kreditkarten, Pay in 4, Venmo25+ globale WährungenHohe Markenbekanntheit und reibungslosen Ein-Klick-PayPal-Checkout
PaystackLokale Karten, Banküberweisungen, USSD, Apple PayNGN, GHS, ZAR, KESAfrikanische Märkte und panafrikanischen Zahlungsverkehr
Mobile MoneyMTN MoMo, Orange Money, M-PesaLokale afrikanische MobilwährungenMobile-First-Kundenregistrierung in Wachstumsmärkten

Schritt-für-Schritt-Einrichtung: Kostenpflichtigen PassFlow erstellen

So konfigurieren Sie eine kostenpflichtige Pass-Registrierung für eine beliebige Vorlage:

Schritt 1: Zahlungsgateway verbinden

Verbinden Sie Ihren Zahlungsanbieter, bevor Sie die Pass-Preise festlegen:

  1. 1
    Gehen Sie im Dashboard zu Einstellungen -> Integrationen -> Zahlungen (/settings/integrations/payments).
  2. 2
    Klicken Sie bei Stripe, PayPal oder Paystack auf Verbinden.
  3. 3
    Hinterlegen Sie Ihre Produktions-API-Schlüssel oder durchlaufen Sie das OAuth-Onboarding.

Schritt 2: PassFlow-Builder öffnen

  1. 1
    Navigieren Sie zu Pässe -> PassFlows und wählen Sie den mit Ihrer Vorlage verknüpften Flow aus (oder erstellen Sie einen neuen Flow).
  2. 2
    Stellen Sie in der Schrittfolge sicher, dass die folgende Reihenfolge eingehalten wird:

- FormStep (Kundendaten) - EmailStep oder OtpStep (Optionale Verifizierung) - PaymentStep (Zahlungseinzug) - PassStep (Pass-Ausgabe)

Schritt 3: Pass-Preis & Währung konfigurieren

Klicken Sie auf den Block PaymentStep, um die Checkout-Eigenschaften festzulegen:

  • Preis (amount): Legen Sie den Pass-Preis fest (z. B. 25.00).
  • Währung (currency): Wählen Sie Ihre Abrechnungswährung (z. B. EUR, USD).
  • Artikelname & Beschreibung: Geben Sie den Titel ein, der Kundinnen und Kunden auf der Checkout-Seite angezeigt wird (z. B. „VIP-Lounge-Jahresmitgliedschaft 2026“).
  • Zahlungsanbieter: Aktivieren Sie die verbundenen Gateways, die Sie anbieten möchten (z. B. sowohl Stripe als auch PayPal).

Schritt 4: Zahlungs-Metadaten auf Pass-Attribute abbilden

Sie können Zahlungsbestätigungsdaten automatisch an benutzerdefinierte Pass-Felder binden:

  • Verwenden Sie {transactionId}, um die Referenz-ID des Zahlungsgateways zu speichern.
  • Verwenden Sie {amountPaid}, um den gezahlten Ticketpreis auf der Pass-Rückseite anzuzeigen.
  • Verwenden Sie {paymentDate}, um den Kaufzeitstempel festzuhalten.

Schritt 5: Flow veröffentlichen & testen

Öffnen Sie Ihren öffentlichen PassFlow-Link (/f/:slug) in einem Inkognito-Fenster:

  1. 1
    Geben Sie Test-Kundendaten ein.
  2. 2
    Schließen Sie eine Testzahlung mit Gateway-Testkarten oder Sandbox-PayPal-Zugangsdaten ab.
  3. 3
    Prüfen Sie, ob der Pass unmittelbar auf dem PassStep-Bildschirm ausgestellt wird.

Öffentliche Checkout-REST-API-Endpunkte

Wenn Sie den Pass-Kauf in Ihre eigene mobile App, Website oder ein benutzerdefiniertes React-Frontend einbetten möchten, können Sie die öffentlichen PassFlow-Zahlungsendpunkte direkt ansprechen:

MethodeEndpunkt-PfadBeschreibung
GET/api/v1/pass-flows/public/:url/payment-configGibt die Zahlungskonfiguration zurück: aktivierte Gateways, Währung, Preisbetrag und öffentliche API-Schlüssel.
POST/api/v1/pass-flows/public/:url/payment-intentErstellt einen Stripe PaymentIntent und gibt clientSecret für Stripe Elements zurück.
POST/api/v1/pass-flows/public/:url/paypal-orderErstellt eine PayPal-v2-Bestellung und gibt die PayPal-Genehmigungs-URL zurück.
POST/api/v1/pass-flows/public/:url/paystack/initializeInitialisiert eine Paystack-Transaktion und gibt eine Autorisierungs-URL zurück.
POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-payLöst eine Push-Zahlungsanfrage an eine MTN-Mobile-Money-Rufnummer aus.

Beispiel: Stripe Payment Intent initialisieren

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

Antwort (200 OK):

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

Umgang mit Rückerstattungen, Streitfällen & Pass-Widerruf

Wenn eine Kundin oder ein Kunde eine Rückerstattung anfordert oder eine Zahlung über Stripe oder PayPal anficht:

  1. 1
    Automatische Webhook-Verarbeitung: Passinstance empfängt den Webhook charge.refunded bzw. PAYMENT.CAPTURE.REFUNDED.
  2. 2
    Option zum Pass-Widerruf: Unter Workspace-Einstellungen -> Zahlungen legen Sie das automatisierte Verhalten bei Rückerstattungen fest:

- Pass automatisch entwerten (Empfohlen): Setzt pass.voided = true. Apple Wallet blendet umgehend ein „Entwertet“-Banner über dem Pass ein und streicht den Barcode durch. Google Wallet markiert den Pass als inaktiv. Scanner-Geräte lehnen künftige Check-in-Versuche ab. - Pass aktiv belassen: Belässt den Pass im aktiven Zustand und schreibt einen Audit-Eintrag zur manuellen Prüfung durch Ihr Team.

  1. 3
    Push-Benachrichtigung: Bei einer Entwertung sendet Passinstance eine APNs- und Google-Wallet-Push-Mitteilung, die den Inhaber über den Widerruf infolge der Rückerstattung informiert.

Weiterführende Dokumentation

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.