Skip to content
Hilfecenter-Anleitung
2 Min. LesezeitGeprüft 2026-11-16

Support kontaktieren

Erreichen Sie support@passinstance.com mit den passenden Diagnose-IDs (Template-UUID, Seriennummer) für schnelle Lösung.

In dieser Anleitung

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.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
SUPPORT-ANNAHME & SYSTEMZUSTANDS-TELEMETRIE
STUFE 01 ÖFFENTLICHE SUPPORT-ANNAHME (Support Intake API)
POST/api/v1/contact: Übermittelt Support-/Vertriebsticket
POST/api/v1/contact/subscribe: Abonniert Produkt-Release-Updates
STUFE 02 SYSTEMZUSTANDS- & BEREITSCHAFTS-PROBES (Health Check API — ohne Präfix)
GET/health/liveness: Node.js-Prozess- & Event-Loop-Liveness
GET/health/readiness: database-16- & in-memory cache-7-Konnektivität
GET/health/detailed: Tiefenprüfung (DB, in-memory cache, Google Wallet API, background job queue Mailer, Circuit Breakers)

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:

DiagnosekennungBeispielformatWo Sie diese finden
Anfrage-Korrelations-ID (requestId)req_8f192b0e4c12Wird in jedem JSON-Fehler-Payload des API Error Handler sowie im Antwort-Header x-request-id zurückgegeben.
Vorlagen-ID (templateId) & bundleId8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2bWird in der URL des Vorlagen-Editors angezeigt oder von GET /api/v1/templates zurückgegeben (bundleId = Apple passTypeIdentifier).
Karten-Seriennummer / externalIdPASS-2026-99412Auf der Rückseite der Wallet-Karte, in der Kartentabelle oder in passSnapshot in the scan response zu finden.
Webhook-ID (webhookId)wh_55a9c102e4b1Wird im HTTP-Header X-Webhook-Id bei ausgehenden Push-Webhooks mitgesendet oder über GET /webhook-payload abgefragt.
Client-Betriebssystem & BrowseriOS 18.2 Safari / Android 15 ChromeHilfreich 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*):

EndpunktpfadMethodeAuthentifizierungBeschreibung
/api/v1/contactPOSTÖffentlichÜbermittelt eine strukturierte Support- oder Vertriebsanfrage (name, email, company, message).
/api/v1/contact/subscribePOSTÖffentlichMeldet eine E-Mail-Adresse für Plattform-Versionshinweise und Betriebsankündigungen an.
/healthGETÖffentlichStandard-Zustandsprüfung zur Verifizierung der Betriebsbereitschaft von database und in-memory cache.
/health/livenessGETÖffentlichLeichtgewichtige Container-Liveness-Probe, die die Reaktionsfähigkeit des HTTP-Servers bestätigt.
/health/readinessGETÖffentlichPrüft die Bereitschaft von Datenbank-Pool und Cache, bevor eingehender Datenverkehr angenommen wird.
/health/detailedGETBearer / OpsGibt 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)

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 }
  }
}

Supportanfrage per API einreichen (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)."
}

Für eine sofortige Self-Service-Diagnose lesen Sie Fehlerbehebung & FAQs sowie Bekannte Probleme & Einschränkungen.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.