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

# 客户与订阅

> 查看客户购买历史并管理客户的定期付款订阅。

**付款**下的**客户**和**订阅**页面展示你的组织销售出去的交易及定期付款订阅。

## 客户

客户页面列出从组织订单中识别出的稳定 Anyway 客户 ID 和标准化电子邮箱。打开客户后，可以
查看相关订单和订阅，并继续进入完整详情。

客户记录来自交易活动；该页面不是通用联系人数据库，也不能用来编辑客户身份。

## 订阅

订阅页面列出客户的定期付款订阅，并支持按状态筛选。打开一项订阅可以查看：

* 状态、客户、产品、金额、币种和计费周期；
* 当前周期结束时间及是否已计划取消；以及
* 首笔付款和之后的续费订单。

支持的生命周期状态包括 `PENDING`、`ACTIVE`、`PAUSED`、`CANCELED`、`EXPIRED` 和
`ENDED`。计费周期可以是每日、每月或每年。支持的银行卡 / 美元定价可以使用定期结账；加密货币
付款链接仍然仅支持一次性付款。

## 订单关系

| 订单类型   | `subscriptionId` | `originalOrderId` |
| ------ | ---------------- | ----------------- |
| 一次性购买  | 不存在              | 不存在               |
| 订阅首笔付款 | 存在               | 不存在               |
| 订阅续费   | 存在               | 指向首笔订单            |

使用这些关系即可区分一次性订单、订阅首笔付款和续费，无需依赖支付服务商标识。

## 安排取消

从订阅页面取消时，系统会安排在当前计费周期结束时停止订阅。订阅在 `currentPeriodEnd` 前仍可
保持有效，详情会通过 `cancelAtPeriodEnd` 显示该状态。刷新和 Webhook 更新会将本地记录与
支付服务商状态重新同步。

<CardGroup cols={2}>
  <Card title="订阅 API" icon="arrows-rotate" href="/zh/api-reference/endpoint/list-subscriptions">
    从服务端读取订阅生命周期和订单关系字段。
  </Card>

  <Card title="客户 API" icon="users" href="/zh/api-reference/endpoint/list-customers">
    读取客户身份，并使用 `customer_id` 筛选相关记录。
  </Card>
</CardGroup>