Planes y Precios

Crea hasta 5 planes de precios activos por plugin desde el Portal de Desarrolladores. Define el tipo de precio, intervalo de facturación, período de prueba y lista de características.

Límite de Planes

Cada plugin puede tener un máximo de 5 planes activos en cualquier momento. Puedes desactivar un plan (lo que lo oculta para nuevos suscriptores) sin eliminarlo.

Tipos de Precios

Tipo	Descripción	Estado
`recurring`	Se cobra en ciclo mensual o anual	Disponible
`one_time`	Cargo único — sin facturación continua	Disponible
`usage`	Facturación medida basada en consumo	Próximamente

Intervalos de Facturación

Para planes recurring, elige la cadencia de facturación:

Intervalo	Valor
Mensual	`monthly`
Anual	`annual`

Campos del Plan

Campo	Tipo	Requerido	Descripción
`name`	string	Sí	Nombre del plan que ven los comerciantes
`slug`	string	Sí	Identificador único en formato URL (ej. `starter`, `pro`)
`description`	string	No	Descripción corta de lo que incluye
`price`	decimal	Sí	Precio en unidades monetarias mayores (ej. `29.99`)
`currency`	string	Sí	Código de moneda — actualmente solo USD
`interval`	string	Sí (recurring)	`monthly` o `annual`
`trialDays`	number	No	Duración de la prueba gratuita en días (0–90). Por defecto: 0.
`features`	string[]	No	Lista de características para mostrar en las tarjetas del marketplace
`isPopular`	boolean	No	Destaca el plan como recomendado en la interfaz
`sortOrder`	number	No	Controla el orden de visualización cuando se muestran múltiples planes

Reglas de Prueba Gratuita

Máximo 90 días por prueba
Las pruebas se otorgan solo en la primera suscripción por instalación — reinstalar el plugin no vuelve a otorgar una prueba
Durante la prueba: el comerciante no es cobrado y no se crea ningún ítem de facturación
Cuando termina la prueba: la facturación se activa automáticamente mediante un proceso diario en segundo plano
Si un comerciante cancela durante la prueba: la suscripción termina al expirar la prueba sin ningún cargo

Los planes se crean y gestionan desde el panel del Portal de Desarrolladores. La plataforma gestiona automáticamente la integración con el procesador de pagos cuando guardas un plan — no necesitas crear productos o precios en ningún sistema externo.

Ejemplo de Configuración de Planes

Plan: "Inicial"
  Slug:          starter
  Tipo:          recurring
  Precio:        $9.99 / mes
  Prueba:        14 días
  Características: ["Analíticas básicas", "10 reportes/mes"]

Plan: "Pro"
  Slug:          pro
  Tipo:          recurring
  Precio:        $29.99 / mes
  Prueba:        14 días
  Características: ["Analíticas avanzadas", "Reportes ilimitados", "Exportar CSV"]
  Popular:       true

Plan: "Empresarial"
  Slug:          enterprise
  Tipo:          recurring
  Precio:        $99.99 / mes
  Prueba:        30 días
  Características: ["Todo en Pro", "Dashboards personalizados", "Soporte prioritario"]

Slugs de Plan en el SDK

El slug que defines aquí es el identificador que usas cuando llamas a los métodos de facturación del App Bridge:

// Use the plan slug to request a subscription
await bridge.billing.requestSubscription("pro");

// Use the plan slug to switch plans
await bridge.billing.switchPlan("enterprise");

Los slugs de plan deben ser únicos dentro de tu plugin y son inmutables una vez que el plan tiene suscriptores activos. Crea un nuevo plan y desactiva el anterior si necesitas reestructurar los precios.