Skip to main content

​
When this fires

A subscription moves to another version of the same plan:
  • right away, after Change subscription version or a plan move made now;
  • at its renewal, when a move scheduled for the end of the period takes effect.
From this event the subscription has the destination version’s features, limits and included credits or balance. A move made now charges the new version’s price from the next renewal; a move never creates a proration charge or refund. currency is the subscription’s currency, which a move never changes. billingInterval is the interval it pays after the move. A trialing subscription with a pending move moves when its trial ends, so its first charge is already on the destination version. A subscription that ends or changes to another plan instead of renewing on its plan never moves and sends neither event. Only endpoints that list this event receive it. New event types are not added to existing endpoints: add it to the endpoint’s events in Settings → Webhooks or with Update webhook endpoint.

Body

application/json
​
id
string
required
​
event
string
required
Allowed value: "subscription.version_changed"
​
timestamp
string
required
​
organizationId
string
required
​
mode
enum<string>
required
Available options:
live,
sandbox
​
apiVersion
string
required
​
data
object
required

Response

200

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