Skip to content
Helpcentrum-gids · Bureaus & partners
2 min leestijdGecontroleerd 2026-11-16

Multiklantenbeheer

Beheer strikt gescheiden klantwerkruimtes met eigen API-sleutels voor bureaus en softwarepartners.

In deze gids

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.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
AGENTSCHAP MULTI-WERKRUIMTE TENANCY
FASE 01 AGENTSCHAPSORGANISATIE (Organization-model)
Centraal agentschapsbestuur (OrganizationMemberRole: OWNER, ADMIN, MEMBER)
Geconsolideerd facturatieoverzicht (GET/api/v1/organizations/current/billing-summary)
FASE 02 1:N Geïsoleerde klantwerkruimtes
KLANT A WERKRUIMTE (production)
Tenant-ID: cust_client_a_01
Eigen Apple .p12 & Google Auth
Afgebakende sleutels: pi_live_...
Aparte scannersleutels & webhooks
KLANT B WERKRUIMTE (sandbox)
Tenant-ID: cust_client_b_02
Geïsoleerde testsjablonen & passen
Afgebakende sleutels: pi_test_...
Nul impact op productiequota

Kerninvarianten voor isolatie

  • Strikte gegevensscheiding: Sjablonen, uitgegeven passen (externalId, serialNumber), cryptografische ondertekeningscertificaten (.p12 met per-handelaar eigen bundleId / 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_ en pi_test_) en mobiele scannersleutels (x-scanner-key) zijn cryptografisch gekoppeld aan één customerId en 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:

EndpointpadMethodeAuthBeschrijving
/api/v1/organizations/currentGET / PUTBearerLeest of werkt de actieve Organization, lidrollen (OrganizationMemberRole: `OWNERADMINMEMBER) en alle toegankelijke zuster-Customer`-werkruimtes bij.
/api/v1/organizations/current/workspacesPOSTBearerRicht een nieuwe geïsoleerde klantwerkruimte in (`kind: "production" \"sandbox"`).
/api/v1/organizations/current/workspaces/switchPOSTBearerWisselt van actieve werkruimtecontext en roteert sessie-authenticatietokens.
/api/v1/organizations/current/billing-summaryGETBearerAggregeert 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):

JSON
{
  "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:

JSON
{
  "workspaceId": "cust_client_a_01"
}

Antwoord (200 OK):

JSON
{
  "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:

JSON
{
  "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-kind accepteert strikt "production" of "sandbox" zoals afgedwongen door request 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.

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.