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.
-
Mesa de Soporte Directo: support@passinstance.com
-
Formulario Web de Admisión: Contactar con Passinstance
-
Admisión Guiada para Pilotos y Organizaciones sin Fines de Lucro: Solicitar un Piloto
-
Registro de Cambios del Producto: Notas de la Versión
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óstico | Formato de Ejemplo | Dónde Encontrarlo |
|---|---|---|
ID de Correlación de Solicitud (requestId) | req_8f192b0e4c12 | Devuelto 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 bundleId | 8b3c4d5e-1122-4334-9a8b-7c6d5e4f3a2b | Se 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 / externalId | PASS-2026-99412 | Se muestra en el reverso del pase de billetera, en la tabla Pases o en passSnapshot in the scan response. |
ID de Webhook (webhookId) | wh_55a9c102e4b1 | Enviado en el encabezado HTTP X-Webhook-Id en los webhooks push salientes o consultado mediante GET /webhook-payload. |
| SO y Navegador del Cliente | iOS 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.p12de 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 Endpoint | Método | Autenticación | Descripción |
|---|---|---|---|
/api/v1/contact | POST | Público | Envía una consulta estructurada de soporte o ventas (name, email, company, message). |
/api/v1/contact/subscribe | POST | Público | Suscribe una dirección de correo electrónico a anuncios operativos y de lanzamientos de la plataforma. |
/health | GET | Público | Comprobación de salud estándar que verifica la disponibilidad principal de database y in-memory cache. |
/health/liveness | GET | Público | Sonda ligera de actividad del contenedor que confirma la capacidad de respuesta del servidor HTTP. |
/health/readiness | GET | Público | Verifica la disponibilidad del grupo de conexiones de la base de datos y de la caché antes de aceptar tráfico de entrada. |
/health/detailed | GET | Bearer / Ops | Devuelve 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)
{
"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)
{
"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.
