Kundinnen und Kunden rund um die Uhr selbst registrieren lassen
Neben dem Hochladen von CSV-Listen oder Backend-API-Aufrufen ermöglicht Passinstance die Veröffentlichung unauthentifizierter Self-Service-Kontaktpunkte am stationären Point of Sale, auf Bestellabschlussseiten im E-Commerce, auf Kassenbons und auf Produktverpackungen:
| Kanal | Ideal geeignet für | Funktionsweise |
|---|---|---|
| Öffentliches PassFlow-Formular | Aufsteller am Tresen, E-Mail-Signaturen, QR-Flyer | Kundinnen und Kunden füllen ein mobil optimiertes Registrierungsformular (/p/:url) aus, bestätigen bei Aktivierung ein E-Mail-/SMS-OTP, schließen optional eine Zahlung ab und speichern den Pass direkt. |
| Eingebetteter Wallet-Button / Widget | Kundenkonten, Bestellbestätigungsseiten | Einbetten eines interaktiven iFrames oder eines Add-to-Wallet-Script-Widgets direkt im HTML Ihrer Website. |
| Dynamische Wallet-URL | Transaktions-E-Mails, SaaS-Dashboards, Kundenportale | Übergeben Sie parametrisierte Kundenattribute oder nutzen Sie upsert-by-external-id, sodass angemeldete Nutzende mit einem Tippen ihre vorausgefüllte Karte abrufen. |
| NDEF NFC-Smart-Tag / Sticker | Tischaufsteller, Kassenbereiche, Smart-Poster | Beschreiben Sie einen Standard-NDEF-NFC-Tag (NTAG213/215) mit Ihrer öffentlichen PassFlow-URL — ein Antippen mit iPhone oder Android öffnet das Formular ganz ohne QR-Scan. |
Öffentliche PassFlow-Self-Enrollment-Architektur
Die PassFlow-Engine (PassFlow API unter /api/v1/pass-flows/public/:url, mit Alias /api/v1/passflows/public/:url und UI-Route /f/:url) orchestriert mehrstufige öffentliche Registrierungsstrecken (PassFlowType, PassFlowSubmissionStatus) mit integriertem Bot-Schutz (SpamProtectionMode), OTP-Verifizierung, Duplikatschutz (externalId) und direkter Wallet-Übergabe:
Wichtig: Um doppelte Pass-Erstellungen zu verhindern, falls ein bestehendes Mitglied ein Self-Service-Formular erneut absendet, konfigurieren Sie Deduplizierungs- / External-ID-Regeln auf Ihrer Vorlage bzw. Ihrem PassFlow (
phoneoderexternalId). Eigene Portale können außerdem direktPOST /api/v1/passes/upsert-by-external-idaufrufen, um den bereits existierenden aktiven Pass statt eines Duplikats zurückzugeben.
Öffentliche PassFlow- & Self-Service-API-Referenz
| Methode | Endpunkt-Pfad | Authentifizierung | Beschreibung | ||
|---|---|---|---|---|---|
| GET | /api/v1/pass-flows/public/:url | Öffentlich | Ruft die öffentliche PassFlow-Schrittkonfiguration (PassFlowStepType), das Formularschema, das Theme (page theme: `LIGHT \ | DARK \ | CUSTOM`) und Vorlagenvorschaudaten ab. |
| GET | /api/v1/pass-flows/public/:url/csrf-token | Öffentlich | Stellt das Anti-CSRF-Token aus, das vor dem Absenden einer öffentlichen Pass-Generierung erforderlich ist. | ||
| POST | /api/v1/pass-flows/public/:url/generate | Öffentlich | Übermittelt die Registrierungsdaten (request payload: userData, recaptchaToken?, botProtectionToken?), um den Pass zu erstellen bzw. abzurufen. | ||
| POST | /api/v1/pass-flows/public/:url/otp/send | Öffentlich (Rate-Limited) | Sendet während OtpStep ein Einmalpasswort (POST .../otp/resend zum erneuten Versand). | ||
| POST | /api/v1/pass-flows/public/:url/otp/verify | Öffentlich (Rate-Limited) | Prüft den eingegebenen OTP-Code und schaltet die Pass-Generierung frei. | ||
| POST | /api/v1/pass-flows/public/:url/payment-intent | Öffentlich | Initialisiert einen Stripe PaymentIntent (GET .../payment-config, /paypal-order, /paystack/initialize, /mtn-momo/request-to-pay, /orange-money/initiate). | ||
| POST | /api/v1/passes/upsert-by-external-id | API Key (passes) | request payload — erstellt (CREATED) oder aktualisiert (UPDATED) idempotent den Pass einer Kundin/eines Kunden anhand von externalId. |
Beispiel: Idempotentes Portal-Onboarding via upsert-by-external-id
Wenn Sie einen Button Zu Wallet hinzufügen in Ihr eigenes authentifiziertes Kundenportal oder Ihre Web-App einbetten, rufen Sie serverseitig POST /api/v1/passes/upsert-by-external-id auf und leiten Nutzende auf passAccessUrl weiter:
POST /api/v1/passes/upsert-by-external-id
{
"templateId": "7b9e4c12-3f81-4a90-b8d2-19c48a70e112",
"externalId": "USR-90214",
"status": "ACTIVE",
"attributes": {
"firstName": "Elena",
"lastName": "Rostova",
"email": "elena.rostova@example.com",
"tier": "Gold",
"points": 1250
}
}
Antwort (200 OK):
{
"success": true,
"data": {
"pass": {
"id": "c41a8d20-6e11-4f3b-9a81-0029d81a4f10",
"serialNumber": "PI-8849-2026-X9",
"externalId": "USR-90214",
"bundleId": null,
"status": "ACTIVE",
"walletVoidStatus": "QUEUED",
"passAccessUrl": "https://app.passinstance.com/p/c41a8d20-6e11-4f3b-9a81-0029d81a4f10"
},
"action": "UPDATED"
},
"description": "Pass updated successfully",
"errors": [],
"statusCode": 200
}
NDEF-NFC-Aufsteller für den Kassenbereich kodieren
Um physische Tap-to-Enroll-Aufsteller an der Kasse ohne Apple-VAS- oder Google-Smart-Tap-Lesegeräte bereitzustellen:
-
1
Kopieren Sie Ihre öffentliche PassFlow-URL (z. B.
https://app.passinstance.com/f/coffee-club-vip). -
2
Schreiben Sie mithilfe einer Standard-NFC-App (wie NFC Tools) einen NDEF-URI-Eintrag auf einen NTAG213-, NTAG215- oder NTAG216-Sticker und aktivieren Sie Tag sperren (Schreibschutz / Read-Only), damit niemand die URL überschreiben kann.
-
3
Sobald Kundinnen oder Kunden ihr entsperrtes iPhone oder Android-Smartphone an den Aufsteller halten, öffnet das Betriebssystem die PassFlow-Registrierungsseite direkt in Safari oder Chrome.
Für Einbettungsparameter und Webhook-Trigger lesen Sie den Leitfaden Registrierungsformulare & PassFlow sowie den Integrations-Leitfaden.
