Supportkanäle & Diagnosetelemetrie
Wenn Sie technische Unterstützung, Begleitung beim Onboarding oder Hilfe bei der Störungsanalyse benötigen, ermöglicht die Angabe strukturierter Diagnosekennungen dem Passinstance-Supportteam, Ihre genaue API-Anfrage, Ihren Hintergrund-Job oder Ihren Wallet-Callback sofort nachzuverfolgen.
-
Direkter Support-Desk: support@passinstance.com
-
Web-Kontaktformular: Passinstance kontaktieren
-
Begleitetes Pilotprogramm & Anfrage für Gemeinnützige: Pilotprojekt anfragen
-
Produkt-Changelog: Versionshinweise
Erforderliche Diagnosekennungen für eine schnelle Lösung
Geben Sie (sofern zutreffend) die folgenden Kennungen in Ihrem Support-Ticket an, damit unsere Ingenieure Protokolle ohne Rückfragen direkt korrelieren können:
| Diagnosekennung | Beispielformat | Wo Sie diese finden |
|---|---|---|
Anfrage-Korrelations-ID (requestId) | req_8f192b0e4c12 | Wird in jedem JSON-Fehler-Payload des API Error Handler sowie im Antwort-Header x-request-id zurückgegeben. |
Vorlagen-ID (templateId) & bundleId | 8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2b | Wird in der URL des Vorlagen-Editors angezeigt oder von GET /api/v1/templates zurückgegeben (bundleId = Apple passTypeIdentifier). |
Karten-Seriennummer / externalId | PASS-2026-99412 | Auf der Rückseite der Wallet-Karte, in der Kartentabelle oder in passSnapshot in the scan response zu finden. |
Webhook-ID (webhookId) | wh_55a9c102e4b1 | Wird im HTTP-Header X-Webhook-Id bei ausgehenden Push-Webhooks mitgesendet oder über GET /webhook-payload abgefragt. |
| Client-Betriebssystem & Browser | iOS 18.2 Safari / Android 15 Chrome | Hilfreich bei der Diagnose von Problemen beim Herunterladen durch Karteninhaber oder bei der Wallet-Installation. |
Wichtig: Senden Sie niemals unverschlüsselte API-Schlüssel (
pi_live_...), Scannerschlüssel, Kontopasswörter oder Passwörter für Apple-.p12-Zertifikate in Support-E-Mails oder Tickets. Passinstance-Ingenieure benötigen niemals Ihre geheimen Schlüssel, um Ihren Workspace zu überprüfen.
Öffentliche Kontakt- & Betriebszustands-Endpunkte
Integratoren und Überwachungssysteme interagieren mit dem Support Intake API (/api/v1/contact*) und dem präfixfreien Health Check API (/health*):
| Endpunktpfad | Methode | Authentifizierung | Beschreibung |
|---|---|---|---|
/api/v1/contact | POST | Öffentlich | Übermittelt eine strukturierte Support- oder Vertriebsanfrage (name, email, company, message). |
/api/v1/contact/subscribe | POST | Öffentlich | Meldet eine E-Mail-Adresse für Plattform-Versionshinweise und Betriebsankündigungen an. |
/health | GET | Öffentlich | Standard-Zustandsprüfung zur Verifizierung der Betriebsbereitschaft von database und in-memory cache. |
/health/liveness | GET | Öffentlich | Leichtgewichtige Container-Liveness-Probe, die die Reaktionsfähigkeit des HTTP-Servers bestätigt. |
/health/readiness | GET | Öffentlich | Prüft die Bereitschaft von Datenbank-Pool und Cache, bevor eingehender Datenverkehr angenommen wird. |
/health/detailed | GET | Bearer / Ops | Gibt den detaillierten Subsystemstatus für Datenbank, in-memory cache, Google Wallet API, Hintergrund-Warteschlangen, Mailer und Webhook-Circuit-Breaker zurück. |
Beispiel: Detaillierten Subsystemzustand prüfen (GET /health/detailed)
{
"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 }
}
}
Supportanfrage per API einreichen (POST /api/v1/contact)
{
"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)."
}
Für eine sofortige Self-Service-Diagnose lesen Sie Fehlerbehebung & FAQs sowie Bekannte Probleme & Einschränkungen.
