Skip to content
Guida del Centro assistenza · Piani e utilizzo
4 min di letturaVerificato 2026-11-16

Prezzi e piani di abbonamento

Confronta Free (5 pass), Starter, Growth, Scale 10K ed Enterprise in EUR/USD con sconto annuale del 20%.

In questa guida

Panoramica

Passinstance offre fasce di abbonamento trasparenti a capacità fissa, misurate rigorosamente sui Pass attivi nel wallet, ovvero i pass attualmente installati e raggiungibili sui dispositivi dei clienti. Grazie a Billing API (/api/v1/billing/*) e alla sezione Impostazioni -> Fatturazione (/settings/billing/overview, /add-ons, /payment-method, /invoices), i workspace possono sottoscrivere un abbonamento in EUR (€) o USD (\$) con diverse frequenze BillingFrequency (Monthly, Yearly con un risparmio annuale di circa il 20%), associare componenti aggiuntivi modulari e convalidare codici sconto promozionali.

Architettura di misurazione degli abbonamenti e dei componenti aggiuntivi

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
CATALOGO ABBONAMENTI, ADD-ON E MOTORE PROMOZIONI
FASE 01 LIVELLO ABBONAMENTI E CATALOGO
Piani a capacità base
GET/billing/plans (Free, Starter, Growth,
Scale 10K, Enterprise)
Add-on modulari
GET/billing/addons (Pacchetti pass extra,
Domini White-Label)
Promo e accordi
POST/billing/ promotions/validate (PricingAgreement`)
FASE 02 PANORAMICA FATTURAZIONE E AGGREGATORE DI CAPACITÀ
GET/api/v1/billing/overview e GET/api/v1/billing/subscription
effectiveActivePassLimit = Limite piano base + Capacità pass add-on attivi
softCreatedPassThreshold = effectiveActivePassLimit * 5
Funzionalità sbloccate (Domini personalizzati, SMTP custom, livelli API, RBAC)

Importante: Può consultare in qualsiasi momento le definizioni aggiornate dei piani e le funzionalità incluse nella pagina /pricing o a livello programmatico tramite GET /api/v1/billing/plans. Gli enti non-profit e le istituzioni educative hanno diritto a sconti ricorrenti personalizzati: consulti Idoneità e vantaggi.

Fasce di abbonamento a capacità fissa

Fascia del pianoCapacità di pass attivi nel walletFatturazione mensile (EUR / USD)Fatturazione annuale (~20% di risparmio)Casi d'uso di riferimento e funzionalità principali incluse
Free5 pass attivi€0 / \$0Gratuito per semprePrototipazione in sandbox, progettazione visiva dei modelli, test dal vivo su dispositivi Apple/Google e valutazione delle API REST.
Starter200 pass attivi€16 / \$22 /mese~20% di scontoProgrammi fedeltà per singolo punto vendita, club boutique, lanci pilota in negozio e associazione dello scanner web/mobile.
Growth2.000 pass attivi€120 / \$180 /mese~20% di scontoProgrammi fedeltà retail multi-sede, serie di eventi ricorrenti, flussi di lavoro CRM automatizzati e webhook Push/Pull.
Scale 10K10.000 pass attivi€400 / \$700 /mese~20% di scontoCatene dell'ospitalità ad alto volume, attrazioni regionali, ruoli RBAC personalizzati e pipeline API ad alta capacità.
Enterprise10.001+ pass attiviSu misuraContratto personalizzatoGruppi aziendali multi-brand, SSO SAML 2.0, SLA dedicati, fasce PricingAgreement personalizzate e portali white-label.

Abbonamenti base, componenti aggiuntivi e codici promozionali (Billing API)

Passinstance separa il piano di abbonamento base dagli abbonamenti ai componenti aggiuntivi modulari, in modo da consentirLe di espandere funzionalità specifiche (come i domini personalizzati white-label o blocchi aggiuntivi di pass attivi) senza dover passare a un contratto enterprise completo.

Endpoint API principali per piani e add-on ed enumerazioni di stato

I record Subscription tracciano lo stato tramite subscription status (ACTIVE, INACTIVE, EXPIRED, CANCELLED, SUSPENDED, TRIALING, PAST_DUE, GRACE_PERIOD, RESTRICTED, CANCEL_AT_PERIOD_END, UNPAID, ARCHIVED) e i cicli di fatturazione tramite BillingFrequency (Monthly, Yearly):

EndpointVerbo HTTPDescrizione
/api/v1/billing/plansGETRestituisce i piani di abbonamento attivi, i prezzi in EUR/USD, la BillingFrequency e le abilitazioni funzionali incluse.
/api/v1/billing/subscriptionGETRestituisce l'abbonamento attivo (subscription status), il ciclo di fatturazione e currentPeriodEnd.
/api/v1/billing/overviewGETCombina il piano base, gli abbonamenti agli add-on, i contatori di utilizzo in tempo reale e l'anteprima della prossima fattura.
/api/v1/billing/addonsGETElenca i componenti aggiuntivi self-service disponibili (pacchetti di capacità, add-on per domini vanity personalizzati).
/api/v1/billing/add-on-subscriptionsGET / POSTElenca gli add-on attivi o associa un abbonamento ricorrente a un componente aggiuntivo (request payload).
/api/v1/billing/add-on-service-requestsPOSTInvia una richiesta di configurazione gestita (request payload) per l'onboarding di DNS white-label personalizzati o certificati.
/api/v1/billing/promotions/validatePOSTConvalida un codice promozionale (request payload) rispetto a un piano e a una valuta di destinazione.

Interrogazione della panoramica consolidata di fatturazione

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

Payload di risposta (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
  }
}

Convalida di un codice promozionale (POST /api/v1/billing/promotions/validate)

Verifichi se un codice promozionale è applicabile alla fascia e all'intervallo di fatturazione selezionati utilizzando request payload ({ code, planId?, billingInterval?: 'monthly' | 'annual', currency?: 'EUR' | 'USD' }), che restituisce IPromotionEligibilityDecision (oltre alla cumulabilità regolata da 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
}

Documentazione correlata

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.