Skip to content
Guía del Centro de ayuda · Inicio rápido
5 min de lecturaVerificado 2026-11-16

Configurar tu cuenta

Crea tu espacio de trabajo, define los datos de tu empresa y prepara los requisitos previos de firma.

En esta guía

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:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
MÁQUINA DE ESTADOS DE INCORPORACIÓN
ETAPA 01 WALLET_SETUP
Aceptar términos y preparar Google
ETAPA 02 PERSONALIZE
Elegir volumen y catálogo de casos
ETAPA 03 GENERATING_DEMOS
Trabajo asíncrono backgro crea 17 plantillas
ETAPA 02A DONE
Listo para prod.; lanzar plantillas
ETAPA 02B TRY_PASS
Escanear pase de prueba iOS/Android
ETAPA 02C GENERATING_DEMOS
La generación en 2.º plano termina el catál.

Pasos y enums de incorporación

La sesión avanza a través de los valores exactos del enum OnboardingStep:

  1. 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. 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.

  1. 3
    GENERATING_DEMOS: El backend encola trabajos en segundo plano que aprovisionan plantillas de demostración en todas las categorías de OnboardingUseCase (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).
  2. 4
    TRY_PASS: Genera un pase de muestra efímero con un código QR escaneable para instalarlo al instante en el teléfono.
  3. 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 endpointMétodoAuthPayload / ParámetrosDescripción
/api/v1/onboardingGETBearerNingunoRecupera el estado actual de la sesión de incorporación, el paso activo y las demos generadas.
/api/v1/onboarding/wallet-setupPUTBearer{ "googleWalletAccepted": true }Acepta las condiciones de emisión de pases y aprovisiona la configuración predeterminada de Google Wallet.
/api/v1/onboarding/personalizePUTBearer{ expectedPassVolume, useCases: [] }Guarda el tramo de volumen empresarial y los elementos OnboardingUseCase seleccionados.
/api/v1/onboarding/demosPOSTBearerNingunoInicia la generación asíncrona de plantillas de demostración (QUEUED -> READY).
/api/v1/onboarding/demosGETBearerNingunoConsulta el progreso de generación de demostraciones entre los casos de uso solicitados.
/api/v1/onboarding/demos/:type/retryPOSTBearerParámetro URL :typeReintenta la generación de la plantilla de demostración si falló un tipo concreto del catálogo.
/api/v1/onboarding/sample-passPOSTBearer{ templateId? }Genera un pase de prueba en vivo para su instalación inmediata en el monedero.
/api/v1/onboarding/sample-pass/public/:sessionIdGETNingunaParámetro URL :sessionIdEndpoint público sin autenticación para ver o instalar el pase de muestra en móvil.
/api/v1/onboarding/completePOSTBearer{ 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. 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. 2
    Configurar ajustes regionales: Visite Configuración -> General (/settings/workspace/general) o llame a PUT /api/v1/customer/:customerId/regional-settings para 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.

  1. 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) mediante POST /api/v1/certificates/generate-csr, súbala al Apple Developer Portal bajo Pass Type IDs e importe el archivo .cer firmado mediante POST /api/v1/certificates.
  2. 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 su collectorId de Smart Tap.
  3. 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.

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.