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
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 plan | Capacidad de pases activos | Facturación mensual (EUR / USD) | Facturación anual (~20 % de ahorro) | Casos de uso y derechos clave |
|---|---|---|---|---|
| Free | 5 pases activos | €0 / \$0 | Gratis para siempre | Pruebas en sandbox, diseño visual de plantillas, validación en vivo Apple/Google y evaluación REST API. |
| Starter | 200 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. |
| Growth | 2.000 pases activos | €120 / \$180 /mes | ~20 % dto. | Fidelización multitienda, series de eventos recurrentes, flujos CRM automatizados y webhooks Push/Pull. |
| Scale 10K | 10.000 pases activos | €400 / \$700 /mes | ~20 % dto. | Cadenas hoteleras de gran volumen, atracciones regionales, roles RBAC propios y pipelines API de alto rendimiento. |
| Enterprise | 10.001+ pases activos | Personalizado | Acuerdo personalizado | Grupos 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):
| Endpoint | Verbo HTTP | Descripción |
|---|---|---|
/api/v1/billing/plans | GET | Devuelve planes de suscripción activos, tarifas en EUR/USD, BillingFrequency y derechos incluidos. |
/api/v1/billing/subscription | GET | Devuelve la suscripción activa (subscription status), ciclo de facturación y currentPeriodEnd. |
/api/v1/billing/overview | GET | Combina plan base, complementos activos, medidores de uso en tiempo real y vista previa de la próxima factura. |
/api/v1/billing/addons | GET | Lista complementos de autoservicio disponibles (paquetes de capacidad, dominio personalizado). |
/api/v1/billing/add-on-subscriptions | GET / POST | Lista complementos activos o añade una suscripción recurrente (request payload). |
/api/v1/billing/add-on-service-requests | POST | Envía una solicitud de configuración gestionada (request payload) para DNS de marca blanca o certificados. |
/api/v1/billing/promotions/validate | POST | Valida un código promocional (request payload) para un plan y divisa concretos. |
Consultar resumen consolidado de facturación
GET /api/v1/billing/overview HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Payload de respuesta (200 OK)
{
"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):
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"
}
{
"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
-
Comprenda cómo se mide el consumo en Pases activos y límites de uso.
-
Previsualice el prorrateo y mejore o cancele planes en Cambios de plan y cancelación.
