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:
Onboardingstappen & enums
De sessie doorloopt precies de waarden van de OnboardingStep-enum:
-
1
WALLET_SETUP: Bekijk en accepteer de platformvoorwaarden voor wallet-uitgifte (googleWalletAccepted) en bereid standaard demogegevens voor. -
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.
-
3
GENERATING_DEMOS: De backend plaatst achtergrondtaken in de wachtrij die demosjablonen inrichten voorOnboardingUseCase-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). -
4
TRY_PASS: Genereert een tijdelijke voorbeeldpas met een scanbare QR-code voor onmiddellijke installatie op een telefoon. -
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:
| Endpointpad | Methode | Auth | Payload / Parameters | Beschrijving |
|---|---|---|---|---|
/api/v1/onboarding | GET | Bearer | Geen | Haalt de huidige onboarding-sessiestatus, actieve stap en gegenereerde demo's op. |
/api/v1/onboarding/wallet-setup | PUT | Bearer | { "googleWalletAccepted": true } | Accepteert wallet-uitgiftevoorwaarden en richt standaard Google Wallet-configuratie in. |
/api/v1/onboarding/personalize | PUT | Bearer | { expectedPassVolume, useCases: [] } | Slaat het bedrijfsvolumeniveau en geselecteerde OnboardingUseCase-items op. |
/api/v1/onboarding/demos | POST | Bearer | Geen | Start asynchrone generatie van demosjablonen (QUEUED -> READY). |
/api/v1/onboarding/demos | GET | Bearer | Geen | Pollt de voortgang van demogeneratie voor aangevraagde use-cases. |
/api/v1/onboarding/demos/:type/retry | POST | Bearer | URL-param :type | Probeert demogeneratie opnieuw als een specifiek catalogustype is mislukt. |
/api/v1/onboarding/sample-pass | POST | Bearer | { templateId? } | Genereert een live testpas voor directe wallet-installatie. |
/api/v1/onboarding/sample-pass/public/:sessionId | GET | Geen | URL-param :sessionId | Niet-geauthenticeerd openbaar endpoint om de voorbeeldpas op mobiel te bekijken/installeren. |
/api/v1/onboarding/complete | POST | Bearer | { 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
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
Regionale instellingen configureren: Ga naar Instellingen -> Algemeen (
/settings/workspace/general) of roepPUT /api/v1/customer/:customerId/regional-settingsaan 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.
-
3
Apple Wallet-certificaat configureren (Productie): Genereer onder Instellingen -> Wallet -> Apple-certificaten (
/settings/workspace/wallet) een Certificate Signing Request viaPOST /api/v1/certificates/generate-csr, upload deze naar de Apple Developer Portal onder Pass Type IDs en importeer het ondertekende.cer-bestand viaPOST /api/v1/certificates. -
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 TapcollectorIdte inspecteren. -
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.
