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

# 订阅

> 了解周期性付款合约

## 概述

订阅是一种协议，客户通过定期支付费用（例如每日、每周、每月、每季度、每半年、每年或自定义周期）来访问产品、服务或内容。

订阅的主要特点包括：

* 循环付款：客户需要周期性支付费用。
* 持续访问：只要持续付款，订阅者就能持续访问产品或服务。
* 灵活性：根据服务提供商的条款，订阅可以提供升级、降级或随时取消的选项。

## 订阅数据

### 状态

* 创建：订阅已创建，但结账会话未成功支付。
* 已过期：订阅未完成且已关闭，因为结账会话已过期。
* 已激活：订阅处于正常状态，没有未结账单。
* 试用中：订阅处于免费试用期。客户已提供支付信息，但尚未尝试付款。
* 逾期：续订支付尝试失败，但订阅仍然有效并将重试。
* 已取消：订阅已终止。

### [产品和价格](/guides/resources/product)

产品代表客户和商家达成协议的服务。价格包含维持协议所需的账单周期和支付金额信息。

支持的订阅周期包括：`day`、`week`、`month`、`quarter`、`half_year`、`year` 和 `custom`。自定义周期通过 `interval_count` 定义计费周期的天数。

### [客户](/guides/resources/customer)

订阅包含一个客户 ID，代表同意为商家服务定期付款的实际客户。客户拥有用于循环付款的支付工具。

如果客户删除了与订阅关联的支付工具，但还有其他可用的支付工具，Clink 将使用默认支付工具进行续订。

## 订阅管理

### 通过 API 创建订阅

使用[创建订阅 API](/cn/api-reference/endpoint/create-subscription) 可以通过已有支付工具直接创建订阅。请求需要包含产品、定期价格、支付方式类型、支付币种，以及至少一个客户标识。

创建订阅时也可以传入 `scheduledPhases`，用于在未来账期边界预约套餐变更。每个阶段包含目标 `priceSnapshotId`、`quantity` 和 `effectiveCycle`，其中 `effectiveCycle` 表示从订阅创建后第几次续费边界生效。订阅响应会返回剩余未生效的 `scheduledPhases` 和 `elapsedCycles`，用于判断下一次预约变更还差几个账期生效。

`scheduledPhases` 必须按 `sequence` 和 `effectiveCycle` 严格递增排列，最多 10 个阶段。目标价格快照必须支持订阅的 `paymentCurrency`。

### 列表和查询

可以在**订阅**标签页下查看订阅。默认情况下，订阅按创建时间顺序列出。你可以使用以下条件筛选订阅：

* 金额：产品的货币价值
* 货币：协议中使用的货币
* 客户 ID：与订阅关联的客户 ID
* 创建日期：订阅创建的时间段
* 状态：当前订阅状态

### 订阅详情

点击列表中的任何订阅将显示其详细信息，包括：

* 产品和价格
* 客户和支付工具
* 发票和账单周期覆盖范围

### 取消订阅

要取消订阅：

1. 进入**订阅**标签页
2. 使用搜索功能找到订阅并打开详情页
3. 点击右上角的**操作**按钮
4. 从下拉列表中选择**取消订阅**
5. 在弹出窗口中选择取消原因
6. 点击**确定**按钮

### 降级或升级订阅

我们不支持商家代表客户降级或升级订阅。要完成此类请求，请引导客户前往客户门户进行自助服务。

<Warning>
  **退款**：取消订阅不会自动发起按比例退款。<br />
  例如，如果你的服务是基于使用量计费，你需要计算实际退款金额。如果取消时需要退款，请额外提交[退款](/guides/resources/refund)请求。
</Warning>

## 账单

系统会自动在下个账单周期开始前，为订阅生成账单以续费。客户可以下载账单用于报销、付款证明等用途。

### 状态

* 待付款：账单的初始状态，表示正在等待付款。
* 已支付：账单金额已收到。
* 已撤销：账单已关闭但未支付。

### 账单管理

账单在服务初次订阅或触发续订时自动生成。我们目前不支持手动创建账单。

账单与订阅紧密关联。要查看账单列表，请导航到订阅详情页并向下滚动。