> ## Documentation Index
> Fetch the complete documentation index at: https://commet.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# subscription.version_changed

> Se dispara cuando una suscripción pasa a otra versión de su plan, de inmediato o en su renovación.

## Cuándo se dispara

Una suscripción pasa a otra versión del mismo plan:

* de inmediato, después de [Change subscription version](https://commet.co/docs/es/api-reference/subscriptions/change-subscription-version.md) o de un movimiento del plan inmediato;
* en su renovación, cuando se aplica un movimiento programado para el final del período.

Desde este evento la suscripción tiene las features, los límites y los créditos o el balance incluidos de la versión de destino. Un movimiento inmediato cobra el precio de la nueva versión desde la próxima renovación; un movimiento nunca genera un cargo ni un reembolso por prorrateo.

`currency` es la moneda de la suscripción, que un movimiento nunca cambia. `billingInterval` es el intervalo que paga después del movimiento.

| Momento | Evento | Qué hacer |
| - | - | - |
| Se programa un movimiento para la renovación | Ninguno. La suscripción lo muestra en `scheduledVersionChange`. | Muestra el cambio próximo si tu UI lista las condiciones del plan. |
| Se aplica el movimiento | `subscription.version_changed` | Actualiza las features y los límites que guardas para la suscripción. |
| El movimiento programado ya no ocurrirá | `subscription.version_change_canceled` | Quita el cambio próximo. |

Una suscripción en trial con un movimiento pendiente se mueve cuando termina su trial, así que su primer cobro ya es en la versión de destino. Una suscripción que termina o pasa a otro plan en lugar de renovar en su plan nunca se mueve y no envía ninguno de los dos eventos.

Solo los endpoints que incluyen este evento en su lista lo reciben. Los tipos de evento nuevos no se agregan a los endpoints existentes: agrégalo a los eventos del endpoint en **Settings → Webhooks** o con [Update webhook endpoint](https://commet.co/docs/es/api-reference/webhooks/update-webhook-endpoint.md).


## OpenAPI

````yaml /openapi/es/webhooks/2026-08-27.json webhook subscription.version_changed
openapi: 3.1.0
info:
  title: Commet Webhooks
  version: '2026-08-27'
  description: >-
    Outbound webhook events emitted by the Commet API. Each event is delivered
    as a signed POST to your configured endpoints.
servers: []
security: []
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.