Agentschaphiërarchie met meerdere werkruimtes & tenant-isolatie
Digitale bureaus, systeemintegratoren en SaaS-platformen die meerdere winkelmerken beheren, werken binnen Passinstance's tweedelige organisatiestructuur. Een overkoepelende Organisatie (Organization-model) fungeert als centrale bestuurseenheid die meerdere strikt gescheiden Klantwerkruimtes (Customer-model) bezit en uitrolt.
Kerninvarianten voor isolatie
-
Strikte gegevensscheiding: Sjablonen, uitgegeven passen (
externalId,serialNumber), cryptografische ondertekeningscertificaten (.p12met per-handelaar eigenbundleId/passTypeIdentifier), scanner-validatielogs, webhook-abonnementen en persoonsgegevens van klanten zijn strikt afgebakend tot één afzonderlijke werkruimte (customerId). -
Geen lekken tussen tenants: Werkruimtegebonden API-sleutels (
pi_live_enpi_test_) en mobiele scannersleutels (x-scanner-key) zijn cryptografisch gekoppeld aan ééncustomerIden kunnen nooit passen van een zusterwerkruimte opvragen, wijzigen of scannen. -
Wallet-identiteit per klant: Bureaus uploaden aparte Apple Pass Type ID-certificaten (
bundleId) en Google Wallet Issuer-inloggegevens per werkruimte, zodat de meldingen en pasheaders op het toegangsscherm uitsluitend het merk van de betreffende handelaar tonen.
Klantwerkruimtes beheren via de Organization API
Organisatiebeheerders kunnen via Organizations API de organisatiestructuur bekijken, nieuwe klantwerkruimtes inrichten, tussen actieve tenantcontexten schakelen en geconsolideerde facturatietelemetrie ophalen:
| Endpointpad | Methode | Auth | Beschrijving | ||
|---|---|---|---|---|---|
/api/v1/organizations/current | GET / PUT | Bearer | Leest of werkt de actieve Organization, lidrollen (OrganizationMemberRole: `OWNER | ADMIN | MEMBER) en alle toegankelijke zuster-Customer`-werkruimtes bij. |
/api/v1/organizations/current/workspaces | POST | Bearer | Richt een nieuwe geïsoleerde klantwerkruimte in (`kind: "production" \ | "sandbox"`). | |
/api/v1/organizations/current/workspaces/switch | POST | Bearer | Wisselt van actieve werkruimtecontext en roteert sessie-authenticatietokens. | ||
/api/v1/organizations/current/billing-summary | GET | Bearer | Aggregeert abonnementsquota en aantallen actieve Wallet-passen over alle onderliggende werkruimtes. |
Een nieuwe klantwerkruimte inrichten
Bij de onboarding van een nieuwe handelaar of het opzetten van een afzonderlijke testomgeving roept u POST /api/v1/organizations/current/workspaces aan met request payload (name en kind: strikt "production" of "sandbox", en stelt u daarna regionale standaardwaarden in via PUT /api/v1/customer/:customerId/regional-settings):
{
"name": "Artisan Coffee Roasters — EU",
"kind": "production"
}
Werkruimtes wisselen & sessierotatie
Wanneer een beheerder in het dashboard of via POST /api/v1/organizations/current/workspaces/switch tussen klantaccounts schakelt, voert Passinstance een atomaire sessierotatie uit om toestandsvermenging tussen tenants uit te sluiten:
{
"workspaceId": "cust_client_a_01"
}
Antwoord (200 OK):
{
"activeWorkspace": {
"id": "cust_client_a_01",
"name": "Artisan Coffee Roasters — EU",
"kind": "production",
"role": "ADMIN"
},
"sessionRotated": true,
"issuedAt": "2026-11-15T14:22:10.000Z"
}
Geconsolideerd facturatieoverzicht voor bureaus
In plaats van losse facturen voor elk klantproject te verwerken, kunnen bureau-eigenaren het cumulatieve aantal actieve Wallet-installaties over alle productiewerkruimtes volgen via GET /api/v1/organizations/current/billing-summary:
{
"organizationId": "org_agency_8841",
"planTier": "SCALE_10K",
"includedActivePasses": 10000,
"totalActivePassesAcrossWorkspaces": 6420,
"workspaces": [
{
"workspaceId": "cust_client_a_01",
"name": "Artisan Coffee Roasters — EU",
"kind": "production",
"activePasses": 4120
},
{
"workspaceId": "cust_client_b_02",
"name": "Artisan Coffee — Sandbox",
"kind": "sandbox",
"activePasses": 0
}
]
}
Belangrijk: Werkruimte-
kindaccepteert strikt"production"of"sandbox"zoals afgedwongen doorrequest payload. Sandboxwerkruimtes isoleren sjabloonontwikkeling en integratietests zonder actieve pascapaciteit te verbruiken uit het productiequotum van uw organisatie.
Bekijk de volledige multi-tenantmogelijkheden op het White-Label & Multi-Tenant Overzicht of verken agentschappartnerschappen op /partners.
