Un plan de SaaS cambia muchas veces. Sube el precio, se agrega una feature, se baja un límite. El problema es qué pasa con los clientes que ya pagan.
Hasta ahora, en Commet cada edición de un plan les llegaba a los clientes existentes en su próxima renovación. Si querías respetarle el precio a alguien, la única salida era duplicar el plan. Con el tiempo, el catálogo se llenaba de copias del mismo producto y se volvía difícil saber quién pagaba qué y por qué.
Ahora cada plan tiene versiones. El plan es el producto, por ejemplo Pro. Una versión guarda todas sus condiciones en un momento dado: precios, trials, features, reglas de credits y balance, add-ons, credit packs y precios por país. Cada suscripción queda en una versión, y cada nuevo comprador recibe la actual.
Cambiá un precio sin una copia
Cuándo sirve: querés que los nuevos compradores paguen $59 por Pro mientras los clientes que entraron a $49 mantienen su precio. Antes eso implicaba un segundo plan para mantener. Ahora es una versión nueva del mismo plan.
Duplicar el plan
Pro · $49
·
Publicar una versión
Pro · versión 1 · $49
·
Pro se vende a $49 a tus clientes actuales.
En el dashboard, el primer cambio que hacés sobre un plan abre un borrador a partir de la versión que estás viendo. Nadie lo ve hasta que lo publicás. Podés tener varios borradores abiertos, deshacer cada cambio por separado desde Changes in this draft y descartar el borrador. Nombre, descripción y visibilidad no se versionan: se aplican al instante.

Con el SDK, preparás el borrador y lo publicás. Cada bloque que mandás reemplaza ese bloque, así que prices lista todos los intervalos que vende el borrador. Los precios van en centavos de USD.
const draft = await commet.plans.createDraft({ id: "pln_pro" });
await commet.plans.updateDraft({
id: "pln_pro",
draftId: draft.id,
prices: [
{ billingInterval: "monthly", price: 5900, isDefault: true },
{ billingInterval: "yearly", price: 59000 },
],
});
await commet.plans.publishDraft({
id: "pln_pro",
draftId: draft.id,
publishAs: "current",
move: "keep",
});Mandá preview: true a publishDraft primero para revisar todo sin publicar. Cualquier otra edición del plan desde el SDK, la API, el CLI o el MCP publica una versión actual nueva al instante y no mueve a nadie.
Elegí qué pasa con tus clientes actuales
Al publicar una versión, elegís qué pasa con los suscriptores de versiones anteriores. Solo vos los movés; Commet nunca mueve a nadie por su cuenta.
move | Qué pasa |
|---|---|
keep | Siguen en su versión, con su precio y sus features. |
period_end | Todo cambia en su próxima renovación. Hasta entonces no cambia nada del período actual. |
now | Features, límites y credits o balance incluidos cambian hoy, sin resetear el uso. El precio nuevo se cobra desde la próxima renovación. |
Un movimiento nunca prorratea ni reembolsa, y mantiene la moneda, el país, el intervalo y el precio de la suscripción. Un cliente en una versión anterior no es un caso especial: vive ahí hasta que decidas moverlo.

Nadie se mueve sin encajar
Cuándo sirve: la versión 2 permite 5 seats y Acme usa 8. Mover a Acme a ciegas le rompería la cuenta. Commet revisa primero a cada suscriptor contra la nueva versión y, si alguno no entra, nadie se mueve hasta que decidas qué pasa con él.
Mantenerlos en su versión
Acme · versión 1 · $49
·
Moverlos en la renovación
Acme · versión 1 · el movimiento espera
409 subscribers_do_not_fit · 8 seats > 5
Acme paga $49 en la versión 1 con 8 seats. La versión 2 cuesta $59 y permite 5.
Un movimiento que no encaja falla con 409 subscribers_do_not_fit y lista a cada suscriptor con sus motivos. Mandá un cambio para cada uno en changes, que se aplica en su renovación: otro intervalo, seats al límite de la versión, add-ons que dejan de cobrarse o mantenerlo en su versión. Ver Resolver conflictos para cada cambio.
await commet.plans.createMove({
id: "pln_pro",
fromVersionId: "plr_v1",
toVersionId: "plr_v2",
effective: "period_end",
changes: [{ subscriptionId: "sub_acme", seatLimit: true }],
});Para mover una sola suscripción, usá subscriptions.changeVersion. Repetir el mismo pedido no cambia nada, y uno nuevo reemplaza el movimiento pendiente.
await commet.subscriptions.changeVersion({
id: "sub_acme",
planVersionId: "plr_v2",
effective: "period_end",
});Si un movimiento programado deja de encajar al llegar la renovación, la suscripción renueva en su versión y aparece en Needs a change. Movela de nuevo con un cambio, o dejala con plans.keepSubscriberOnVersion.
Todas las versiones a la vista
La página del plan en el dashboard muestra toda la historia:
Versions lista cada versión publicada con lo que cambió en cada una, y los borradores del plan.
Subscribers muestra la versión de cada suscriptor y cualquier movimiento pendiente con su fecha.
Moves muestra cuántos suscriptores se movieron, están en camino, necesitan un cambio o quedaron afuera, y cancela un movimiento que todavía no terminó.

Con el SDK, plans.listVersions devuelve las versiones de la más nueva a la más vieja con su cantidad de suscripciones, y plans.compareVersions devuelve cada condición que cambia entre dos de ellas.
const changes = await commet.plans.compareVersions({
id: "pln_pro",
versionId: "plr_v2",
against: "plr_v1",
});Experimentos: versiones que compiten
Cuándo sirve: creés que Pro podría venderse a $59 pero todavía no querés cambiarlo para todos. Un experimento vende una versión solo a los compradores que mandás a él, mientras el resto sigue comprando la versión actual.
planCode: pro
Pro · versión 2 · $49
·
planCode: pro:price-test
price-test 1 · $59
experimento activo
Pro se vende a $49. Publicás un borrador a $59 como price-test.
Commet no reparte tráfico: vos decidís quién recibe el experimento mandando su código después del código del plan.
const draft = await commet.plans.createDraft({ id: "pln_pro" });
await commet.plans.updateDraft({
id: "pln_pro",
draftId: draft.id,
prices: [
{ billingInterval: "monthly", price: 5900, isDefault: true },
{ billingInterval: "yearly", price: 59000 },
],
});
await commet.plans.publishDraft({
id: "pln_pro",
draftId: draft.id,
publishAs: "experiment",
experimentCode: "price-test",
});
await commet.subscriptions.create({
customerId: "user_123",
planCode: "pro:price-test",
});
await commet.plans.makeExperimentCurrent({
id: "pln_pro",
code: "price-test",
});Si no funciona, plans.archiveExperiment deja de venderlo. Su código pasa a vender la versión actual, así que los links que ya compartiste siguen funcionando, y elegís si sus suscriptores se quedan, se mueven en la renovación o ahora.
Precios por país en cada versión
Cada versión define sus países con su propia moneda y precios. Una versión puede cobrar $29 en Uruguay y $49 en Estados Unidos. Si a un país que vendés le falta un precio, la publicación se frena y te dice qué país es. Los precios de Markets no se versionan: una suscripción que paga uno lo sigue pagando en cada movimiento.
Si ya usás Commet
Tus planes ya tienen su versión actual y cada suscripción quedó en una versión de su plan. La pestaña Subscribers muestra la versión de cada una y cualquier movimiento pendiente.
Cambia un comportamiento: editar un plan ya no les llega a los suscriptores existentes en su renovación. Una edición desde el dashboard, el SDK, la API, el CLI o el MCP publica una versión nueva para los nuevos compradores y no mueve a nadie. Si tu integración cambia un precio o una feature esperando que les llegue a todos los clientes, movelos después de editar con plans.createMove, o publicá el borrador con move: "period_end".
SDK, CLI, MCP y webhooks
@commet/node9.10 suma los métodos de borradores, versiones, experimentos y movimientos enplans, ysubscriptions.changeVersion. Las suscripciones devuelvenplanVersionyscheduledVersionChange.El CLI suma comandos como
commet plans list-versions,commet plans create-moveycommet subscriptions change-version.Dos webhooks:
subscription.version_changedcuando una suscripción cambia de versión, ysubscription.version_change_canceledcuando un movimiento pendiente no va a ocurrir.@commet/nextlos maneja cononSubscriptionVersionChangedyonSubscriptionVersionChangeCanceled.La skill de Commet conoce las versiones de planes, así que tu agente de código puede configurarlas por vos:
npx skills add commet-labs/skills.
Empezar
Abrí cualquier plan en el dashboard para ver su versión actual. Tus clientes actuales siguen donde están: nada se mueve hasta que los muevas. Si tenías planes duplicados por cambios chicos, es el momento de volver a juntarlos en uno. Leé Versiones de planes para la referencia completa.