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

Precios y planes de suscripción

Compara Free (5 pases), Starter, Growth, Scale 10K y Enterprise en EUR/USD con 20 % de descuento anual.

En esta guía

Descripción general

Passinstance ofrece niveles de suscripción transparentes de capacidad fija medidos estrictamente por Pases activos en Wallet—es decir, pases instalados y accesibles actualmente en dispositivos de clientes. Gestionados por Billing API (/api/v1/billing/*) y accesibles en Configuración -> Facturación (/settings/billing/overview, /add-ons, /payment-method, /invoices), los espacios de trabajo pueden suscribirse en EUR (€) o USD (\$) con BillingFrequency (Monthly, Yearly con ~20 % de ahorro anual), añadir complementos modulares y validar códigos promocionales.

Arquitectura de medición de suscripciones y complementos

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
CATÁLOGO DE SUSCRIPCIONES, ADD-ONS Y PROMOCIONES
ETAPA 01 CAPA DE SUSCRIPCIÓN Y CATÁLOGO
Planes capacidad base
GET/billing/plans (Free, Starter, Growth,
Scale 10K, Enterprise)
Complementos modulares
GET/billing/addons (Paquetes pases extra,
Dominios marca blanca)
Promos y Acuerdos
POST/billing/ promotions/validate (PricingAgreement`)
ETAPA 02 RESUMEN DE FACTURACIÓN Y AGREGADOR DE CAPACIDAD
GET/api/v1/billing/overview y GET/api/v1/billing/subscription
effectiveActivePassLimit = Límite Plan Base + Capacidad Add-On Activa
softCreatedPassThreshold = effectiveActivePassLimit * 5
Funciones desbloqueadas (Dominios propios, SMTP propio, Tasa API, RBAC)

Importante: Puede consultar definiciones y derechos de planes en vivo en cualquier momento en /pricing o por programa vía GET /api/v1/billing/plans. Las entidades sin ánimo de lucro y educativas optan a descuentos recurrentes propios—consulte Elegibilidad y beneficios.

Niveles de suscripción de capacidad fija

Nivel de planCapacidad de pases activosFacturación mensual (EUR / USD)Facturación anual (~20 % de ahorro)Casos de uso y derechos clave
Free5 pases activos€0 / \$0Gratis para siemprePruebas en sandbox, diseño visual de plantillas, validación en vivo Apple/Google y evaluación REST API.
Starter200 pases activos€16 / \$22 /mes~20 % dto.Programas de fidelización de un local, clubes boutique, pilotos en tienda y emparejamiento de escáner web/móvil.
Growth2.000 pases activos€120 / \$180 /mes~20 % dto.Fidelización multitienda, series de eventos recurrentes, flujos CRM automatizados y webhooks Push/Pull.
Scale 10K10.000 pases activos€400 / \$700 /mes~20 % dto.Cadenas hoteleras de gran volumen, atracciones regionales, roles RBAC propios y pipelines API de alto rendimiento.
Enterprise10.001+ pases activosPersonalizadoAcuerdo personalizadoGrupos multimarca, SAML 2.0 SSO, SLAs dedicados, niveles PricingAgreement y portales de marca blanca.

Suscripciones base, complementos y promociones (Billing API)

Passinstance separa su plan de suscripción base de las suscripciones de complementos (add-ons) modulares para ampliar capacidades concretas (como dominios personalizados de marca blanca o bloques adicionales de pases activos) sin saltar a un contrato Enterprise completo.

Endpoints de planes y complementos y enumeraciones de estado

Los registros Subscription reflejan el estado en subscription status (ACTIVE, INACTIVE, EXPIRED, CANCELLED, SUSPENDED, TRIALING, PAST_DUE, GRACE_PERIOD, RESTRICTED, CANCEL_AT_PERIOD_END, UNPAID, ARCHIVED) y los ciclos en BillingFrequency (Monthly, Yearly):

EndpointVerbo HTTPDescripción
/api/v1/billing/plansGETDevuelve planes de suscripción activos, tarifas en EUR/USD, BillingFrequency y derechos incluidos.
/api/v1/billing/subscriptionGETDevuelve la suscripción activa (subscription status), ciclo de facturación y currentPeriodEnd.
/api/v1/billing/overviewGETCombina plan base, complementos activos, medidores de uso en tiempo real y vista previa de la próxima factura.
/api/v1/billing/addonsGETLista complementos de autoservicio disponibles (paquetes de capacidad, dominio personalizado).
/api/v1/billing/add-on-subscriptionsGET / POSTLista complementos activos o añade una suscripción recurrente (request payload).
/api/v1/billing/add-on-service-requestsPOSTEnvía una solicitud de configuración gestionada (request payload) para DNS de marca blanca o certificados.
/api/v1/billing/promotions/validatePOSTValida un código promocional (request payload) para un plan y divisa concretos.

Consultar resumen consolidado de facturación

HTTP
GET /api/v1/billing/overview HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

Payload de respuesta (200 OK)

JSON
{
  "subscription": {
    "id": "sub_019331b2-7e10-7a44-9b00-112233445566",
    "planId": "growth_yearly",
    "planName": "Growth",
    "status": "ACTIVE",
    "interval": "Yearly",
    "currency": "EUR",
    "unitAmount": 115200,
    "currentPeriodStart": "2026-01-15T00:00:00.000Z",
    "currentPeriodEnd": "2027-01-15T00:00:00.000Z",
    "cancelAtPeriodEnd": false
  },
  "addOnSubscriptions": [
    {
      "id": "addsub_019331c0-1122-7d33-8f44-556677889900",
      "addonKey": "white_label_domain",
      "name": "Custom Vanity Domain & Branded Email",
      "status": "ACTIVE",
      "unitAmount": 2900,
      "interval": "Monthly"
    }
  ],
  "capacity": {
    "baseActivePassLimit": 2000,
    "addOnActivePassLimit": 0,
    "effectiveActivePassLimit": 2000,
    "currentActivePasses": 1420,
    "utilizationPercentage": 71.0
  }
}

Validar un código promocional (POST /api/v1/billing/promotions/validate)

Compruebe si un código promocional aplica al nivel e intervalo elegidos usando request payload ({ code, planId?, billingInterval?: 'monthly' | 'annual', currency?: 'EUR' | 'USD' }), que devuelve IPromotionEligibilityDecision (y acumulabilidad regida por promotion policy: PRESERVE | FORFEIT | PRORATE):

HTTP
POST /api/v1/billing/promotions/validate HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "code": "LAUNCH2026",
  "planId": "growth_monthly",
  "billingInterval": "monthly",
  "currency": "EUR"
}
JSON
{
  "isEligible": true,
  "promotionId": "promo_019331ff-2b30-7c11-9a00-112233445566",
  "promotionName": "2026 Launch Offer",
  "publicLabel": "25% off first 6 months",
  "code": "LAUNCH2026",
  "discountType": "PERCENTAGE",
  "discountPercent": 25,
  "durationType": "REPEATING",
  "durationMonths": 6
}

Documentación relacionada

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.