Skip to main content
With Yuno, managing subscriptions becomes seamless – no additional websites or applications are required. Our intuitive subscription management system enables you to create, pause, resume, and cancel subscriptions.

​
Workflow

In the following workflow, you can find the different subscription statuses and how they can be updated.
Subscription lifecycle: CREATED to TRIALING or ACTIVE, with PAUSED, PAST_DUE, COMPLETED and CANCELED, plus a transversal ERROR state
A subscription in the trial phase behaves like an active one: it can be paused, it enters PAST_DUE on a failed charge and returns to TRIALING when a later charge succeeds. Any non-terminal status can be canceled, and a subscription created with initial_payment_validation: true goes straight from CREATED to CANCELED if the first payment fails.

​
Subscription status

Subscriptions can have the status described in the table below.
If your subscriptions never enter PAST_DUE, the status is not enabled for your account yet: a failed recurring charge leaves the subscription in ACTIVE while the retries run. Contact your Yuno representative to have it enabled.

​
Status transition matrix

Each cell shows what moves a subscription from the status in the row to the status in the column. N/A means the transition does not exist. COMPLETED and CANCELED are terminal: nothing leaves them. ¹ Only where PAST_DUE is enabled for the account; otherwise the subscription stays in its current status while the retries run.
ERROR sits outside this flow: it is reserved for processing failures and is not part of the normal lifecycle above.

​
Canceling a subscription

You can cancel a subscription in CREATED, ACTIVE, TRIALING, PAST_DUE and PAUSED, both through Cancel Subscription and from the dashboard. COMPLETED and CANCELED are terminal — canceling from either returns 400 INVALID_STATE, which is also what a repeated cancel on an already-canceled subscription returns.