Skip to content
Guía del Centro de ayuda
3 min de lecturaVerificado 2026-11-16

Contactar con soporte

Escribe a support@passinstance.com indicando UUID de plantilla y número de serie para agilizar la ayuda.

En esta guía

Canales de Soporte y Telemetría de Diagnóstico

Cuando necesite asistencia de ingeniería, orientación para la incorporación o clasificación de incidentes, comunicarse con identificadores de diagnóstico estructurados permite al equipo de soporte de Passinstance rastrear de inmediato su solicitud exacta de API, trabajo en segundo plano o callback de billetera.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
ADMISIÓN DE SOPORTE Y TELEMETRÍA DE SALUD
ETAPA 01 ADMISIÓN PÚBLICA DE SOPORTE (Support Intake API)
POST/api/v1/contact: Envía un ticket comercial o de soporte
POST/api/v1/contact/subscribe: Suscribe a actualizaciones del producto
ETAPA 02 SONDAS DE SALUD Y DISPONIBILIDAD (Health Check API — Sin Prefijo)
GET/health/liveness: Actividad del proceso Node.js y del bucle de eventos
GET/health/readiness: Conectividad de encrypted database y in-memory cache
GET/health/detailed: Comprobación profunda (BD, in-memory cache, Google Wallet API, background job queue Mailer, Disyuntores)

Identificadores de Diagnóstico Requeridos para una Resolución Rápida

Incluya los siguientes identificadores (cuando corresponda) en su ticket de soporte para que los ingenieros puedan correlacionar los registros sin demoras:

Identificador de DiagnósticoFormato de EjemploDónde Encontrarlo
ID de Correlación de Solicitud (requestId)req_8f192b0e4c12Devuelto en cada carga útil JSON de error de API Error Handler y en el encabezado de respuesta x-request-id.
ID de Plantilla (templateId) y bundleId8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2bSe muestra en la URL del Editor de Plantillas o lo devuelve GET /api/v1/templates (bundleId = passTypeIdentifier de Apple).
Número de Serie del Pase / externalIdPASS-2026-99412Se muestra en el reverso del pase de billetera, en la tabla Pases o en passSnapshot in the scan response.
ID de Webhook (webhookId)wh_55a9c102e4b1Enviado en el encabezado HTTP X-Webhook-Id en los webhooks push salientes o consultado mediante GET /webhook-payload.
SO y Navegador del ClienteiOS 18.2 Safari / Android 15 ChromeÚtil para diagnosticar problemas de descarga o instalación en la billetera del titular.

Importante: Nunca envíe claves de API sin procesar (pi_live_...), claves de escáner, contraseñas de cuentas ni contraseñas de certificados .p12 de Apple en correos electrónicos o tickets de soporte. Los ingenieros de Passinstance nunca necesitan sus claves secretas para inspeccionar su espacio de trabajo.

Endpoints Públicos de Contacto y Salud Operativa

Los integradores y los sistemas de monitoreo interactúan con Support Intake API (/api/v1/contact*) y con Health Check API sin prefijo (/health*):

Ruta del EndpointMétodoAutenticaciónDescripción
/api/v1/contactPOSTPúblicoEnvía una consulta estructurada de soporte o ventas (name, email, company, message).
/api/v1/contact/subscribePOSTPúblicoSuscribe una dirección de correo electrónico a anuncios operativos y de lanzamientos de la plataforma.
/healthGETPúblicoComprobación de salud estándar que verifica la disponibilidad principal de database y in-memory cache.
/health/livenessGETPúblicoSonda ligera de actividad del contenedor que confirma la capacidad de respuesta del servidor HTTP.
/health/readinessGETPúblicoVerifica la disponibilidad del grupo de conexiones de la base de datos y de la caché antes de aceptar tráfico de entrada.
/health/detailedGETBearer / OpsDevuelve el estado granular de los subsistemas en la Base de Datos, in-memory cache, Google Wallet API, colas de trabajos en segundo plano, Mailer y Disyuntores de webhooks.

Ejemplo: Inspección Detallada de la Salud de los Subsistemas (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 }
  }
}

Envío de una Consulta de Soporte mediante la 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)."
}

Para diagnósticos inmediatos de autoservicio, consulte Solución de Problemas y Preguntas Frecuentes y Problemas Conocidos y Limitaciones.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.