Planes
Define precios por ciclo y las cuotas que incluye una suscripción.
Usa billete.plans desde tu servidor. Configura el cliente con el entorno y la clave de tu negocio.
Ejemplo
const plan = await billete.plans.create({
name: "Pro",
currency: "USD",
prices: [{ months: 1, amount: 1000 }, { months: 12, amount: 10000 }],
gracePeriodDays: 3,
}, { idempotencyKey: "plan-pro-example-001" });Métodos
| Método | Qué hace |
|---|---|
create(input, options?) | Crear un plan. |
retrieve(id, options?) | Consultar un plan. |
update(id, input, options?) | Actualizar precios, cuotas o disponibilidad. |
list(query?, options?) | Listar; admite active, search y sort. |
delete(id, options?) | Eliminar un plan sin suscripciones en curso, con sus enlaces. |
iterate(query?) | Recorrer planes. |
Qué debes tener en cuenta
Los ciclos admitidos son 1, 3, 6, 9 y 12 meses. Los precios nuevos se aplican a nuevas suscripciones; las existentes conservan lo contratado. Cambiar features sí modifica las cuotas de los suscriptores actuales.
Para cobrar por puesto agrega seats: { mode: "per_seat", min: 1, max: 100 }; en el checkout, fija los puestos con quantity o deja que el cliente los elija. Los puestos de todas las suscripciones de un cliente se suman, así que un plan por puesto también sirve como complemento («Puestos extra»). Para incluir puestos usa { mode: "included", limit: 5 } o limit: null sin límite. fallbackPlanId configura el plan gratuito que conserva el acceso básico al cancelar o expirar. En su lugar, suspensionDays deja una suscripción sin pago suspendida esos días, sin acceso, hasta que pague la renovación y se reactive; útil en planes de equipo (suspensión).