Skip to content
Hilfecenter-Anleitung · Tarife & Nutzung
3 Min. LesezeitGeprüft 2026-11-16

Preise & Abonnement-Tarife

Vergleichen Sie Free (5 Pässe), Starter, Growth, Scale 10K und Enterprise in EUR/USD inklusive 20 % Jahresrabatt.

In dieser Anleitung

Überblick

Passinstance bietet transparente Abonnement-Tarife mit fester Kapazität, die strikt nach Aktiven Wallet-Pässen abgerechnet werden — also Pässen, die aktuell auf Endgeräten installiert und erreichbar sind. Gesteuert über Billing API (/api/v1/billing/*) und zugänglich unter Einstellungen -> Abrechnung (/settings/billing/overview, /add-ons, /payment-method, /invoices) können Workspaces in EUR (€) oder USD (\$) über BillingFrequency (Monthly, Yearly mit ~20 % jährlicher Ersparnis) abonnieren, modulare Add-ons buchen und Aktionscodes validieren.

Abonnement- & Add-on-Messarchitektur

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
ABONNEMENTKATALOG, ADD-ONS & PROMOTION-ENGINE
STUFE 01 ABONNEMENT- & KATALOGEBENE
Basis-Kapazitätstarife
GET/billing/plans (Free, Starter, Growth,
Scale 10K, Enterprise)
Modulare Add-Ons
GET/billing/addons (Zusatzpass-Pakete,
White-Label-Domains)
Promos & Verträge
POST/billing/ promotions/validate (PricingAgreement`)
STUFE 02 ABRECHNUNGSÜBERSICHT & KAPAZITÄTS-AGGREGATOR
GET/api/v1/billing/overview & GET/api/v1/billing/subscription
effectiveActivePassLimit = Basis-Planlimit + Aktive Add-On-Passkapazität
softCreatedPassThreshold = effectiveActivePassLimit * 5
Freigeschaltete Feature-Flags (Eigene Domains, SMTP, API-Ratenstufen, RBAC)

Wichtig: Live-Tarifdefinitionen und Funktionsumfänge können jederzeit auf /pricing oder programmatisch über GET /api/v1/billing/plans eingesehen werden. Gemeinnützige Organisationen und Bildungseinrichtungen erhalten individuelle wiederkehrende Rabatte — siehe Berechtigung & Vorteile.

Abonnement-Stufen mit fester Kapazität

TarifstufeAktive Wallet-Pass-KapazitätMonatliche Abrechnung (EUR / USD)Jährliche Abrechnung (~20 % Ersparnis)Ziel-Anwendungsfälle & Kernfunktionen
Free5 aktive Pässe€0 / \$0Dauerhaft kostenlosSandbox-Prototyping, visuelles Vorlagendesign, Live-Gerätetests auf Apple/Google sowie REST-API-Evaluierung.
Starter200 aktive Pässe€16 / \$22 /Monat~20 % RabattEinzelstandort-Treueprogramme, Boutique-Clubs, Pilot-Filialstarts und Kopplung von Web-/Mobile-Scannern.
Growth2.000 aktive Pässe€120 / \$180 /Monat~20 % RabattFilialübergreifende Kundenbindung, Event-Serien, automatisierte CRM-Workflows sowie Push-/Pull-Webhooks.
Scale 10K10.000 aktive Pässe€400 / \$700 /Monat~20 % RabattGroße Hospitality-Ketten, Freizeitparks, benutzerdefinierte RBAC-Rollen und Hochdurchsatz-API-Pipelines.
Enterprise10.001+ aktive PässeIndividuellIndividueller VertragMehrmarken-Konzerne, SAML 2.0 SSO, dedizierte SLAs, individuelle PricingAgreement-Konditionen und White-Label-Portale.

Basisabonnements, Add-Ons & Aktionscodes (Billing API)

Passinstance trennt Ihr Basisabonnement von modularen Add-On-Abonnements, sodass Sie gezielte Fähigkeiten (etwa eigene White-Label-Domains oder zusätzliche Kontingente aktiver Pässe) hinzubuchen können, ohne direkt in einen Enterprise-Rahmenvertrag wechseln zu müssen.

Zentrale Plan- & Add-On-Endpunkte sowie Status-Enumerationen

Subscription-Datensätze erfassen ihren Status über subscription status (ACTIVE, INACTIVE, EXPIRED, CANCELLED, SUSPENDED, TRIALING, PAST_DUE, GRACE_PERIOD, RESTRICTED, CANCEL_AT_PERIOD_END, UNPAID, ARCHIVED) und Abrechnungszyklen über BillingFrequency (Monthly, Yearly):

EndpunktHTTP-VerbBeschreibung
/api/v1/billing/plansGETLiefert aktive Abonnementtarife, Preise in EUR/USD, BillingFrequency und enthaltene Funktionsberechtigungen.
/api/v1/billing/subscriptionGETLiefert das aktive Abonnement (subscription status), Abrechnungszyklus und currentPeriodEnd.
/api/v1/billing/overviewGETKombiniert Basistarif, Add-On-Abonnements, Echtzeit-Nutzungszähler und Vorschau der nächsten Rechnung.
/api/v1/billing/addonsGETListet verfügbare Self-Service-Add-Ons auf (Kapazitätspakete, Custom Vanity Domain Add-ons).
/api/v1/billing/add-on-subscriptionsGET / POSTListet aktive Add-Ons auf oder bucht ein wiederkehrendes Add-On-Abonnement (request payload).
/api/v1/billing/add-on-service-requestsPOSTÜbermittelt eine betreute Einrichtungsanfrage (request payload) für benutzerdefiniertes White-Label-DNS oder Zertifikats-Onboarding.
/api/v1/billing/promotions/validatePOSTValidiert einen Aktionscode (request payload) für einen Zieltarif und eine Währung.

Konsolidierte Abrechnungsübersicht abrufen

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

Antwort-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
  }
}

Aktionscode validieren (POST /api/v1/billing/promotions/validate)

Prüfen Sie per request payload ({ code, planId?, billingInterval?: 'monthly' | 'annual', currency?: 'EUR' | 'USD' }), ob ein Gutscheincode auf den gewählten Tarif und Zyklus anwendbar ist. Die Antwort liefert IPromotionEligibilityDecision (samt Verhalten bei Tarifwechsel gemäß 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
}

Weiterführende Dokumentation

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.