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
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
| Pakketniveau | Actieve Wallet-pascapaciteit | Maandelijkse facturatie (EUR / USD) | Jaarlijkse facturatie (~20% voordeel) | Doelgroepen & kernrechten |
|---|---|---|---|---|
| Free | 5 actieve passen | €0 / \$0 | Altijd gratis | Sandbox-prototyping, visueel sjabloonontwerp, live Apple/Google-apparaattests en REST API-evaluatie. |
| Starter | 200 actieve passen | €16 / \$22 /mnd | ~20% korting | Loyaliteitsprogramma's voor één locatie, boetiekclubs, pilotwinkels en web-/mobiele scannerkoppeling. |
| Growth | 2.000 actieve passen | €120 / \$180 /mnd | ~20% korting | Multi-locatie retailloyaliteit, terugkerende evenementenreeksen, geautomatiseerde CRM-workflows en Push/Pull-webhooks. |
| Scale 10K | 10.000 actieve passen | €400 / \$700 /mnd | ~20% korting | Grote horecaketens, regionale attracties, aangepaste RBAC-rollen en high-throughput API-pijplijnen. |
| Enterprise | 10.001+ actieve passen | Op maat | Maatwerkovereenkomst | Multi-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):
| Endpoint | HTTP-methode | Beschrijving |
|---|---|---|
/api/v1/billing/plans | GET | Retourneert actieve abonnementen, tarieven in EUR/USD, BillingFrequency en inbegrepen functierechten. |
/api/v1/billing/subscription | GET | Retourneert het actieve abonnement (subscription status), facturatiecyclus en currentPeriodEnd. |
/api/v1/billing/overview | GET | Combineert basisplan, add-on-abonnementen, realtime verbruiksmeters en voorvertoning van komende factuur. |
/api/v1/billing/addons | GET | Toont beschikbare selfservice add-ons (capaciteitspakketten, custom vanity domain add-ons). |
/api/v1/billing/add-on-subscriptions | GET / POST | Toont actieve add-ons of voegt een terugkerend add-on-abonnement toe (request payload). |
/api/v1/billing/add-on-service-requests | POST | Dient een beheerde configuratie-aanvraag in (request payload) voor maatwerk white-label DNS of certificaatbegeleiding. |
/api/v1/billing/promotions/validate | POST | Valideert een promotiecode (request payload) voor het geselecteerde doelplan en de valuta. |
Geconsolideerd facturatieoverzicht opvragen
GET /api/v1/billing/overview HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Antwoordpayload (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
}
}
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):
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
}
Gerelateerde documentatie
-
Lees hoe het verbruik van actieve passen wordt gemeten in Actieve passen & verbruikslimieten.
-
Bekijk pro-rata voorvertoningen of wijzig abonnementen in Abonnementwijzigingen & opzegging.
