> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 订阅

> 管理周期性计费和订阅者关系

## 订阅管理

订阅页面显示与您客户的所有周期性计费安排。

<Frame>
  <img src="https://mintcdn.com/waffo/5dRlk76Jm-9Zm6Tj/images/dashboard/subscriptions-list.png?fit=max&auto=format&n=5dRlk76Jm-9Zm6Tj&q=85&s=e1952d496dfb35c7bf74a8d95f733bbb" alt="Subscriptions List" width="1440" height="900" data-path="images/dashboard/subscriptions-list.png" />
</Frame>

## 订阅列表

在详细表格中查看所有订阅：

| 列名   | 描述       |
| ---- | -------- |
| 状态   | 当前订阅状态   |
| 产品   | 产品名称和图片  |
| 客户   | 订阅者邮箱    |
| 金额   | 带货币的订阅价格 |
| 周期   | 计费频率     |
| 下次计费 | 下次收费日期   |
| 创建时间 | 订阅开始时间   |

## 订阅状态

<CardGroup cols={2}>
  <Card title="活跃" icon="check-circle" color="#22c55e">
    订阅正在运行并正常计费。
  </Card>

  <Card title="试用中" icon="flask" color="#3b82f6">
    客户处于免费试用期。
  </Card>

  <Card title="逾期" icon="clock" color="#f59e0b">
    支付失败，等待重试。
  </Card>

  <Card title="取消中" icon="hourglass-half" color="#f59e0b">
    已请求取消，在周期结束前保持活跃。
  </Card>

  <Card title="已过期" icon="calendar-xmark" color="#6b7280">
    订阅已过期。
  </Card>

  <Card title="已取消" icon="xmark" color="#ef4444">
    订阅已终止。
  </Card>
</CardGroup>

## 计费周期

| 周期  | 计费频率  | MRR 计算    |
| --- | ----- | --------- |
| 每周  | 每7天   | 金额 × 4.33 |
| 每月  | 每月    | 金额 × 1    |
| 每季度 | 每3个月  | 金额 ÷ 3    |
| 每年  | 每12个月 | 金额 ÷ 12   |

## 筛选订阅

| 筛选器 | 选项                    |
| --- | --------------------- |
| 状态  | 活跃、试用中、逾期、取消中、已过期、已取消 |
| 产品  | 任意订阅产品                |
| 周期  | 每周、每月、每季度、每年          |
| 客户  | 按邮箱搜索                 |

## 订阅详情

点击订阅查看：

### 概览

* 订阅 ID
* 状态和状态历史
* 产品详情
* 定价和货币
* 计费周期

### 计费信息

* 当前周期开始/结束
* 下次计费日期
* 存档的支付方式
* 计费历史

### 客户

* 客户邮箱
* 账户详情
* 同一客户的其他订阅

### 支付历史

* 该订阅的所有收费
* 成功和失败的尝试
* 退款

## 管理订阅

### 取消订阅

<Steps>
  <Step title="打开订阅详情">
    点击您要取消的订阅。
  </Step>

  <Step title="点击'取消订阅'">
    在操作菜单中找到该按钮。
  </Step>

  <Step title="确认取消">
    取消将在当前计费周期结束时生效。订阅进入"取消中"状态，直到周期结束后变为"已取消"。
  </Step>
</Steps>

<Note>
  客户在当前已付费的计费周期结束前仍可继续使用。
</Note>

### 恢复订阅

对于"取消中"状态的订阅，重新激活端点已存在但目前返回 501（尚未实现）。

## 订阅指标

### 统计卡片

| 指标   | 描述        |
| ---- | --------- |
| MRR  | 月度经常性收入   |
| 活跃   | 活跃订阅数量    |
| 试用中  | 试用中的订阅数量  |
| 已取消  | 已取消数量（本期） |
| ARPU | 每用户平均收入   |

### MRR 计算

MRR 从所有活跃订阅计算：

```
MRR = Σ (订阅金额 × 周期系数)

其中周期系数：
- 每周: 4.33
- 每月: 1
- 每季度: 0.33
- 每年: 0.083
```

## 支付失败

当订阅支付失败时：

1. 状态变为"逾期"
2. 自动重试（7天内3次尝试）
3. 通过邮件通知客户
4. 如果所有重试失败，订阅可能被取消

### 催缴邮件

自动发送给客户的邮件：

* 首次支付失败通知
* 重试提醒
* 取消前最后警告
* 取消确认

## 试用期

对于启用试用的产品：

| 字段   | 描述       |
| ---- | -------- |
| 试用状态 | 活跃试用指示器  |
| 试用天数 | 总试用时长    |
| 剩余天数 | 试用剩余时间   |
| 转化日期 | 首次收费发生时间 |

跟踪试用转化：

* 试用 → 活跃（已转化）
* 试用 → 已取消（转化前流失）

## 订阅操作

<AccordionGroup>
  <Accordion title="更改产品/计划">
    将订阅升级或降级到不同的产品。注意：此端点目前返回 501（尚未实现）。
  </Accordion>

  <Accordion title="更新支付方式">
    向客户发送链接以更新其存档的卡片。
  </Accordion>
</AccordionGroup>