Skip to content
Guida del Centro assistenza
3 min di letturaVerificato 2026-11-16

Contattare il supporto

Scrivi a support@passinstance.com indicando UUID modello e seriale pass per una diagnosi veloce.

In questa guida

Canali di supporto e telemetria diagnostica

Quando necessita di assistenza tecnica, guida all'onboarding o analisi di un incidente, contattarci fornendo identificativi diagnostici strutturati consente al team di supporto di Passinstance di rintracciare immediatamente l'esatta richiesta API, il processo in background o il callback del wallet.

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
RICEZIONE RICHIESTE DI SUPPORTO E TELEMETRIA DI SALUTE
FASE 01 RICEZIONE SUPPORTO PUBBLICO (Support Intake API)
POST/api/v1/contact: invia un ticket di supporto o commerciale
POST/api/v1/contact/subscribe: iscrive agli aggiornamenti di rilascio
FASE 02 SONDE DI SALUTE E PRONTEZZA DEL SISTEMA (Health Check API — Senza prefisso)
GET/health/liveness: vitalità del processo Node.js e dell'event-loop
GET/health/readiness: connettività encrypted database e in-memory cache
GET/health/detailed: controllo approfondito (DB, in-memory cache, API Google Wallet, background job queue Mailer, Circuit Breaker)

Identificativi diagnostici richiesti per una risoluzione rapida

Includa i seguenti identificativi (ove applicabile) nel Suo ticket di supporto affinché i tecnici possano correlare i log senza ritardi dovuti a ulteriori scambi di messaggi:

Identificativo diagnosticoFormato di esempioDove trovarlo
ID di correlazione della richiesta (requestId)req_8f192b0e4c12Restituito in ogni payload di errore JSON di API Error Handler e nell'header di risposta x-request-id.
ID del modello (templateId) e bundleId8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2bVisualizzato nell'URL dell'Editor di modelli o restituito da GET /api/v1/templates (bundleId = passTypeIdentifier di Apple).
Seriale del pass / externalIdPASS-2026-99412Mostrato sul retro del pass nel wallet, nella tabella dei pass o in passSnapshot in the scan response.
ID del webhook (webhookId)wh_55a9c102e4b1Inviato nell'header HTTP X-Webhook-Id sui webhook push in uscita o interrogato tramite GET /webhook-payload.
Sistema operativo e browser del clientiOS 18.2 Safari / Android 15 ChromeUtile per diagnosticare problemi di download del titolare del pass o di installazione nel wallet.

Importante: Non invii mai chiavi API in chiaro (pi_live_...), chiavi dello scanner, password dell'account o password dei certificati .p12 di Apple nelle email o nei ticket di supporto. I tecnici di Passinstance non richiedono mai le Sue chiavi segrete per ispezionare il Suo workspace.

Endpoint pubblici di contatto e salute operativa

Gli integratori e i sistemi di monitoraggio interagiscono con Support Intake API (/api/v1/contact*) e con Health Check API senza prefisso (/health*):

Percorso EndpointMetodoAutenticazioneDescrizione
/api/v1/contactPOSTPubblicoInvia una richiesta strutturata di supporto o commerciale (name, email, company, message).
/api/v1/contact/subscribePOSTPubblicoIscrive un indirizzo email agli annunci di rilascio e operativi della piattaforma.
/healthGETPubblicoControllo di salute standard che verifica la prontezza di base di database e in-memory cache.
/health/livenessGETPubblicoSonda leggera di vitalità del container che conferma la reattività del server HTTP.
/health/readinessGETPubblicoVerifica la prontezza del pool di database e della cache prima di accettare il traffico in ingresso.
/health/detailedGETBearer / OpsRestituisce lo stato granulare dei sottosistemi tra Database, in-memory cache, API Google Wallet, code di lavoro in background, Mailer e Circuit Breaker dei webhook.

Esempio: ispezione dettagliata della salute dei sottosistemi (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 }
  }
}

Invio di una richiesta di supporto tramite 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)."
}

Per una diagnostica self-service immediata, consulti Risoluzione dei problemi e domande frequenti e Problemi noti e limitazioni.

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.