> ## 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.

# 客户管理

> 在商家仪表盘中查看和跟踪您的客户

## 客户管理

仪表盘中的客户页面为您提供每位在商店购买过的消费者的综合视图。跟踪收入、监控订阅，并深入查看单个客户详情。

***

## 客户数据

每条客户记录包含以下字段，数据来源于后端 `Customer` 类型：

| 字段                  | 说明                |
| ------------------- | ----------------- |
| `id`                | 唯一客户标识符（UUID）     |
| `email`             | 客户邮箱地址            |
| `name`              | 客户姓名              |
| `country`           | 客户所在国家            |
| `totalRevenue`      | 该客户的累计收入（显示格式字符串） |
| `mrr`               | 该客户贡献的月经常性收入      |
| `subscriptionCount` | 订阅数量（活跃和历史）       |
| `paymentCount`      | 支付总次数             |
| `createdAt`         | 客户记录创建时间          |
| `updatedAt`         | 客户记录最后更新时间        |
| `storeId`           | 该客户所属的商店          |

<Note>
  后端 `Customer` 类型没有 `status` 字段。仪表盘 UI 中显示的任何状态标签（如"活跃"或"订阅中"）都是根据客户的订阅和支付活动推导出来的，并非存储在客户记录上的属性。
</Note>

***

## 客户列表

仪表盘在可排序、可筛选的表格中显示客户，包含以下列：

| 列    | 说明             |
| ---- | -------------- |
| 邮箱   | 客户邮箱地址         |
| 国家   | 客户所在国家（显示国旗表情） |
| 收入   | 总累计收入          |
| MRR  | 月经常性收入         |
| 订阅   | 订阅数量           |
| 支付   | 支付次数           |
| 创建时间 | 客户首次出现的时间      |

### 搜索和筛选

客户列表支持：

* **文本搜索** -- 按客户邮箱或姓名搜索
* **状态筛选** -- 根据订阅和支付活动推导的状态类别进行筛选
* **日期范围筛选** -- 按客户创建日期筛选

***

## 客户详情

点击客户行查看完整资料。

### 概览

* 邮箱和姓名
* 国家（带国旗表情）
* 账户创建日期
* 总累计收入
* 当前 MRR
* 订阅数量和支付次数

### 订阅

查看该客户关联的所有订阅：

* 订阅状态
* 产品和层级信息
* 计费周期
* 日期和金额

### 支付

查看该客户的完整支付记录：

* 支付状态
* 金额和货币
* 关联订单和产品
* 退款状态（如适用）

***

## 消费者门户

客户还可以访问自助**消费者门户**，在其中管理自己的订阅和查看支付记录。门户是一个独立功能——请参阅[消费者门户](/zh/merchant/customer-portal)页面了解详情。

客户可通过门户使用的主要功能：

* 查看订阅和支付
* 更改订阅层级（升级或降级）
* 取消订阅
* 更新账单信息
* 下载发票和收据

<Tip>
  消费者门户使用安全的邮件验证认证。消费者通过发送到邮箱的验证链接进行认证。
</Tip>

***

## 相关内容

<CardGroup cols={2}>
  <Card title="消费者门户" icon="user" href="/zh/merchant/customer-portal">
    消费者自助管理订单和订阅的门户。
  </Card>

  <Card title="订单与支付" icon="receipt" href="/zh/features/orders-payments">
    查看和管理订单及支付记录。
  </Card>
</CardGroup>