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.
Unterstützte Zahlungsanbieter & Zahlungswege
Passinstance unterstützt globale und regionale Zahlungsgateways über IPublicPassFlowPaymentConfig:
| Anbieter | Unterstützte Zahlungsmethoden | Unterstützte Währungen | Ideal geeignet für |
|---|---|---|---|
| Stripe | Kredit-/Debitkarten, Apple Pay, Google Pay, SEPA-Lastschrift, iDEAL, Bancontact | 135+ Währungen (EUR, USD, GBP usw.) | Globalen E-Commerce, Mobile Wallets und europäische Lastschriften |
| PayPal | PayPal-Guthaben, Kreditkarten, Pay in 4, Venmo | 25+ globale Währungen | Hohe Markenbekanntheit und reibungslosen Ein-Klick-PayPal-Checkout |
| Paystack | Lokale Karten, Banküberweisungen, USSD, Apple Pay | NGN, GHS, ZAR, KES | Afrikanische Märkte und panafrikanischen Zahlungsverkehr |
| Mobile Money | MTN MoMo, Orange Money, M-Pesa | Lokale afrikanische Mobilwährungen | Mobile-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
Gehen Sie im Dashboard zu Einstellungen -> Integrationen -> Zahlungen (
/settings/integrations/payments). -
2
Klicken Sie bei Stripe, PayPal oder Paystack auf Verbinden.
-
3
Hinterlegen Sie Ihre Produktions-API-Schlüssel oder durchlaufen Sie das OAuth-Onboarding.
Schritt 2: PassFlow-Builder öffnen
-
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
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
Geben Sie Test-Kundendaten ein.
-
2
Schließen Sie eine Testzahlung mit Gateway-Testkarten oder Sandbox-PayPal-Zugangsdaten ab.
-
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:
| Methode | Endpunkt-Pfad | Beschreibung |
|---|---|---|
| GET | /api/v1/pass-flows/public/:url/payment-config | Gibt die Zahlungskonfiguration zurück: aktivierte Gateways, Währung, Preisbetrag und öffentliche API-Schlüssel. |
| POST | /api/v1/pass-flows/public/:url/payment-intent | Erstellt einen Stripe PaymentIntent und gibt clientSecret für Stripe Elements zurück. |
| POST | /api/v1/pass-flows/public/:url/paypal-order | Erstellt eine PayPal-v2-Bestellung und gibt die PayPal-Genehmigungs-URL zurück. |
| POST | /api/v1/pass-flows/public/:url/paystack/initialize | Initialisiert eine Paystack-Transaktion und gibt eine Autorisierungs-URL zurück. |
| POST | /api/v1/pass-flows/public/:url/mtn-momo/request-to-pay | Löst eine Push-Zahlungsanfrage an eine MTN-Mobile-Money-Rufnummer aus. |
Beispiel: Stripe Payment Intent initialisieren
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):
{
"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
Automatische Webhook-Verarbeitung: Passinstance empfängt den Webhook
charge.refundedbzw.PAYMENT.CAPTURE.REFUNDED. -
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.
-
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
-
Abonnements verkaufen — Wiederkehrende Mitgliedschaften und automatische Synchronisierung von Abrechnungsverlängerungen.
-
PayPal-API-Signatur anfordern — PayPal-REST-OAuth-Zugangsdaten verbinden.
-
Self-Service-Verteilung — PassFlows, Smart-Links und NFC-Registrierung.
-
Registrierungsformulare & PassFlow — Schrittkonfigurationen, Bot-Schutz und Formularvalidierung.
