Skip to content
Helpcentrum-gids · Snelstartgids
4 min leestijdGecontroleerd 2026-11-16

Account instellen

Maak uw werkruimte aan, vul bedrijfsgegevens in en tref voorbereidingen voor ondertekening.

In deze gids

Overzicht

Het instellen van een Passinstance-account initialiseert uw geïsoleerde tenant-workspace, configureert uw regionale voorkeuren en leidt u door een geautomatiseerde onboardingpipeline om direct testbare demopassen te genereren voor Apple Wallet en Google Wallet.

Onboardingpipeline & toestandsmachine

Passinstance beheert accountinitialisatie via een geautomatiseerde OnboardingSession-toestandsmachine die wordt aangestuurd door Onboarding API:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
ONBOARDING-TOESTANDSMACHINE
FASE 01 WALLET_SETUP
Voorwaarden acc.
& Google inricht.
FASE 02 PERSONALIZE
Kies volume & use-casecatalogus
FASE 03 GENERATING_DEMOS
Asynchrone background job bouwt 17 sjablonen
FASE 02A DONE
Productiegereed; start sjablonen
FASE 02B TRY_PASS
Scan voorbeeldpas op iOS / Android
FASE 02C GENERATING_DEMOS
Achtergrondgeneratie voltooit democatalogus

Onboardingstappen & enums

De sessie doorloopt precies de waarden van de OnboardingStep-enum:

  1. 1
    WALLET_SETUP: Bekijk en accepteer de platformvoorwaarden voor wallet-uitgifte (googleWalletAccepted) en bereid standaard demogegevens voor.
  2. 2
    PERSONALIZE: Kies uw bedrijfsmodel en het verwachte maandelijkse volumeniveau:

- EVALUATING: Mogelijkheden testen en sandbox verkennen. - UP_TO_500: Boetieks, lokale clubs, gespecialiseerde locaties. - RANGE_500_5000: Groeiende retailers, regionale sportscholen, middelgrote evenementen. - RANGE_5000_25000: Franchises met meerdere vestigingen en grote ledenorganisaties. - RANGE_25000_PLUS / ENTERPRISE: Grootschalige ticketing, nationale retailloyaliteit, luchtvaart-/vervoerspassen.

  1. 3
    GENERATING_DEMOS: De backend plaatst achtergrondtaken in de wachtrij die demosjablonen inrichten voor OnboardingUseCase-categorieën (LOYALTY_AND_CUSTOMER_CARDS, MEMBERSHIP_CARDS, TICKETING, VOUCHERS_OR_COUPONS, GIFT_CARDS_OR_PREPAID_CARDS, BUSINESS_CARDS, EMPLOYEE_IDS, INSURANCE_WARRANTY_AND_SERVICE_CARDS, OTHER).
  2. 4
    TRY_PASS: Genereert een tijdelijke voorbeeldpas met een scanbare QR-code voor onmiddellijke installatie op een telefoon.
  3. 5
    DONE: De onboarding wordt afgerond en ontgrendelt het volledige beheerdersdashboard (/dashboard).

API-referentie voor Onboarding API

Ontwikkelaars en geautomatiseerde provisioningscripts kunnen de onboarding programmatisch aansturen via /api/v1/onboarding:

EndpointpadMethodeAuthPayload / ParametersBeschrijving
/api/v1/onboardingGETBearerGeenHaalt de huidige onboarding-sessiestatus, actieve stap en gegenereerde demo's op.
/api/v1/onboarding/wallet-setupPUTBearer{ "googleWalletAccepted": true }Accepteert wallet-uitgiftevoorwaarden en richt standaard Google Wallet-configuratie in.
/api/v1/onboarding/personalizePUTBearer{ expectedPassVolume, useCases: [] }Slaat het bedrijfsvolumeniveau en geselecteerde OnboardingUseCase-items op.
/api/v1/onboarding/demosPOSTBearerGeenStart asynchrone generatie van demosjablonen (QUEUED -> READY).
/api/v1/onboarding/demosGETBearerGeenPollt de voortgang van demogeneratie voor aangevraagde use-cases.
/api/v1/onboarding/demos/:type/retryPOSTBearerURL-param :typeProbeert demogeneratie opnieuw als een specifiek catalogustype is mislukt.
/api/v1/onboarding/sample-passPOSTBearer{ templateId? }Genereert een live testpas voor directe wallet-installatie.
/api/v1/onboarding/sample-pass/public/:sessionIdGETGeenURL-param :sessionIdNiet-geauthenticeerd openbaar endpoint om de voorbeeldpas op mobiel te bekijken/installeren.
/api/v1/onboarding/completePOSTBearer{ skipSamplePass?: boolean }Markeert de onboardingsessie als DONE.

Checklist voor accountconfiguratie

Volg deze mijlpalen in Passinstance Dashboard om uw workspace voor te bereiden op productielancering:

  1. 1
    Workspace & e-mailadres verifiëren: Bevestig bij registratie uw e-mailadres (elk geldig e-mailadres werkt) om uw beheerdersrechten voor de tenant vast te leggen, standaard voorzien van een Demo Apple-certificaat en een beheerde Google Wallet-uitgever.
  2. 2
    Regionale instellingen configureren: Ga naar Instellingen -> Algemeen (/settings/workspace/general) of roep PUT /api/v1/customer/:customerId/regional-settings aan om het volgende in te stellen:

- Tijdzone: Bepaalt dagelijkse scanlimieten en lokale tijdstempels (bijv. Europe/Berlin, America/New_York). - Valuta: Stelt de standaard ISO 4217-valuta in voor prepaidsaldi (bijv. EUR, USD, GBP). - Standaardtaal: Stelt de primaire taal in voor gelokaliseerde wallet-velden.

  1. 3
    Apple Wallet-certificaat configureren (Productie): Genereer onder Instellingen -> Wallet -> Apple-certificaten (/settings/workspace/wallet) een Certificate Signing Request via POST /api/v1/certificates/generate-csr, upload deze naar de Apple Developer Portal onder Pass Type IDs en importeer het ondertekende .cer-bestand via POST /api/v1/certificates.
  2. 4
    Google Wallet-uitgever configureren (Productie): Voer onder Instellingen -> Wallet -> Google Wallet de configuratie uit (POST /api/v1/google-wallet/setup) en controleer de status (GET /api/v1/google-wallet/status) om uw Google Issuer ID en Smart Tap collectorId te inspecteren.
  3. 5
    Teamrollen & toegangsbeheer: Nodig onder Instellingen -> Toegang -> Leden & rollen (/settings/workspace/access) medewerkers uit met organisatierollen (OrganizationMemberRole: OWNER, ADMIN, MEMBER) naast workspace-RBAC-rollen (DEFAULT_ROLES: super-admin, admin, editor, user, customer) en dwing twee-factorauthenticatie af (enforceTwoFactorAuth).

Vereisten: Om eigen merkpassen in productie uit te geven in Apple Wallet heeft u een actief Apple Developer Program-lidmaatschap ($ 99/jaar) nodig om een Apple Pass Type ID-certificaat (pass.com.yourcompany.app) te genereren. Testen tijdens de onboarding-sandbox maakt gebruik van Passinstance-democertificaten.

Bekijk onze beschikbare Abonnementen & capaciteitsniveaus of ga direct door naar Fase 2: Ontwerp uw pass.

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.