Skip to content
Help Center Guide
3 min readVerified 2026-11-16

Contact Support

Reach the Passinstance team (support@passinstance.com) with the right diagnostic IDs (Template UUID, Pass Serial, Trace ID) for fast resolution.

In This Guide

Support Channels & Diagnostic Telemetry

When you need engineering assistance, onboarding guidance, or incident triage, reaching out with structured diagnostic identifiers allows the Passinstance support team to trace your exact API request, background job, or wallet callback immediately.

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
SUPPORT INTAKE & HEALTH TELEMETRY
STAGE 01 PUBLIC SUPPORT INTAKE (Support Intake API)
POST/api/v1/contact: Submits support/commercial ticket
POST/api/v1/contact/subscribe: Subscribes to product release updates
STAGE 02 SYSTEM HEALTH & READINESS PROBES (Health Check API — Prefix-Free)
GET/health/liveness: Node.js process & event-loop liveness
GET/health/readiness: Database & cache service readiness
GET/health/detailed: Deep check (DB, in-memory cache, Google Wallet API, background job queue Mailer, Circuit Breakers)

Required Diagnostic Identifiers for Fast Resolution

Include the following identifiers (when applicable) in your support ticket so engineers can correlate logs without back-and-forth delays:

Diagnostic IdentifierExample FormatWhere to Find It
Request Correlation ID (requestId)req_8f192b0e4c12Returned in every API Error Handler JSON error payload and x-request-id response header.
Template ID (templateId) & bundleId8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2bDisplayed in the Template Editor URL or returned by GET /api/v1/templates (bundleId = Apple passTypeIdentifier).
Pass Serial / externalIdPASS-2026-99412Shown on the back of the wallet pass, in the Passes table, or in passSnapshot in the scan response.
Webhook ID (webhookId)wh_55a9c102e4b1Sent in the X-Webhook-Id HTTP header on outbound push webhooks or queried via GET /webhook-payload.
Client OS & BrowseriOS 18.2 Safari / Android 15 ChromeHelpful when diagnosing passholder download or wallet installation issues.

Important: Never send raw API keys (pi_live_...), scanner keys, account passwords, or Apple .p12 certificate passwords in support emails or tickets. Passinstance engineers never require your secret keys to inspect your workspace.

Public Contact & Operational Health Endpoints

Integrators and monitoring systems interact with Support Intake API (/api/v1/contact*) and prefix-free Health Check API (/health*):

Endpoint PathMethodAuthDescription
/api/v1/contactPOSTPublicSubmits a structured support or sales inquiry (name, email, company, message).
/api/v1/contact/subscribePOSTPublicSubscribes an email address to platform release and operational announcements.
/healthGETPublicStandard health check verifying core database and in-memory cache readiness.
/health/livenessGETPublicLightweight container liveness probe confirming HTTP server responsiveness.
/health/readinessGETPublicVerifies database pool and cache readiness before accepting ingress traffic.
/health/detailedGETBearer / OpsReturns granular subsystem status across Database, in-memory cache, Google Wallet API, background job queues, Mailer, and webhook Circuit Breakers.

Example: Inspecting Detailed Subsystem Health (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 }
  }
}

Submitting a Support Inquiry 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)."
}

For immediate self-service diagnostics, check Troubleshooting & FAQs and Known Issues & Limitations.

Related Product & Developer Documentation

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.