Présentation
Passinstance propose des paliers d'abonnement transparents à capacité fixe, mesurés strictement sur les passes de portefeuille actifs — c'est-à-dire les passes actuellement installés et joignables sur les appareils des clients. Propulsés par Billing API (/api/v1/billing/*) et accessibles sous Settings -> Billing (/settings/billing/overview, /add-ons, /payment-method, /invoices), les espaces de travail peuvent souscrire en EUR (€) ou en USD (\$) selon une périodicité BillingFrequency (Monthly, Yearly avec environ 20 % d'économie annuelle), rattacher des options modulaires et valider des codes promotionnels de réduction.
Architecture de mesure des abonnements et des options
Important : Vous pouvez inspecter à tout moment les définitions des forfaits en direct et les droits aux fonctionnalités sur /pricing ou par programmation via
GET /api/v1/billing/plans. Les organisations à but non lucratif et les établissements d'enseignement bénéficient de remises récurrentes personnalisées — consultez Éligibilité et avantages.
Paliers d'abonnement à capacité fixe
| Palier de forfait | Capacité de passes actifs | Facturation mensuelle (EUR / USD) | Facturation annuelle (~20 % d'économie) | Cas d'usage cibles et droits principaux |
|---|---|---|---|---|
| Free | 5 passes actifs | 0 € / \$0 | Gratuit à vie | Prototypage en bac à sable, conception visuelle de modèles, tests en direct sur appareils Apple/Google et évaluation de l'API REST. |
| Starter | 200 passes actifs | 16 € / \$22 /mois | ~20 % de remise | Programmes de fidélité pour un point de vente unique, clubs boutiques, lancements de magasins pilotes et jumelage de scanners Web/mobiles. |
| Growth | 2 000 passes actifs | 120 € / \$180 /mois | ~20 % de remise | Fidélité retail multi-établissements, séries d'événements récurrents, workflows CRM automatisés et webhooks Push/Pull. |
| Scale 10K | 10 000 passes actifs | 400 € / \$700 /mois | ~20 % de remise | Chaînes hôtelières à fort volume, parcs et attractions régionaux, rôles RBAC personnalisés et pipelines API à haut débit. |
| Enterprise | 10 001+ passes actifs | Sur mesure | Accord personnalisé | Groupes d'entreprises multimarques, SSO SAML 2.0, SLA dédiés, paliers PricingAgreement sur mesure et portails en marque blanche. |
Abonnements de base, options complémentaires et codes promotionnels (Billing API)
Passinstance sépare votre forfait d'abonnement de base des abonnements aux options modulaires afin que vous puissiez étendre des capacités spécifiques (telles que des domaines personnalisés en marque blanche ou des blocs supplémentaires de passes actifs) sans devoir passer à un contrat Enterprise complet.
Principaux points de terminaison API de forfaits/options et énumérations de statut
Les enregistrements Subscription suivent le statut via subscription status (ACTIVE, INACTIVE, EXPIRED, CANCELLED, SUSPENDED, TRIALING, PAST_DUE, GRACE_PERIOD, RESTRICTED, CANCEL_AT_PERIOD_END, UNPAID, ARCHIVED) et les cycles de facturation via BillingFrequency (Monthly, Yearly) :
| Point de terminaison | Verbe HTTP | Description |
|---|---|---|
/api/v1/billing/plans | GET | Renvoie les forfaits d'abonnement actifs, les tarifs en EUR/USD, la BillingFrequency et les droits aux fonctionnalités inclus. |
/api/v1/billing/subscription | GET | Renvoie l'abonnement actif (subscription status), le cycle de facturation et currentPeriodEnd. |
/api/v1/billing/overview | GET | Combine le forfait de base, les abonnements aux options, les compteurs d'utilisation en temps réel et l'aperçu de la prochaine facture. |
/api/v1/billing/addons | GET | Liste les options en libre-service disponibles (packs de capacité, options de domaines personnalisés). |
/api/v1/billing/add-on-subscriptions | GET / POST | Liste les options actives ou rattache un abonnement récurrent à une option (request payload). |
/api/v1/billing/add-on-service-requests | POST | Soumet une demande de configuration gérée (request payload) pour l'intégration DNS en marque blanche ou de certificats personnalisés. |
/api/v1/billing/promotions/validate | POST | Valide un code promotionnel (request payload) par rapport à un forfait et une devise cibles. |
Interrogation de la vue d'ensemble consolidée de la facturation
GET /api/v1/billing/overview HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Charge utile de réponse (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
}
}
Validation d'un code promotionnel (POST /api/v1/billing/promotions/validate)
Vérifiez si un code promotionnel s'applique au palier et à la périodicité de facturation sélectionnés à l'aide de request payload ({ code, planId?, billingInterval?: 'monthly' | 'annual', currency?: 'EUR' | 'USD' }), ce qui renvoie IPromotionEligibilityDecision (ainsi que les règles de cumul régies par 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
}
Documentation connexe
-
Comprenez comment la consommation de passes actifs est mesurée dans Passes actifs et limites d'utilisation.
-
Prévisualisez le prorata et mettez à niveau ou résiliez vos forfaits dans Modifications de forfait et résiliation.
