subscription.version_changed

{ "event": "subscription.version_changed", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "fromVersionId": "plnrel_v3", "toVersionId": "plnrel_v4", "currency": "usd", "billingInterval": "monthly" } }

Cuándo se dispara

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

de inmediato, después de Change subscription version 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.

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "subscription.version_changed"

timestamp

string

requerido

organizationId

string

requerido

mode

enum<string>

requerido

Opciones disponibles:

live,

sandbox

apiVersion

string

requerido

data

object

requerido

Show child attributes

Respuesta

200

Return any 2xx status code to acknowledge receipt of the event.

Introducción

Eventos

subscription.version_changed

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara