---
title: Subscription States
slug: oms/subscription-states
docTags: 
createdAt: 2026-06-22T14:44:02.457Z
---

# 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

![](https://api.archbee.com/api/optimize/TmutqdeXiIw-V3gBZXVjd/txlkyP76r6ZxVmSqFhTew_image.png)

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**

:::hint{type="info"}
***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.](https://api.archbee.com/api/optimize/TmutqdeXiIw-V3gBZXVjd/XIlaBRHE4PLJIouoYcvWF_image.png)



![State: Paused — the same subscription with orders on hold.](https://api.archbee.com/api/optimize/TmutqdeXiIw-V3gBZXVjd/bREMDeKLH8G3LgdkexovU_image.png)