Skip to content
Guia da Central de Ajuda
3 min de leituraVerificado 2026-11-16

Contactar o suporte

Contacte support@passinstance.com enviando o UUID do modelo e número de série para diagnóstico imediato.

Neste guia

Canais de Suporte e Telemetria de Diagnóstico

Quando necessitar de assistência de engenharia, orientação de integração ou triagem de incidentes, contactar-nos com identificadores de diagnóstico estruturados permite que a equipa de suporte do Passinstance rastreie imediatamente o seu pedido exato de API, tarefa em segundo plano ou callback da carteira.

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
ADMISSÃO DE SUPORTE E TELEMETRIA DE SAÚDE
ETAPA 01 ADMISSÃO PÚBLICA DE SUPORTE (Support Intake API)
POST/api/v1/contact: Submete pedido de suporte/comercial
POST/api/v1/contact/subscribe: Subscreve atualizações de versões
ETAPA 02 SONDAS DE SAÚDE E PRONTIDÃO DO SISTEMA (Health Check API — Sem Prefixo)
GET/health/liveness: Disponibilidade do processo Node.js e event-loop
GET/health/readiness: Conectividade encrypted database e in-memory cache
GET/health/detailed: Verificação profunda (BD, in-memory cache, API Google Wallet, background job queue Mailer, Disjuntores)

Identificadores de Diagnóstico Necessários para Resolução Rápida

Inclua os seguintes identificadores (quando aplicável) no seu pedido de suporte para que os engenheiros possam correlacionar registos sem atrasos de comunicação:

Identificador de DiagnósticoFormato de ExemploOnde Encontrar
ID de Correlação do Pedido (requestId)req_8f192b0e4c12Devolvido em todos os payloads de erro JSON de API Error Handler e no cabeçalho de resposta x-request-id.
ID do Modelo (templateId) e bundleId8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2bApresentado no URL do Editor de Modelos ou devolvido por GET /api/v1/templates (bundleId = passTypeIdentifier da Apple).
Número de Série do Passe / externalIdPASS-2026-99412Apresentado no verso do passe na carteira, na tabela de Passes ou em passSnapshot in the scan response.
ID do Webhook (webhookId)wh_55a9c102e4b1Enviado no cabeçalho HTTP X-Webhook-Id nos webhooks push de saída ou consultado através de GET /webhook-payload.
Sistema Operativo e Navegador do ClienteiOS 18.2 Safari / Android 15 ChromeÚtil ao diagnosticar problemas de transferência pelo titular do passe ou de instalação na carteira.

Importante: Nunca envie chaves de API brutas (pi_live_...), chaves de leitor, palavras-passe de conta ou palavras-passe de certificados .p12 da Apple em e-mails ou pedidos de suporte. Os engenheiros do Passinstance nunca necessitam das suas chaves secretas para inspecionar o seu espaço de trabalho.

Endpoints Públicos de Contacto e Saúde Operacional

Os integradores e sistemas de monitorização interagem com Support Intake API (/api/v1/contact*) e com Health Check API sem prefixo (/health*):

Caminho do EndpointMétodoAutenticaçãoDescrição
/api/v1/contactPOSTPúblicaSubmete um pedido estruturado de suporte ou comercial (name, email, company, message).
/api/v1/contact/subscribePOSTPúblicaSubscreve um endereço de e-mail para anúncios de versões e operações da plataforma.
/healthGETPúblicaVerificação de saúde padrão que confirma a prontidão principal do database e do in-memory cache.
/health/livenessGETPúblicaSonda ligeira de atividade do contentor que confirma a capacidade de resposta do servidor HTTP.
/health/readinessGETPúblicaVerifica a prontidão do conjunto de ligações à base de dados e da cache antes de aceitar tráfego de entrada.
/health/detailedGETBearer / OpsDevolve o estado granular dos subsistemas na Base de Dados, in-memory cache, API Google Wallet, filas de tarefas em segundo plano, Mailer e Disjuntores de webhooks.

Exemplo: Inspecionar a Saúde Detalhada dos Subsistemas (GET /health/detailed)

JSON
{
  "status": "ok",
  "timestamp": "2026-11-15T22:30:00.000Z",
  "components": {
    "database": { "status": "up", "latencyMs": 3 },
    "cache": { "status": "up", "latencyMs": 1 },
    "googleWalletApi": { "status": "up" },
    "jobQueue": { "status": "up", "activeJobs": 4 },
    "mailer": { "status": "up" },
    "circuitBreakers": { "openWebhooks": 0 }
  }
}

Submeter um Pedido de Suporte via API (POST /api/v1/contact)

JSON
{
  "name": "Marcus Vance",
  "email": "marcus@retailops.example.com",
  "company": "Vance Retail Group",
  "message": "Investigating webhook circuit breaker cooldown on webhookId wh_55a9c102e4b1 (requestId: req_8f192b0e4c12)."
}

Para diagnósticos imediatos em autoatendimento, consulte Resolução de Problemas e Perguntas Frequentes e Problemas Conhecidos e Limitações.

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.