Reactivate Subscription
Returns a canceled or completed subscription to ACTIVE, keeping the same subscription and history.
CANCELED or COMPLETED
subscription to ACTIVE — or to TRIALING when a trial phase covers the reactivated cycle —
keeping the same id and its full payment history. No successor subscription is ever created
and previous_subscription_id is never set by this call. No charge is made on the call itself.
409 "Subscription reactivation is not enabled for this organization.",
contact your Yuno representative to have it enabled.Which subscriptions can be reactivated
availability.finish_at has already passed is refused with 400
INVALID_DATE, whatever its status:
When the billing cycles are used up
ACOMPLETED subscription that used every cycle in billing_cycles.total is refused with 409
INVALID_SUBSCRIPTION_STATUS:
billing_cycles.total with a value higher than the current one to raise the limit and
reactivate in the same call. This does not create a successor — it raises the limit on the same
subscription, keeping its id and history intact:
billing_cycles.total:
billing_cycles.total for a subscription that still has cycles left is accepted the same
way: it raises the limit, it is not restricted to exhausted subscriptions. An explicit
billing_cycles.total: null is treated the same as omitting the field — the current total is left
unchanged.
Choosing the next billing date
billing_cycle_behavior is the same axis used on resume and on plan changes.
400 BAD_REQUEST —
"billing_cycle_behavior must be one of KEEP, RESTART." Reactivate has no gateway-side validation
of its own: the same text comes back unchanged through the gateway.
frequency.monthly_billing_day set, RESTART stamps it to
the day of the reactivation — the same rule Update Subscription and Resume Subscription apply. A
subscription that already declares a billing day keeps it.The payment method
The vaulted payment method is revalidated before the subscription is reactivated. If it is no longer enrolled, the call returns400 PAYMENT_METHOD_STATUS_INVALID and the subscription is not
modified — the payment method check runs before the status write:
What reactivation clears
Reactivating a subscription clears:cancellation_timecancellation_sourceending_timereason- any scheduled cancellation (
cancel_scheduled) - any pause that was scheduled to end on its own — a reactivated subscription never carries
pause_until
subscription.reactivate webhook fires once, carrying the reactivated subscription.
Errors
Authorizations
Body
RESTART re-anchors the next charge to now plus the subscription's frequency (and stamps frequency.monthly_billing_day on a monthly subscription that had none). KEEP or omitted: the stored anchor is left untouched while it is still in the future, otherwise rolled forward to its next future occurrence. No charge is made on the call either way.
KEEP, RESTART "RESTART"
Response
200
Start of the billing period the subscription is currently in, one cadence before current_period_end. Inside a trial or any other plan phase it follows that phase's cadence. A terminal subscription (CANCELED or COMPLETED) keeps its final window rather than going null. Null only for a subscription with no recurring cadence. Always returned together with current_period_end.
"2023-01-16T20:00:00.912480Z"
The retry policy applied when a recurring charge is declined. See Retries.
The optional order enrichment sent at creation, echoed back. See The Subscription Object for its full shape.
The linked plan's phase definitions, as the plan declares them — including the terminal REGULAR phase. Only present on plan-linked subscriptions whose plan has phases. This is the plan's own ladder, not this subscriber's snapshot: for what was pinned for this subscription at creation, use billing_phases.
When the phase named by current_phase hands over to the next one — for a subscription in its trial, when it switches to the regular price. End of the last billing period the phase covers, so on the final period of a trial it equals current_period_end. Null for a subscription with no plan and for one that already left the phase ladder.
"2023-03-16T20:00:00.786342Z"
Only present on plan-linked subscriptions whose plan has phases. Contains the leading TRIAL phases only, snapshotted at creation — the terminal REGULAR phase is never included, since its price isn't pinned and instead resolves from the plan at every billing. current_phase: "REGULAR" is how you know the ladder is exhausted.