Ü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
Wichtig: Live-Tarifdefinitionen und Funktionsumfänge können jederzeit auf /pricing oder programmatisch über
GET /api/v1/billing/planseingesehen werden. Gemeinnützige Organisationen und Bildungseinrichtungen erhalten individuelle wiederkehrende Rabatte — siehe Berechtigung & Vorteile.
Abonnement-Stufen mit fester Kapazität
| Tarifstufe | Aktive Wallet-Pass-Kapazität | Monatliche Abrechnung (EUR / USD) | Jährliche Abrechnung (~20 % Ersparnis) | Ziel-Anwendungsfälle & Kernfunktionen |
|---|---|---|---|---|
| Free | 5 aktive Pässe | €0 / \$0 | Dauerhaft kostenlos | Sandbox-Prototyping, visuelles Vorlagendesign, Live-Gerätetests auf Apple/Google sowie REST-API-Evaluierung. |
| Starter | 200 aktive Pässe | €16 / \$22 /Monat | ~20 % Rabatt | Einzelstandort-Treueprogramme, Boutique-Clubs, Pilot-Filialstarts und Kopplung von Web-/Mobile-Scannern. |
| Growth | 2.000 aktive Pässe | €120 / \$180 /Monat | ~20 % Rabatt | Filialübergreifende Kundenbindung, Event-Serien, automatisierte CRM-Workflows sowie Push-/Pull-Webhooks. |
| Scale 10K | 10.000 aktive Pässe | €400 / \$700 /Monat | ~20 % Rabatt | Große Hospitality-Ketten, Freizeitparks, benutzerdefinierte RBAC-Rollen und Hochdurchsatz-API-Pipelines. |
| Enterprise | 10.001+ aktive Pässe | Individuell | Individueller Vertrag | Mehrmarken-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):
| Endpunkt | HTTP-Verb | Beschreibung |
|---|---|---|
/api/v1/billing/plans | GET | Liefert aktive Abonnementtarife, Preise in EUR/USD, BillingFrequency und enthaltene Funktionsberechtigungen. |
/api/v1/billing/subscription | GET | Liefert das aktive Abonnement (subscription status), Abrechnungszyklus und currentPeriodEnd. |
/api/v1/billing/overview | GET | Kombiniert Basistarif, Add-On-Abonnements, Echtzeit-Nutzungszähler und Vorschau der nächsten Rechnung. |
/api/v1/billing/addons | GET | Listet verfügbare Self-Service-Add-Ons auf (Kapazitätspakete, Custom Vanity Domain Add-ons). |
/api/v1/billing/add-on-subscriptions | GET / POST | Listet aktive Add-Ons auf oder bucht ein wiederkehrendes Add-On-Abonnement (request payload). |
/api/v1/billing/add-on-service-requests | POST | Übermittelt eine betreute Einrichtungsanfrage (request payload) für benutzerdefiniertes White-Label-DNS oder Zertifikats-Onboarding. |
/api/v1/billing/promotions/validate | POST | Validiert einen Aktionscode (request payload) für einen Zieltarif und eine Währung. |
Konsolidierte Abrechnungsübersicht abrufen
GET /api/v1/billing/overview HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Antwort-Payload (200 OK)
{
"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):
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"
}
{
"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
-
Wie der Verbrauch aktiver Pässe gemessen wird, erfahren Sie in Aktive Pässe & Nutzungslimits.
-
Proration vorausschauen sowie Tarife hochstufen oder kündigen in Tarifwechsel & Kündigung.
