Skip to content
Guide du centre d'aide · Forfaits & utilisation
4 min de lectureVérifié 2026-11-16

Tarifs & formules d'abonnement

Comparez Free (5 passes), Starter, Growth, Scale 10K et Enterprise en EUR/USD avec 20 % d'économie annuelle.

Dans ce guide

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

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : CATALOGUE D'ABONNEMENTS, OPTIONS & PROMOTIONS
ÉTAPE 01 COUCHE D'ABONNEMENT ET DE CATALOGUE
Forfaits de base
GET/billing/plans (Free, Starter, Growth,
Scale 10K, Enterprise)
Options modulaires
GET/billing/addons (Packs de passes suppl.
Domaines marque blanc)
Promos & Accords
POST/billing/ promotions/validate (PricingAgreement`)
ÉTAPE 02 AGRÉGATEUR DE VUE D'ENSEMBLE ET DE CAPACITÉ
GET/api/v1/billing/overview & GET/api/v1/billing/subscription
effectiveActivePassLimit = Limite de base + Capacité des options actives
softCreatedPassThreshold = effectiveActivePassLimit * 5
Fonctionnalités débloquées (Domaines perso, SMTP perso, Débit API, RBAC)

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 forfaitCapacité de passes actifsFacturation mensuelle (EUR / USD)Facturation annuelle (~20 % d'économie)Cas d'usage cibles et droits principaux
Free5 passes actifs0 € / \$0Gratuit à viePrototypage en bac à sable, conception visuelle de modèles, tests en direct sur appareils Apple/Google et évaluation de l'API REST.
Starter200 passes actifs16 € / \$22 /mois~20 % de remiseProgrammes de fidélité pour un point de vente unique, clubs boutiques, lancements de magasins pilotes et jumelage de scanners Web/mobiles.
Growth2 000 passes actifs120 € / \$180 /mois~20 % de remiseFidélité retail multi-établissements, séries d'événements récurrents, workflows CRM automatisés et webhooks Push/Pull.
Scale 10K10 000 passes actifs400 € / \$700 /mois~20 % de remiseChaînes hôtelières à fort volume, parcs et attractions régionaux, rôles RBAC personnalisés et pipelines API à haut débit.
Enterprise10 001+ passes actifsSur mesureAccord 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 terminaisonVerbe HTTPDescription
/api/v1/billing/plansGETRenvoie les forfaits d'abonnement actifs, les tarifs en EUR/USD, la BillingFrequency et les droits aux fonctionnalités inclus.
/api/v1/billing/subscriptionGETRenvoie l'abonnement actif (subscription status), le cycle de facturation et currentPeriodEnd.
/api/v1/billing/overviewGETCombine 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/addonsGETListe les options en libre-service disponibles (packs de capacité, options de domaines personnalisés).
/api/v1/billing/add-on-subscriptionsGET / POSTListe les options actives ou rattache un abonnement récurrent à une option (request payload).
/api/v1/billing/add-on-service-requestsPOSTSoumet 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/validatePOSTValide un code promotionnel (request payload) par rapport à un forfait et une devise cibles.

Interrogation de la vue d'ensemble consolidée de la facturation

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

Charge utile de réponse (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
  }
}

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) :

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
}

Documentation connexe

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.