Laat klanten zichzelf 24/7 inschrijven
Naast het uploaden van CSV-lijsten of het aanroepen van backend-API's kunt u met Passinstance ongeauthenticeerde selfservice-inschrijfkanalen publiceren op fysieke winkelbalies, check-outpagina's van webshops, kassabonnen en productverpakkingen:
| Kanaal | Meest geschikt voor | Hoe het werkt |
|---|---|---|
| Openbaar PassFlow-formulier | Balieposters, e-mailhandtekeningen, QR-flyers | De klant vult een voor mobiel geoptimaliseerd registratieformulier (/p/:url) in, verifieert desgewenst e-mail-/sms-OTP, rondt optioneel betaling af en slaat zijn pas direct op. |
| Ingesloten wallet-knop / widget | Klantportalen, orderbevestigingspagina's | Sluit een interactief iframe of Add-to-Wallet-scriptwidget rechtstreeks in uw website-HTML in. |
| Dynamische wallet-URL | Transactionele e-mails, SaaS-dashboards, loyaliteitsportalen | Onderteken of geef geparametriseerde klantgegevens door in de URL of via upsert-by-external-id, zodat ingelogde gebruikers met één tik een vooraf ingevulde pas claimen. |
| NDEF NFC Smart Tag / Sticker | Baliedisplays, kassa's, slimme posters | Schrijf een openbare PassFlow-URL op elke standaard NDEF NFC-tag (NTAG213/215) zodat het tikken van een iPhone of Android direct de inschrijfstroom opent zonder QR-code te scannen. |
Openbare architectuur voor PassFlow-zelfinschrijving
De PassFlow-engine (PassFlow API op /api/v1/pass-flows/public/:url, met alias /api/v1/passflows/public/:url en UI-route /f/:url) orkestreert meerstaps ongeauthenticeerde klantintake (PassFlowType, PassFlowSubmissionStatus) met ingebouwde botbescherming (SpamProtectionMode), OTP-verificatie, voorkoming van duplicaten (externalId) en directe wallet-overdracht:
Belangrijk: Om dubbele pasaanmaak te voorkomen wanneer een bestaand lid opnieuw een selfservice-formulier invult, configureert u Ontdubbeling / External ID-regels op uw sjabloon of PassFlow (
phoneofexternalId). Backendportalen kunnen ook rechtstreeksPOST /api/v1/passes/upsert-by-external-idaanroepen om de bestaande actieve pas terug te geven in plaats van een dubbel record aan te maken.
API-referentie voor openbare PassFlow & selfservice
| Methode | Endpointpad | Auth-bereik | Beschrijving | ||
|---|---|---|---|---|---|
| GET | /api/v1/pass-flows/public/:url | Openbaar | Haalt de openbare PassFlow-stapconfiguratie (PassFlowStepType), het formulierschema, het thema (page theme: `LIGHT \ | DARK \ | CUSTOM`) en sjabloonmetadata op. |
| GET | /api/v1/pass-flows/public/:url/csrf-token | Openbaar | Verstrekt het anti-CSRF-token dat vereist is vóór openbare pasgeneratie-inzendingen. | ||
| POST | /api/v1/pass-flows/public/:url/generate | Openbaar | Verstuurt de registratiepayload (request payload: userData, recaptchaToken?, botProtectionToken?) om de pas aan te maken/op te halen. | ||
| POST | /api/v1/pass-flows/public/:url/otp/send | Openbaar (Rate-Limited) | Verstuurt een eenmalige code (POST .../otp/resend om opnieuw te verzenden) tijdens OtpStep. | ||
| POST | /api/v1/pass-flows/public/:url/otp/verify | Openbaar (Rate-Limited) | Verifieert de ingediende OTP-code en ontgrendelt pasgeneratie. | ||
| POST | /api/v1/pass-flows/public/:url/payment-intent | Openbaar | Initialiseert een 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-sleutel (passes) | request payload — maakt idempotent een klantenpas aan (CREATED) of werkt deze bij (UPDATED) op basis van externalId. |
Voorbeeld: idempotente portaalinschrijving via upsert-by-external-id
Wanneer u een knop Toevoegen aan Wallet ("Add to Wallet") opneemt in uw eigen geauthenticeerde klantportaal of webapplicatie, roept u POST /api/v1/passes/upsert-by-external-id aan vanaf uw backend en stuurt u de gebruiker door naar passAccessUrl:
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
}
}
Respons (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-balietags coderen
Om fysieke tik-om-in-te-schrijven-displays op kassabalies te plaatsen zonder dat daar Apple VAS- of Google Smart Tap-lezerhardware voor nodig is:
-
1
Kopieer uw openbare PassFlow-URL (bijvoorbeeld
https://app.passinstance.com/f/coffee-club-vip). -
2
Gebruik een willekeurige standaard NFC-tagschrijver (zoals NFC Tools) om een NDEF URI-record naar een NTAG213-, NTAG215- of NTAG216-sticker te schrijven en schakel Tag vergrendelen (Alleen-lezen) in zodat klanten de URL niet kunnen overschrijven.
-
3
Wanneer een klant met een ontgrendelde iPhone of Android-telefoon tegen de baliestandaard tikt, opent het besturingssysteem automatisch de PassFlow-registratiepagina in Safari of Chrome.
Raadpleeg de Gids voor registratieformulieren & PassFlow en de Integratiegids voor embedparameters en webhooktriggers.
