Descripción general
Configurar una cuenta de Passinstance inicializa su espacio de trabajo aislado por inquilino, establece sus preferencias regionales y le guía por un proceso automatizado de incorporación para generar pases de demostración listos para probar en Apple Wallet y Google Wallet.
Flujo de incorporación y máquina de estados
Passinstance gestiona la inicialización de la cuenta mediante una máquina de estados automatizada OnboardingSession respaldada por el controlador Onboarding API:
Pasos y enums de incorporación
La sesión avanza a través de los valores exactos del enum OnboardingStep:
-
1
WALLET_SETUP: Revise y acepte los términos de emisión de pases de la plataforma (googleWalletAccepted) y prepare las credenciales de demostración predeterminadas. -
2
PERSONALIZE: Seleccione su modelo de negocio y el tramo mensual previsto de volumen:
- EVALUATING: Pruebas de capacidades y exploración en entorno de pruebas. - UP_TO_500: Tiendas boutique, clubes locales y recintos especializados. - RANGE_500_5000: Comercios en crecimiento, gimnasios regionales y eventos medianos. - RANGE_5000_25000: Franquicias multisede y grandes asociaciones de socios. - RANGE_25000_PLUS / ENTERPRISE: Venta de entradas de alto volumen, fidelización minorista nacional y pases de aerolíneas o transporte.
-
3
GENERATING_DEMOS: El backend encola trabajos en segundo plano que aprovisionan plantillas de demostración en todas las categorías deOnboardingUseCase(LOYALTY_AND_CUSTOMER_CARDS,MEMBERSHIP_CARDS,TICKETING,VOUCHERS_OR_COUPONS,GIFT_CARDS_OR_PREPAID_CARDS,BUSINESS_CARDS,EMPLOYEE_IDS,INSURANCE_WARRANTY_AND_SERVICE_CARDS,OTHER). -
4
TRY_PASS: Genera un pase de muestra efímero con un código QR escaneable para instalarlo al instante en el teléfono. -
5
DONE: Finaliza la incorporación y desbloquea el panel administrativo completo (/dashboard).
Referencia de la API del controlador de incorporación
Los desarrolladores y scripts de aprovisionamiento automatizado pueden ejecutar la incorporación por código bajo /api/v1/onboarding:
| Ruta del endpoint | Método | Auth | Payload / Parámetros | Descripción |
|---|---|---|---|---|
/api/v1/onboarding | GET | Bearer | Ninguno | Recupera el estado actual de la sesión de incorporación, el paso activo y las demos generadas. |
/api/v1/onboarding/wallet-setup | PUT | Bearer | { "googleWalletAccepted": true } | Acepta las condiciones de emisión de pases y aprovisiona la configuración predeterminada de Google Wallet. |
/api/v1/onboarding/personalize | PUT | Bearer | { expectedPassVolume, useCases: [] } | Guarda el tramo de volumen empresarial y los elementos OnboardingUseCase seleccionados. |
/api/v1/onboarding/demos | POST | Bearer | Ninguno | Inicia la generación asíncrona de plantillas de demostración (QUEUED -> READY). |
/api/v1/onboarding/demos | GET | Bearer | Ninguno | Consulta el progreso de generación de demostraciones entre los casos de uso solicitados. |
/api/v1/onboarding/demos/:type/retry | POST | Bearer | Parámetro URL :type | Reintenta la generación de la plantilla de demostración si falló un tipo concreto del catálogo. |
/api/v1/onboarding/sample-pass | POST | Bearer | { templateId? } | Genera un pase de prueba en vivo para su instalación inmediata en el monedero. |
/api/v1/onboarding/sample-pass/public/:sessionId | GET | Ninguna | Parámetro URL :sessionId | Endpoint público sin autenticación para ver o instalar el pase de muestra en móvil. |
/api/v1/onboarding/complete | POST | Bearer | { skipSamplePass?: boolean } | Marca la sesión de incorporación como DONE. |
Lista de verificación de configuración de la cuenta
Siga estos hitos en Passinstance Dashboard para preparar su espacio de trabajo antes del lanzamiento a producción:
-
1
Verificar espacio de trabajo y correo electrónico: Confirme su dirección de correo electrónico al registrarse (cualquier correo válido es compatible) para establecer sus credenciales administrativas de inquilino, preconfiguradas con un certificado Apple de demostración y un emisor gestionado de Google Wallet.
-
2
Configurar ajustes regionales: Visite Configuración -> General (
/settings/workspace/general) o llame aPUT /api/v1/customer/:customerId/regional-settingspara configurar:
- Zona horaria: Evalúa los límites diarios de escaneo y las marcas de tiempo locales (por ejemplo, Europe/Berlin, America/New_York). - Moneda: Establece la divisa ISO 4217 predeterminada para saldos prepago (por ejemplo, EUR, USD, GBP). - Idioma predeterminado: Define el idioma principal para los campos localizados del monedero.
-
3
Configurar el certificado de Apple Wallet (Producción): En Configuración -> Wallet -> Certificados de Apple (
/settings/workspace/wallet), genere una solicitud de firma de certificado (CSR) mediantePOST /api/v1/certificates/generate-csr, súbala al Apple Developer Portal bajo Pass Type IDs e importe el archivo.cerfirmado mediantePOST /api/v1/certificates. -
4
Configurar el emisor de Google Wallet (Producción): En Configuración -> Wallet -> Google Wallet, ejecute la configuración (
POST /api/v1/google-wallet/setup) y compruebe el estado (GET /api/v1/google-wallet/status) para revisar su Google Issuer ID y sucollectorIdde Smart Tap. -
5
Roles del equipo y control de acceso: En Configuración -> Acceso -> Miembros y roles (
/settings/workspace/access), invite a su equipo usando roles de organización (OrganizationMemberRole:OWNER,ADMIN,MEMBER) junto con roles RBAC del espacio de trabajo (DEFAULT_ROLES:super-admin,admin,editor,user,customer) y exija la autenticación en dos factores (enforceTwoFactorAuth).
Requisitos previos: Para emitir pases de producción con su marca personalizada en Apple Wallet, necesita una suscripción activa al Apple Developer Program (99 USD/año) con la que generar un certificado Apple Pass Type ID (
pass.com.yourcompany.app). Las pruebas realizadas en el entorno sandbox de incorporación utilizan certificados de demostración de Passinstance.
Revise nuestros Planes y niveles de capacidad disponibles o pase directamente a la Fase 2: Diseñar su pase.
