Skip to content
Help Center Guide · Plans & Usage
3 min readVerified 2026-11-16

Pricing & Subscription Plans

Compare Free (5 passes), Starter, Growth, Scale 10K, and Enterprise plans with EUR/USD billing and 20% annual savings.

In This Guide

Overview

Passinstance provides transparent, fixed-capacity subscription tiers metered strictly by Active Wallet Passes—passes currently installed and reachable on customer devices. Powered by Billing API (/api/v1/billing/*) and accessible under Settings -> Billing (/settings/billing/overview, /add-ons, /payment-method, /invoices), workspaces can subscribe in EUR (€) or USD (\$) across BillingFrequency (Monthly, Yearly with ~20% annual savings), attach modular add-ons, and validate promotional discount codes.

Subscription & Add-On Metering Architecture

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
SUBSCRIPTION CATALOG, ADD-ONS & PROMOTION ENGINE
STAGE 01 SUBSCRIPTION & CATALOG LAYER
Base Capacity Plans
GET/billing/plans (Free, Starter, Growth,
Scale 10K, Enterprise)
Modular Add-Ons
GET/billing/addons (Extra Pass Packs,
White-Label Domains)
Promo & Agreements
POST/billing/ promotions/validate (PricingAgreement`)
STAGE 02 BILLING OVERVIEW & CAPACITY AGGREGATOR
GET/api/v1/billing/overview & GET/api/v1/billing/subscription
effectiveActivePassLimit = Base Plan Limit + Active Add-On Pass Capacity
softCreatedPassThreshold = effectiveActivePassLimit * 5
Unlocked Feature Flags (Custom Domains, Custom SMTP, API Rate Tiers, RBAC)

Important: You can inspect live plan definitions and feature entitlements at any time on /pricing or programmatically via GET /api/v1/billing/plans. Nonprofits and educational institutions qualify for custom recurring discounts—see Eligibility & Benefits.

Fixed-Capacity Subscription Tiers

Plan TierActive Wallet Pass CapacityMonthly Billing (EUR / USD)Annual Billing (~20% Savings)Target Use Cases & Core Entitlements
Free5 active passes€0 / \$0Free foreverSandbox prototyping, visual template design, live Apple/Google device testing, and REST API evaluation.
Starter200 active passes€16 / \$22 /mo~20% discountSingle-location loyalty programs, boutique clubs, pilot store launches, and web/mobile scanner pairing.
Growth2,000 active passes€120 / \$180 /mo~20% discountMulti-location retail loyalty, recurring event series, automated CRM workflows, and Push/Pull webhooks.
Scale 10K10,000 active passes€400 / \$700 /mo~20% discountHigh-volume hospitality chains, regional attractions, custom RBAC roles, and high-throughput API pipelines.
Enterprise10,001+ active passesCustomCustom AgreementMulti-brand enterprise groups, SAML 2.0 SSO, dedicated SLAs, custom PricingAgreement tiers, and white-label portals.

Base Subscriptions, Add-Ons & Promotion Codes (Billing API)

Passinstance separates your base subscription plan from modular add-on subscriptions so you can expand specific capabilities (such as custom white-label domains or additional active pass blocks) without jumping to a full enterprise contract.

Core Plan & Add-On API Endpoints & Status Enumerations

Subscription records track status via subscription status (ACTIVE, INACTIVE, EXPIRED, CANCELLED, SUSPENDED, TRIALING, PAST_DUE, GRACE_PERIOD, RESTRICTED, CANCEL_AT_PERIOD_END, UNPAID, ARCHIVED) and billing cycles via BillingFrequency (Monthly, Yearly):

EndpointHTTP VerbDescription
/api/v1/billing/plansGETReturns active subscription plans, pricing in EUR/USD, BillingFrequency, and included feature entitlements.
/api/v1/billing/subscriptionGETReturns the active subscription (subscription status), billing cycle, and currentPeriodEnd.
/api/v1/billing/overviewGETCombines base plan, add-on subscriptions, real-time usage meters, and upcoming invoice preview.
/api/v1/billing/addonsGETLists available self-serve add-ons (capacity packs, custom vanity domain add-ons).
/api/v1/billing/add-on-subscriptionsGET / POSTLists active add-ons or attaches a recurring add-on subscription (request payload).
/api/v1/billing/add-on-service-requestsPOSTSubmits a managed setup request (request payload) for custom white-label DNS or certificate onboarding.
/api/v1/billing/promotions/validatePOSTValidates a promotional code (request payload) against a target plan and currency.

Querying Consolidated Billing Overview

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

Response Payload (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
  }
}

Validating a Promotion Code (POST /api/v1/billing/promotions/validate)

Validate whether a promotional code applies to your selected tier and billing interval using request payload ({ code, planId?, billingInterval?: 'monthly' | 'annual', currency?: 'EUR' | 'USD' }), returning IPromotionEligibilityDecision (plus stackability governed by 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
}

Related Product & Developer Documentation

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.