Skip to content
Helpcentrum-gids
3 min leestijdGecontroleerd 2026-11-16

Contact met support

Mail support@passinstance.com met sjabloon-UUID en serienummer voor de snelste diagnose.

In deze gids

Ondersteuningskanalen en diagnostische telemetrie

Wanneer u technische ondersteuning, begeleiding bij de onboarding of incidenttriage nodig hebt, stelt het meesturen van gestructureerde diagnostische ID's het ondersteuningsteam van Passinstance in staat om uw exacte API-verzoek, achtergrondtaak of wallet-callback onmiddellijk te traceren.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
SYSTEEMARCHITECTUURSTROOM: ONDERSTEUNINGSAANVRAAG & GEZONDHEIDSTELEMETRIE
FASE 01 OPENBARE ONDERSTEUNINGSAANVRAAG (Support Intake API)
POST/api/v1/contact: Dient een ondersteunings-/commercieel ticket in
POST/api/v1/contact/subscribe: Abonneert op productrelease-updates
FASE 02 SYSTEEMGEZONDHEIDS- & GEREEDHEIDSPROBES (Health Check API — Prefixvrij)
GET/health/liveness: Liveness van Node.js-proces & event-loop
GET/health/readiness: Connectiviteit met Encrypted Database & Cache Layer
GET/health/detailed: Diepe controle (DB, in-memory cache, Google Wallet API, background job queue Mailer, Circuit Breakers)

Vereiste diagnostische ID's voor een snelle oplossing

Neem de volgende ID's (indien van toepassing) op in uw ondersteuningsticket, zodat engineers logboeken direct kunnen correleren zonder vertraging door heen-en-weer gemail:

Diagnostische IDVoorbeeldformaatWaar u deze vindt
Request Correlation ID (requestId)req_8f192b0e4c12Geretourneerd in elke JSON-foutpayload van API Error Handler en in de x-request-id-antwoordheader.
Template ID (templateId) & bundleId8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2bWeergegeven in de URL van de sjablooneditor of geretourneerd door GET /api/v1/templates (bundleId = Apple passTypeIdentifier).
Pass Serial / externalIdPASS-2026-99412Zichtbaar op de achterkant van de wallet-pas, in de tabel Passen of in passSnapshot in the scan response.
Webhook ID (webhookId)wh_55a9c102e4b1Meegezonden in de HTTP-header X-Webhook-Id bij uitgaande push-webhooks of opgevraagd via GET /webhook-payload.
Client-OS & browseriOS 18.2 Safari / Android 15 ChromeHandig bij het diagnosticeren van problemen met het downloaden van passen of het installeren in de wallet door pashouders.

Belangrijk: Stuur nooit onbewerkte API-sleutels (pi_live_...), scannersleutels, accountwachtwoorden of wachtwoorden van Apple .p12-certificaten mee in ondersteuningsmails of tickets. Engineers van Passinstance hebben uw geheime sleutels nooit nodig om uw werkruimte te inspecteren.

Openbare eindpunten voor contact en operationele gezondheid

Integrators en monitoringsystemen communiceren met Support Intake API (/api/v1/contact*) en de prefixvrije Health Check API (/health*):

EindpuntpadMethodeAuthBeschrijving
/api/v1/contactPOSTPublicDient een gestructureerde ondersteunings- of verkoopvraag in (name, email, company, message).
/api/v1/contact/subscribePOSTPublicAbonneert een e-mailadres op platformreleases en operationele aankondigingen.
/healthGETPublicStandaard gezondheidscontrole die de gereedheid van de kern-database en -in-memory cache verifieert.
/health/livenessGETPublicLichtgewicht liveness-probe voor containers die de responsiviteit van de HTTP-server bevestigt.
/health/readinessGETPublicVerifieert de gereedheid van de databasepool en cache voordat inkomend verkeer wordt geaccepteerd.
/health/detailedGETBearer / OpsRetourneert de gedetailleerde subsysteemstatus voor Database, in-memory cache, Google Wallet API, achtergrondwachtrijen, Mailer en webhook-Circuit Breakers.

Voorbeeld: Gedetailleerde subsysteemgezondheid inspecteren (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 }
  }
}

Een ondersteuningsvraag indienen via de 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)."
}

Voor directe zelfbedieningsdiagnostiek raadpleegt u Probleemoplossing en veelgestelde vragen en Bekende problemen en beperkingen.

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.