Skip to content
Helpcentrum-gids · Pakketten & verbruik
3 min leestijdGecontroleerd 2026-11-16

Prijzen & abonnementen

Vergelijk Free (5 passen), Starter, Growth, Scale 10K en Enterprise in EUR/USD met 20% jaarkorting.

In deze gids

Overzicht

Passinstance biedt transparante abonnementen met vaste capaciteit die strikt worden berekend op basis van Actieve Wallet-passen—passen die momenteel geïnstalleerd en bereikbaar zijn op klantapparaten. Aangestuurd door Billing API (/api/v1/billing/*) en toegankelijk via Instellingen -> Facturatie (/settings/billing/overview, /add-ons, /payment-method, /invoices), kunnen werkruimtes zich abonneren in EUR (€) of USD (\$) over BillingFrequency (Monthly, Yearly met ~20% jaarbesparing), modulaire add-ons koppelen en promotiecodes valideren.

Architectuur voor abonnements- & add-on-meting

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
ABONNEMENTSCATALOGUS, ADD-ONS & PROMOTIE-ENGINE
FASE 01 ABONNEMENTS- & CATALOGUSLAAG
Basis-capaciteitsplan
GET/billing/plans (Free, Starter, Growth,
Scale 10K, Enterprise)
Modulaire add-ons
GET/billing/addons (Extra pasbundels,
White-label domeinen)
Promo & Afspraken
POST/billing/ promotions/validate (PricingAgreement`)
FASE 02 FACTURATIEOVERZICHT & CAPACITEITSAGGREGATOR
GET/api/v1/billing/overview & GET/api/v1/billing/subscription
effectiveActivePassLimit = Basisplanlimiet + Actieve Add-On Pascapaciteit
softCreatedPassThreshold = effectiveActivePassLimit * 5
Vrijgegeven Feature Flags (Eigen domeinen, Eigen SMTP, API-limieten, RBAC)

Belangrijk: U kunt actuele plandefinities en rechten op elk moment bekijken op /pricing of programmatisch via GET /api/v1/billing/plans. Non-profitorganisaties en onderwijsinstellingen komen in aanmerking voor doorlopende kortingen—zie Geschiktheid & voordelen.

Abonnementsniveaus met vaste capaciteit

PakketniveauActieve Wallet-pascapaciteitMaandelijkse facturatie (EUR / USD)Jaarlijkse facturatie (~20% voordeel)Doelgroepen & kernrechten
Free5 actieve passen€0 / \$0Altijd gratisSandbox-prototyping, visueel sjabloonontwerp, live Apple/Google-apparaattests en REST API-evaluatie.
Starter200 actieve passen€16 / \$22 /mnd~20% kortingLoyaliteitsprogramma's voor één locatie, boetiekclubs, pilotwinkels en web-/mobiele scannerkoppeling.
Growth2.000 actieve passen€120 / \$180 /mnd~20% kortingMulti-locatie retailloyaliteit, terugkerende evenementenreeksen, geautomatiseerde CRM-workflows en Push/Pull-webhooks.
Scale 10K10.000 actieve passen€400 / \$700 /mnd~20% kortingGrote horecaketens, regionale attracties, aangepaste RBAC-rollen en high-throughput API-pijplijnen.
Enterprise10.001+ actieve passenOp maatMaatwerkovereenkomstMulti-merk concerns, SAML 2.0 SSO, toegewijde SLA's, aangepaste PricingAgreement-niveaus en white-label portalen.

Basisabonnementen, add-ons & promotiecodes (Billing API)

Passinstance scheidt uw basisabonnement van modulaire add-on-abonnementen zodat u specifieke mogelijkheden (zoals aangepaste white-label domeinen of extra actieve pascapaciteit) kunt uitbreiden zonder meteen over te stappen op een volledig Enterprise-contract.

Kern-API-endpoints voor plannen & add-ons en status-enums

Subscription-records volgen hun status via subscription status (ACTIVE, INACTIVE, EXPIRED, CANCELLED, SUSPENDED, TRIALING, PAST_DUE, GRACE_PERIOD, RESTRICTED, CANCEL_AT_PERIOD_END, UNPAID, ARCHIVED) en facturatiecycli via BillingFrequency (Monthly, Yearly):

EndpointHTTP-methodeBeschrijving
/api/v1/billing/plansGETRetourneert actieve abonnementen, tarieven in EUR/USD, BillingFrequency en inbegrepen functierechten.
/api/v1/billing/subscriptionGETRetourneert het actieve abonnement (subscription status), facturatiecyclus en currentPeriodEnd.
/api/v1/billing/overviewGETCombineert basisplan, add-on-abonnementen, realtime verbruiksmeters en voorvertoning van komende factuur.
/api/v1/billing/addonsGETToont beschikbare selfservice add-ons (capaciteitspakketten, custom vanity domain add-ons).
/api/v1/billing/add-on-subscriptionsGET / POSTToont actieve add-ons of voegt een terugkerend add-on-abonnement toe (request payload).
/api/v1/billing/add-on-service-requestsPOSTDient een beheerde configuratie-aanvraag in (request payload) voor maatwerk white-label DNS of certificaatbegeleiding.
/api/v1/billing/promotions/validatePOSTValideert een promotiecode (request payload) voor het geselecteerde doelplan en de valuta.

Geconsolideerd facturatieoverzicht opvragen

HTTP
GET /api/v1/billing/overview HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

Antwoordpayload (200 OK)

JSON
{
  "subscription": {
    "id": "sub_019331b2-7e10-7a44-9b00-112233445566",
    "planId": "growth_yearly",
    "planName": "Growth",
    "status": "ACTIVE",
    "interval": "Yearly",
    "currency": "EUR",
    "unitAmount": 115200,
    "currentPeriodStart": "2026-01-15T00:00:00.000Z",
    "currentPeriodEnd": "2027-01-15T00:00:00.000Z",
    "cancelAtPeriodEnd": false
  },
  "addOnSubscriptions": [
    {
      "id": "addsub_019331c0-1122-7d33-8f44-556677889900",
      "addonKey": "white_label_domain",
      "name": "Custom Vanity Domain & Branded Email",
      "status": "ACTIVE",
      "unitAmount": 2900,
      "interval": "Monthly"
    }
  ],
  "capacity": {
    "baseActivePassLimit": 2000,
    "addOnActivePassLimit": 0,
    "effectiveActivePassLimit": 2000,
    "currentActivePasses": 1420,
    "utilizationPercentage": 71.0
  }
}

Een promotiecode valideren (POST /api/v1/billing/promotions/validate)

Controleer of een promotiecode geldig is voor uw gekozen pakket en interval via request payload ({ code, planId?, billingInterval?: 'monthly' | 'annual', currency?: 'EUR' | 'USD' }), met als resultaat IPromotionEligibilityDecision (inclusief stapelbaarheid en overgangsbeleid onder promotion policy: PRESERVE | FORFEIT | PRORATE):

HTTP
POST /api/v1/billing/promotions/validate HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "code": "LAUNCH2026",
  "planId": "growth_monthly",
  "billingInterval": "monthly",
  "currency": "EUR"
}
JSON
{
  "isEligible": true,
  "promotionId": "promo_019331ff-2b30-7c11-9a00-112233445566",
  "promotionName": "2026 Launch Offer",
  "publicLabel": "25% off first 6 months",
  "code": "LAUNCH2026",
  "discountType": "PERCENTAGE",
  "discountPercent": 25,
  "durationType": "REPEATING",
  "durationMonths": 6
}

Gerelateerde documentatie

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.