Subscription States
3 min
overview this section of documentation outlines the different statuses a subscription can have throughout its lifecycle and explains what causes a subscription to move into each one a subscription's status is described by more than a single label state captures where the subscription sits in its lifecycle (for example, active, paused, canceled, or ended) processing state reflects the health of the most recent order and payment attempt these run independently of one another — so a subscription can be active while its latest charge shows as failed, for instance the specific statuses available, and the events that trigger them, also vary by subscription type the sections that follow break this down for each type standard/recurring prepaid gift prepaid note a subscription's lifecycle status and its paused/on hold indicator share a single status badge in the oms admin ui — when an active subscription is put on hold, that badge simply reads "paused " in other words, being paused isn't a separate stage in the subscription's lifecycle — a paused subscription is still active , just with its upcoming orders temporarily suspended the most recent order's processing status is shown separately and updates independently, reflecting the latest payment attempt regardless of where the subscription sits in its lifecycle example this example happens to be a converted prepaid subscription — covered in the prepaid section note that in the active screenshot the action button reads pause ; in the paused screenshot it reads resume state active — orders are processing on schedule state paused — the same subscription with orders on hold