概述
订阅是一种协议，客户通过定期支付费用（例如每日、每周、每月、每季度、每半年、每年或自定义周期）来访问产品、服务或内容。 订阅的主要特点包括：- 循环付款：客户需要周期性支付费用。
- 持续访问：只要持续付款，订阅者就能持续访问产品或服务。
- 灵活性：根据服务提供商的条款，订阅可以提供升级、降级或随时取消的选项。
订阅数据
状态
- 创建：订阅已创建，但结账会话未成功支付。
- 已过期：订阅未完成且已关闭，因为结账会话已过期。
- 已激活：订阅处于正常状态，没有未结账单。
- 试用中：订阅处于免费试用期。客户已提供支付信息，但尚未尝试付款。
- 逾期：续订支付尝试失败，但订阅仍然有效并将重试。
- 已取消：订阅已终止。
产品和价格
产品代表客户和商家达成协议的服务。价格包含维持协议所需的账单周期和支付金额信息。 支持的订阅周期包括：day、week、month、quarter、half_year、year 和 custom。自定义周期通过 interval_count 定义计费周期的天数。
客户
订阅包含一个客户 ID，代表同意为商家服务定期付款的实际客户。客户拥有用于循环付款的支付工具。 如果客户删除了与订阅关联的支付工具，但还有其他可用的支付工具，Clink 将使用默认支付工具进行续订。订阅管理
通过 API 创建订阅
使用创建订阅 API 可以直接创建订阅。请求需要包含产品、定期价格、支付方式类型、支付币种，以及至少一个客户标识。 对于CASHAPP、GCASH，可以不传 paymentInstrumentId，Clink 会自动创建支付工具，并在响应中返回对应 ID。其他支付方式仍需要传入已有的 paymentInstrumentId。
创建订阅时也可以传入 scheduledPhases，用于在未来账期边界预约套餐变更。每个阶段包含目标 priceSnapshotId、quantity 和 effectiveCycle，其中 effectiveCycle 表示从订阅创建后第几次续费边界生效。订阅响应会返回剩余未生效的 scheduledPhases 和 elapsedCycles，用于判断下一次预约变更还差几个账期生效。
scheduledPhases 必须按 sequence 和 effectiveCycle 严格递增排列，最多 10 个阶段。目标价格快照必须支持订阅的 paymentCurrency。
列表和查询
可以在订阅标签页下查看订阅。默认情况下，订阅按创建时间顺序列出。你可以使用以下条件筛选订阅：- 金额：产品的货币价值
- 货币：协议中使用的货币
- 客户 ID：与订阅关联的客户 ID
- 创建日期：订阅创建的时间段
- 状态：当前订阅状态
订阅详情
点击列表中的任何订阅将显示其详细信息，包括：- 产品和价格
- 客户和支付工具
- 发票和账单周期覆盖范围
取消订阅
要取消订阅：- 进入订阅标签页
- 使用搜索功能找到订阅并打开详情页
- 点击右上角的操作按钮
- 从下拉列表中选择取消订阅
- 在弹出窗口中选择取消原因
- 点击确定按钮
降级或升级订阅
使用预览订阅升降级 API 计算目标套餐、按比例费用、税费、优惠信息，以及本次变更是否立即生效。目标价格必须是当前商户下的定期价格，并且支持订阅当前的支付币种。 确认预览结果后，调用确认订阅升降级 API，传入预览返回的priceSnapshotId 和可选 promotionCode。立即生效的变更可能需要支付，并可能返回下一步支付动作；到期生效的变更会预约到下一个账期边界。如果需要在待生效变更落地前撤销它，可以调用取消待生效订阅变更 API。
如果你的 customer portal 配置允许，客户仍然可以通过客户门户自助完成套餐变更。
账单
系统会自动在下个账单周期开始前，为订阅生成账单以续费。客户可以下载账单用于报销、付款证明等用途。状态
- 待付款：账单的初始状态，表示正在等待付款。
- 已支付：账单金额已收到。
- 已撤销：账单已关闭但未支付。