Skip to content
Guide du centre d'aide
3 min de lectureVérifié 2026-11-16

Contacter le support

Écrivez à support@passinstance.com avec l'UUID du modèle et le numéro de série pour une résolution rapide.

Dans ce guide

Canaux de support et télémétrie de diagnostic

Lorsque vous avez besoin d'une assistance technique, d'un accompagnement à l'intégration ou du traitement d'un incident, le fait de nous contacter en fournissant des identifiants de diagnostic structurés permet à l'équipe de support Passinstance de retracer immédiatement votre requête API exacte, votre tâche en arrière-plan ou votre callback de portefeuille.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
FLUX D'ARCHITECTURE SYSTÈME : RÉCEPTION DU SUPPORT ET TÉLÉMÉTRIE DE SANTÉ
ÉTAPE 01 RÉCEPTION PUBLIQUE DU SUPPORT (Support Intake API)
POST/api/v1/contact : Soumet un ticket de support ou commercial
POST/api/v1/contact/subscribe : Abonne aux mises à jour de versions
ÉTAPE 02 SONDES DE SANTÉ ET DE DISPONIBILITÉ (Health Check API — Sans préfixe)
GET/health/liveness : Vivacité du processus Node.js et de l'event-loop
GET/health/readiness : Connectivité encrypted database et in-memory cache
GET/health/detailed : Vérification approfondie (DB, in-memory cache, API Google Wallet, background job queue Mailer, Disjoncteurs)

Identifiants de diagnostic requis pour une résolution rapide

Incluez les identifiants suivants (le cas échéant) dans votre ticket de support afin que nos ingénieurs puissent corréler les journaux sans échanges supplémentaires :

Identifiant de diagnosticExemple de formatOù le trouver
ID de corrélation de requête (requestId)req_8f192b0e4c12Renvoyé dans chaque charge utile d'erreur JSON API Error Handler et dans l'en-tête de réponse x-request-id.
ID de modèle (templateId) & bundleId8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2bAffiché dans l'URL de l'éditeur de modèles ou renvoyé par GET /api/v1/templates (bundleId = passTypeIdentifier Apple).
Numéro de série du pass / externalIdPASS-2026-99412Affiché au verso du pass dans le portefeuille, dans le tableau Passes ou dans passSnapshot in the scan response.
ID de webhook (webhookId)wh_55a9c102e4b1Envoyé dans l'en-tête HTTP X-Webhook-Id sur les webhooks sortants ou consulté via GET /webhook-payload.
OS et navigateur du clientiOS 18.2 Safari / Android 15 ChromeUtile lors du diagnostic de problèmes de téléchargement ou d'installation dans le portefeuille d'un détenteur de pass.

Important : N'envoyez jamais de clés API brutes (pi_live_...), de clés de scanner, de mots de passe de compte ou de mots de passe de certificats Apple .p12 dans vos e-mails ou tickets de support. Les ingénieurs de Passinstance n'ont jamais besoin de vos clés secrètes pour inspecter votre espace de travail.

Points de terminaison publics de contact et de santé opérationnelle

Les intégrateurs et les systèmes de supervision interagissent avec Support Intake API (/api/v1/contact*) et Health Check API sans préfixe (/health*) :

Chemin du point de terminaisonMéthodeAuthDescription
/api/v1/contactPOSTPublicSoumet une demande structurée de support ou commerciale (name, email, company, message).
/api/v1/contact/subscribePOSTPublicAbonne une adresse e-mail aux annonces de nouvelles versions et aux communications opérationnelles de la plateforme.
/healthGETPublicVérification de santé standard contrôlant la disponibilité de base de database et in-memory cache.
/health/livenessGETPublicSonde légère de vivacité du conteneur confirmant la réactivité du serveur HTTP.
/health/readinessGETPublicVérifie la disponibilité du pool de base de données et du cache avant d'accepter le trafic entrant.
/health/detailedGETBearer / OpsRenvoie l'état granulaire des sous-systèmes pour la base de données, in-memory cache, l'API Google Wallet, les files de tâches en arrière-plan, le Mailer et les disjoncteurs de webhooks.

Exemple : Inspection détaillée de la santé des sous-systèmes (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 }
  }
}

Soumission d'une demande de support via l'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)."
}

Pour un autodiagnostic immédiat, consultez Dépannage et FAQ ainsi que Problèmes connus et limitations.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.