Skip to content
Helpcentrum-gids · Pass-distributie
3 min leestijdGecontroleerd 2026-11-16

Selfservice-distributie

Publiceer openbare PassFlow-URL's, ingesloten widgets, dynamische Wallet-links en NDEF-NFC-stickers.

In deze gids

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:

KanaalMeest geschikt voorHoe het werkt
Openbaar PassFlow-formulierBalieposters, e-mailhandtekeningen, QR-flyersDe 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 / widgetKlantportalen, orderbevestigingspagina'sSluit een interactief iframe of Add-to-Wallet-scriptwidget rechtstreeks in uw website-HTML in.
Dynamische wallet-URLTransactionele e-mails, SaaS-dashboards, loyaliteitsportalenOnderteken 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 / StickerBaliedisplays, kassa's, slimme postersSchrijf 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:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
OPENBARE PASSFLOW-ZELFINSCHRIJVING
FASE 01 KLANTTOEGANGSPUNT (QR / URL / NDEF-TIK)
GET/api/v1/pass-flows/public/:url (Laadt stroomschema)
FASE 02 STAP 1: FormStep (Validatie van klanteigenschappen & toestemming)
Haalt CSRF-token op (/csrf-token) & valideert request payload
FASE 03 STAP 2 & 3: EmailStep / OtpStep (Optionele identiteitsverificatie)
Verstuurt verificatiecode via POST/api/v1/pass-flows/public/:url/otp/send
Controleert OTP-token via POST/api/v1/pass-flows/public/:url/otp/verify
FASE 04 STAP 4: PaymentStep (Optionele betaalde lidmaatschappen, cadeaukaarten & tickets)
Ondersteunt Stripe PaymentIntent, PayPal Orders, Paystack, MTN MoMo, Orange M.
FASE 05 STAP 5: PassStep (Idempotente upsert & directe wallet-overdracht)
Ontdubbelt op e-mail/telefoon/externalId (upsert-by-external-id-semantiek)
Toont Apple Wallet .pkpass-knop, Google Wallet Save JWT & QR-code

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 (email, phone of externalId). Backendportalen kunnen ook rechtstreeks POST /api/v1/passes/upsert-by-external-id aanroepen om de bestaande actieve pas terug te geven in plaats van een dubbel record aan te maken.

API-referentie voor openbare PassFlow & selfservice

MethodeEndpointpadAuth-bereikBeschrijving
GET/api/v1/pass-flows/public/:urlOpenbaarHaalt 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-tokenOpenbaarVerstrekt het anti-CSRF-token dat vereist is vóór openbare pasgeneratie-inzendingen.
POST/api/v1/pass-flows/public/:url/generateOpenbaarVerstuurt de registratiepayload (request payload: userData, recaptchaToken?, botProtectionToken?) om de pas aan te maken/op te halen.
POST/api/v1/pass-flows/public/:url/otp/sendOpenbaar (Rate-Limited)Verstuurt een eenmalige code (POST .../otp/resend om opnieuw te verzenden) tijdens OtpStep.
POST/api/v1/pass-flows/public/:url/otp/verifyOpenbaar (Rate-Limited)Verifieert de ingediende OTP-code en ontgrendelt pasgeneratie.
POST/api/v1/pass-flows/public/:url/payment-intentOpenbaarInitialiseert 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-idAPI-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:

JSON
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):

JSON
{
  "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. 1
    Kopieer uw openbare PassFlow-URL (bijvoorbeeld https://app.passinstance.com/f/coffee-club-vip).
  2. 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. 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.

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.