Skip to content
Guia da Central de Ajuda · Visão geral do painelFase de integração 6
3 min de leituraVerificado 2026-11-16

Compreender a sua área de trabalho

Interprete KPIs, saúde dos passes, cartões Ativos vs. Não instalados e isolamento multi-cliente.

Neste guia

Inspecione capturas de ecrã exatas do painel e detalhes ampliados relacionados com este guia.

Foco ampliado da interface
Elementos-chave da interface

Saúde dos cartões e ações recomendadas (Zoom)

Acompanhe a proporção entre cartões ativos e não instalados em Pass health e atue sobre as recomendações automáticas para dar seguimento aos cartões que aguardam instalação.

Saúde do espaço de trabalho e telemetria em direto

Cada conta Passinstance opera dentro de um espaço de trabalho tenant estritamente particionado. Todos os ativos criados num espaço de trabalho — incluindo modelos visuais, certificados criptográficos de assinatura, propriedades personalizadas, registos de passes dos clientes, segredos de API e histórico de leituras em ponto de venda — estão associados ao ID do seu espaço de trabalho (customerId) e completamente isolados de outras organizações.

Resumo de saúde dos passes e cartão de ações
Resumo de saúde dos passes e cartão de ações

Arquitetura multi-tenant e hierarquia do espaço de trabalho

A Passinstance implementa uma hierarquia organizacional em dois níveis que separa a governação de faturação da conta da gestão diária de passes:

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
HIERARQUIA MULTI-TENANT
ETAPA 01 ORGANIZAÇÃO (Nível de Conta)
Modelo Passinstance database: Organization
Perfis (OrganizationMemberRole): OWNER, ADMIN, MEMBER
Quotas Centralizadas do Plano de Subscrição e Faturação Stripe Consolidada
ETAPA 02 Espaços de Trabalho 1:N
ESPAÇO DE TRABALHO PRODUÇÃO
Registo Customer: cust_prod_901
Kind: production
Apple .p12 Produção e Auth Google
Carteiras e Scanners Clientes Reais
Consome Quota Ativa em Carteira
ESPAÇO DE TRABALHO SANDBOX
Registo Customer: cust_sbx_902
Kind: sandbox
Assinatura Demo e Passes de Teste
Ambiente de Testes Isolado
Impacto Zero nos Limites do Plano

Gerir espaços de trabalho irmãos via API Organization

As equipas que gerem várias marcas, contas de clientes ou ambientes sandbox podem interagir com o Organizations API:

Caminho do endpointMétodoAutenticaçãoFuncionalidade
/api/v1/organizations/currentGETBearerDevolve a organização ativa, os perfis de membros e a lista de espaços de trabalho irmãos acessíveis.
/api/v1/organizations/current/billing-summaryGETBearerConsolidação dos limites do plano e contagens acumuladas de passes ativos em todos os espaços de trabalho.
/api/v1/organizations/current/workspacesPOSTBearerCria um novo espaço de trabalho irmão (`kind: "production" \"sandbox"`).
/api/v1/organizations/current/workspaces/switchPOSTBearerAlterna o contexto de tenant ativo e roda os cookies de sessão de autenticação.

Taxonomia das principais métricas de telemetria

Para monitorizar o seu programa de passes com precisão, a Passinstance distingue entre a criação do registo no servidor e a instalação física na carteira:

TEXT
Passe Criado (POST /api/v1/passes)  =================>  unclaimedPasses (Não Instalados)
                                                               |
                                                               | Cliente Adiciona à Carteira
                                                               v
Dispositivo Registado (POST /v1/devices/...) =======>  installedDevices (Instalados)
                                                               |
                                                               | Cliente Elimina da Carteira
                                                               v
Dispositivo Anulado (DELETE /v1/devices/...) =======>  inactivePasses / inactiveDeviceRegistrations

Definições de metric-definitions.ts

  • totalPasses (Total Passes Issued): Contagem acumulada de registos de passes ativos gerados no seu espaço de trabalho que não foram eliminados no momento da captura.
  • activePasses (Active Passes): Instâncias de passes ativas que possuem atualmente pelo menos um registo de dispositivo alcançável (excluindo passes expirados e anulados).
  • installedDevices (Active Device Registrations): Registos de passes guardados alcançáveis entre Apple APNs e Google Wallet. Se um passe estiver guardado em dois dispositivos, conta como dois registos ativos e consome capacidade do plano.
  • unclaimedPasses (Unclaimed Passes): Instâncias de passes ativas emitidas na Passinstance que nunca foram guardadas numa carteira.
  • inactivePasses (Removed Passes): Instâncias de passes ativas que foram anteriormente guardadas numa carteira, mas já não possuem registos de dispositivos alcançáveis (incluindo DELETE /v1/devices/... da Apple e callbacks del da Google para /api/v1/wallet/callback).
  • voidedPasses (Voided Passes) e expiredPasses (Expired Passes): Instâncias de passes revogadas no servidor ou após expirationDate.

Definições do espaço de trabalho e configuração regional

Cada espaço de trabalho é configurado de forma independente em Definições -> Espaço de Trabalho (/settings/workspace/*):

  • Definições Gerais e Regionais (PUT /api/v1/customer/:customerId/regional-settings): Configura o fuso horário predefinido (resolveCustomerTimeZone), o código de moeda ISO 4217 predefinido e o idioma.
  • Quotas de Utilização (GET /api/v1/customer/:customerId/usage-summary): Reporta em tempo real o total de passes, passes ativos face a maxActivePasses e contagens de modelos.
  • Domínios Próprios Whitelabel (/api/v1/white-labeling/vanity-urls): Liga domínios personalizados (domain surface type: PASS_DOWNLOAD, PASS_FLOW, BACKEND_UI, etc.) com provisionamento automático de SSL para todas as ligações inteligentes e páginas de download.

Importante: Os espaços de trabalho Sandbox fornecem um ambiente isolado para testar revisões de modelos, webhooks da API e configurações de scanner sem consumir capacidade de passes ativos do seu plano de produção.

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.