Sign in

v1

latestOpenAPI 3.1.02026-07-222392081.7 MB
Subscriptions > Transitions

Cancel subscription transition

Cancel a scheduled subscription transition.

post/v2/subscriptions/transitions/{id}/cancel

Path parameters

idstring required

Response

idstring required

The unique identifier of the subscription transition

customer_idstring required

The ID of the customer associated with the transition

base_subscription_idstring required

The ID of the original subscription from which this transition is derived. It references the last active version of the subscription.

source_subscription_idstring required

The ID of the subscription to transition from

target_subscription_idstring nullable required

The ID of the subscription to transition to

status'scheduled' | 'completed' | 'failed' | 'draft' | 'cancelled' | 'pending_quote_signature' required

The current status of the subscription transition. Possible values are 'scheduled', 'completed', 'failed', and 'draft'.

transitioned_atstring date nullable required

The date and time when the transition was completed. Null if the transition is not yet completed. UTC date time string in the ISO 8601 format.

namestring nullable required

An optional name for the transition

transition_datestring date nullable required

The date at which the transition should occur. Only applicable if the application schedule is 'scheduled'. Can be a past date within the current billing period. UTC date time string in the ISO 8601 format.

application_schedule'immediately' | 'scheduled' | 'next_renewal' | 'last_renewal' | 'quote_signature' | 'scheduled_after_quote_signature' required

When the transition should be applied: 'immediately', 'scheduled' for a specific date, or 'last_renewal' to apply it retroactively to the start of the current billing period (refunding what was already invoiced for that period and re-charging the new configuration). Past dates within the current billing period are supported and will be applied immediately.

billing_cycle_transition_method'keep_current_billing_cycle' | 'align_to_new_billing_cycle' nullable required

The billing cycle transition method to use. 'keep_current_billing_cycle' will keep the current billing cycle dates if possible. 'align_to_new_billing_cycle' will align the billing cycle to the transition date.

calculation_method'do_not_charge' | 'pro_rata' | 'refund_and_reinvoice' nullable required

The calculation method to use for the transition. 'do_not_charge' will not generate any transition invoice. 'pro_rata' will generate a prorated invoice for the remaining period. 'refund_and_reinvoice' (only available with application_schedule 'last_renewal') issues a credit note for what was invoiced for the current period and a separate invoice for the new configuration.