Skip to content
Guia da Central de Ajuda · Planos e utilização
3 min de leituraVerificado 2026-11-16

Preços e planos de subscrição

Compare Free (5 passes), Starter, Growth, Scale 10K e Enterprise em EUR/USD com 20% de desconto anual.

Neste guia

Visão geral

O Passinstance oferece níveis de subscrição transparentes de capacidade fixa medidos estritamente por Cartões Ativos em Wallet—cartões atualmente instalados e contactáveis nos dispositivos dos clientes. Suportados por Billing API (/api/v1/billing/*) e acessíveis em Definições -> Faturação (/settings/billing/overview, /add-ons, /payment-method, /invoices), os espaços de trabalho podem subscrever em EUR (€) ou USD (\$) em BillingFrequency (Monthly, Yearly com ~20% de poupança anual), adicionar extras modulares e validar códigos promocionais.

Arquitetura de Medição de Subscrições e Add-Ons

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
CATÁLOGO DE SUBSCRIÇÕES, ADD-ONS E MOTOR PROMOCIONAL
ETAPA 01 CAMADA DE SUBSCRIÇÃO E CATÁLOGO
Planos Capacidade Base
GET/billing/plans (Free, Starter, Growth,
Scale 10K, Enterprise)
Extras Modulares
GET/billing/addons (Pacotes cartões extra,
Domínios marca branca)
Promos e Acordos
POST/billing/ promotions/validate (PricingAgreement`)
ETAPA 02 RESUMO DE FATURAÇÃO E AGREGADOR DE CAPACIDADE
GET/api/v1/billing/overview e GET/api/v1/billing/subscription
effectiveActivePassLimit = Limite Plano Base + Capacidade Add-On Ativa
softCreatedPassThreshold = effectiveActivePassLimit * 5
Feature Flags Desbloqueadas (Domínios Próprios, SMTP, Taxa API, RBAC)

Importante: Pode consultar definições e funcionalidades dos planos em direto a qualquer momento em /pricing ou programaticamente via GET /api/v1/billing/plans. Organizações sem fins lucrativos e instituições de ensino qualificam-se para descontos recorrentes personalizados—consulte Elegibilidade e Benefícios.

Níveis de Subscrição de Capacidade Fixa

Nível do PlanoCapacidade de Cartões AtivosFaturação Mensal (EUR / USD)Faturação Anual (~20% Poupança)Casos de Uso e Direitos Principais
Free5 cartões ativos€0 / \$0Gratuito para semprePrototipagem em sandbox, design visual de modelos, testes em direto Apple/Google e avaliação da API REST.
Starter200 cartões ativos€16 / \$22 /mês~20% descontoProgramas de fidelização de localização única, clubes boutique, lojas-piloto e emparelhamento scanner web/móvel.
Growth2.000 cartões ativos€120 / \$180 /mês~20% descontoFidelização retalhista multiloja, séries de eventos recorrentes, fluxos CRM automatizados e webhooks Push/Pull.
Scale 10K10.000 cartões ativos€400 / \$700 /mês~20% descontoCadeias hoteleiras de elevado volume, atrações regionais, funções RBAC personalizadas e pipelines API de alto débito.
Enterprise10.001+ cartões ativosPersonalizadoAcordo PersonalizadoGrupos multimarca, SAML 2.0 SSO, SLAs dedicados, patamares PricingAgreement e portais white-label.

Subscrições Base, Add-Ons e Códigos Promocionais (Billing API)

O Passinstance separa o plano de subscrição base das subscrições de extras (add-ons) modulares para que possa expandir capacidades específicas (como domínios personalizados marca branca ou blocos adicionais de cartões ativos) sem passar diretamente para um contrato Enterprise completo.

Endpoints Principais de Planos/Add-Ons e Enumerações de Estado

Os registos Subscription monitorizam o estado em subscription status (ACTIVE, INACTIVE, EXPIRED, CANCELLED, SUSPENDED, TRIALING, PAST_DUE, GRACE_PERIOD, RESTRICTED, CANCEL_AT_PERIOD_END, UNPAID, ARCHIVED) e os ciclos em BillingFrequency (Monthly, Yearly):

EndpointVerbo HTTPDescrição
/api/v1/billing/plansGETDevolve planos de subscrição ativos, preços em EUR/USD, BillingFrequency e funcionalidades incluídas.
/api/v1/billing/subscriptionGETDevolve a subscrição ativa (subscription status), ciclo de faturação e currentPeriodEnd.
/api/v1/billing/overviewGETCombina plano base, subscrições add-on, contadores de consumo em tempo real e pré-visualização da próxima fatura.
/api/v1/billing/addonsGETLista add-ons disponíveis em self-service (pacotes de capacidade, extras de domínio personalizado).
/api/v1/billing/add-on-subscriptionsGET / POSTLista add-ons ativos ou associa uma subscrição recorrente (request payload).
/api/v1/billing/add-on-service-requestsPOSTSubmete um pedido de configuração assistida (request payload) para DNS marca branca ou certificados.
/api/v1/billing/promotions/validatePOSTValida um código promocional (request payload) para um plano e moeda específicos.

Consultar Resumo Consolidado de Faturação

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

Payload de Resposta (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
  }
}

Validar um Código Promocional (POST /api/v1/billing/promotions/validate)

Valide se um código promocional se aplica ao nível e frequência escolhidos através de request payload ({ code, planId?, billingInterval?: 'monthly' | 'annual', currency?: 'EUR' | 'USD' }), devolvendo IPromotionEligibilityDecision (e regras de acumulação sob 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
}

Documentação Relacionada

Documentação de produto e API relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.