subscription.version_change_canceled

{ "event": "subscription.version_change_canceled", "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", "toVersionId": "plnrel_v4", "reason": "addon_unavailable" } }

Cuándo se dispara

Un movimiento a otra versión que esperaba la renovación de la suscripción no ocurrirá, y la suscripción se queda en su versión. toVersionId es la versión a la que iba a pasar y reason indica por qué:

`reason`	Qué pasó
`canceled_by_merchant`	Cancelaste el movimiento con Revoke scheduled version change, o cancelaste el movimiento del plan para todos los suscriptores o para este.
`addon_unavailable`	En la renovación la suscripción tiene un add-on activo que la versión de destino no vende.
`seat_limit_exceeded`	En la renovación la suscripción tiene más licencias de las que permite la versión de destino.
`price_not_found`	La versión de destino no vende el precio que paga la suscripción.
`missing_regional_price`	La versión de destino no vende la moneda de la suscripción. Un movimiento nunca cambia la moneda.
`version_change_failed`	El movimiento no se pudo aplicar en la renovación.

Un movimiento inmediato no deja nada pendiente, así que nunca dispara este evento. Tampoco lo dispara un movimiento nuevo que reemplaza al pendiente, un cambio a otro plan ni una suscripción que termina en lugar de renovar: el movimiento pendiente se descarta y scheduledVersionChange pasa a null. Para mover la suscripción más adelante, resuelve lo que indica reason y vuelve a solicitar el movimiento.

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_change_canceled"

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_change_canceled

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara