Retry Subscription
Manually retries a subscription’s most recent declined payment for the current billing cycle.
- Only the most recent payment of the subscription can be retried.
- Multiple manual retries can be executed only if the previous retry attempt resulted in a DECLINED status.
- Manually triggering a retry stops the smart retry scheme for the corresponding payment. The following payments of the subscription will follow the smart retry scheme if enabled in the creation.
- After the successful retry attempt, the system continues with the next scheduled subscription charge.
- If neither condition is met, the request returns
400with code INVALID_STATE and the messageThe last payment intent of the subscription does not support the action requested.The same error is returned when the subscription is canceled. - If no subscription matches
subscription_idon the account, the request returns400with code SUBSCRIPTION_NOT_FOUND.
Authorizations
Headers
The account_id found in your Yuno Dashboard (UUID).
Path Parameters
The unique identifier of the subscription, see create subscription (UUID).
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 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.