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

# 客户管理

> 通过 Dodo Payments 仪表板和 API 管理客户关系，跟踪购买历史，并提供自助服务选项。

## 概述

Dodo Payments 中的“客户”功能提供集中枢纽以管理所有客户关系。您可以跟踪每一次客户互动，查看购买历史，管理订阅，访问钱包交易分类账，并启用自助服务选项——所有操作都可在一个仪表板上完成。

<CardGroup cols={2}>
  <Card title="Customer Dashboard" icon="table-columns">
    在一个地方查看和管理所有客户，提供搜索和过滤功能。
  </Card>

  <Card title="Customer Wallets" icon="wallet">
    管理预付货币余额，为钱包注资，并跟踪交易历史。
  </Card>

  <Card title="Customer Portal" icon="id-card">
    让客户能够自助管理订阅、发票和许可密钥。
  </Card>

  <Card title="API Management" icon="code">
    通过 API 编程方式创建、更新和检索客户数据。
  </Card>
</CardGroup>

## 访问客户页面

<Steps>
  <Step title="Navigate to Customers">
    在仪表板中，从导航菜单点击 **Sales > Customers**。
  </Step>

  <Step title="View Customer List">
    客户页面会显示所有当前和过往与您业务互动的客户列表。
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/dodopayments/IKECEhkZu9f1KFmK/images/customer/customers-list.png?fit=max&auto=format&n=IKECEhkZu9f1KFmK&q=85&s=d110d27ad8c3fa8e623241b62d47601c" alt="客户列表页面，显示所有客户及其详细信息" style={{ maxHeight: '500px', width: 'auto' }} width="1662" height="782" data-path="images/customer/customers-list.png" />
</Frame>

## 客户信息

在 **客户页面** 上，您可以看到整个客户群的综合概述。表格显示所有客户的以下信息：

### 客户列表列

* **Customer Name**: 带头像指示器的客户全名。
* **Customer Id**: 每位客户的唯一标识符 (e.g., `cus_5fpsWAa...`)。
* **Email**: 用于通信和门户访问的客户电子邮件地址。
* **Phone Number**: 客户的电话号码（如提供）。
* **Created At (UTC)**: 客户帐户创建的日期和时间。
* **Invite**: 快速操作按钮，用于分享客户门户邀请。

### 页面功能

* **编辑列**：自定义客户表中显示的列。
* **搜索**：通过姓名、电子邮件或客户 ID 快速查找特定客户。
* **分页**：通过调整每页显示的行数浏览客户列表。

<Tip>
  使用“编辑列”功能自定义视图，只显示与工作流程最相关的信息。
</Tip>

## 客户详细信息页面

点击任何客户以查看其详细信息页面，其中包括：

<Frame>
  <img src="https://mintcdn.com/dodopayments/IKECEhkZu9f1KFmK/images/customer/customer-details.png?fit=max&auto=format&n=IKECEhkZu9f1KFmK&q=85&s=4f1d97a2d31f5e64fb4a075dde6239ff" alt="客户详细信息页面，显示客户信息和交易历史" style={{ maxHeight: '500px', width: 'auto' }} width="1657" height="931" data-path="images/customer/customer-details.png" />
</Frame>

### 关于部分

关于部分显示核心客户信息：

* **姓名**：客户的全名
* **电子邮件**：客户的电子邮件地址
* **客户 ID**：用于 API 和跟踪的唯一标识符
* **创建时间**：客户账户创建的时间戳

### 客户活动标签

客户详细信息页面包括三个标签，用于查看客户活动的不同方面：

<Tabs>
  <Tab title="Transactions History">
    查看此客户的所有支付交易，包括：

    * **Payment ID**: 唯一的交易标识符
    * **Status**: 支付状态（成功、失败、待处理、已退款）
    * **Amount**: 交易金额
    * **Date (UTC)**: 交易发生时间
    * **Pricing Type**: 一次性购买或订阅
    * **Payment Method**: 使用的支付方法（卡、UPI 等）
    * **Customer Email**: 与交易关联的电子邮件
    * **Refund**: 发起退款的快速操作
    * **Actions**: 用于管理交易的其他选项
  </Tab>

  <Tab title="Active Subscriptions">
    查看此客户的所有活跃订阅：

    * 订阅计划详情
    * 计费周期与下一次续订日期
    * 订阅状态
    * 管理或取消订阅的选项
  </Tab>

  <Tab title="Wallet Ledger">
    查看客户的钱包交易分类账，显示：

    * 所有资金充值和扣款

    * 各种货币（USD、EUR、GBP）的当前钱包余额

    * 交易原因和时间戳

    * 用于对账的详细交易历史
      查看客户钱包的余额账本，其中显示：

    * 所有信用和借记交易

    * 每种货币的当前钱包余额

    * 交易原因和时间戳

    * 便于对账的详细交易记录
  </Tab>
</Tabs>

<Note>
  “钱包分类账”标签提供客户钱包交易的完全透明度，便于追踪资金添加、扣除以及当前货币余额。
</Note>

## 阻止客户

您可以阻止存在欺诈行为或滥用退款的客户，使其无法再次向您结账。阻止操作会取消该客户的有效订阅，并将其 Customer Portal 设为只读。被阻止客户的详情页面会显示 **已阻止** 标记、**解除阻止客户** 按钮，以及用于说明阻止原因的 **活动日志**。您可以从 **设置 → 阻止列表** 管理所有阻止记录。

<Card title="Customer Blocklist" icon="user-slash" href="/features/customer-blocklist">
  阻止操作的影响、电子邮件的匹配方式，以及如何从控制面板或 API 执行阻止操作。
</Card>

## Customer Portal

Customer Portal 是一个安全的托管式自助服务区域，客户可以在其中管理订阅、查看账单历史记录、访问许可证密钥以及更新个人资料，而无需联系支持团队。

### Portal 功能

客户可以访问门户以：

* **查看账单历史记录**：查看所有历史交易并下载发票。
* **管理订阅**：取消订阅或查看订阅详情。
* **获取许可证密钥**：访问与其购买记录关联的所有许可证密钥。
* **更新个人资料**：更改姓名、电子邮件或电话号码。

<Card title="Learn More About Customer Portal" icon="id-card" href="/features/customer-portal">
  探索有关门户功能、访问方式和集成示例的详细文档。
</Card>

## 客户钱包

客户钱包是为客户提供的预付货币余额账户。每位客户都会自动获得一个钱包，其中可以存放多种货币（USD、EUR 和 GBP）的真实资金，这些资金可用于支付订阅发票、抵扣退款余额或通过促销奖励充值。

### 主要功能

* **多币种支持**：分别跟踪 USD、EUR 和 GBP 的货币余额。
* **预付余额**：客户可以持有资金，这些资金会用于支付未来的发票和订阅费用。
* **交易历史记录**：查看所有资金增加和扣除的完整账本。
* **API 优先设计**：以编程方式增加、扣除和查询钱包余额。
* **基于额度的计费**：允许客户预先购买额度，并将其用于您的服务。
* **交易历史记录**：查看所有额度增加和扣除的完整账本。
* **API 优先设计**：以编程方式增加、移除和查询钱包余额。

<Card title="Learn More About Customer Wallets" icon="wallet" href="/features/customer-wallet">
  探索有关管理客户钱包余额的详细文档、代码示例和最佳实践。
</Card>

## API 管理

Dodo Payments 提供全面的 REST API，用于以编程方式管理客户。您可以完全通过 API 创建、检索、更新和管理客户。

### 可用的 API 端点

<CardGroup cols={2}>
  <Card title="Create Customer" icon="user-plus" href="/api-reference/customers/create-customer">
    使用客户详细信息在您的 Dodo Payments 账户中创建新客户。
  </Card>

  <Card title="List Customers" icon="list" href="/api-reference/customers/get-customers">
    检索与您的账户关联的所有客户的分页列表。
  </Card>

  <Card title="Get Customer Details" icon="user" href="/api-reference/customers/get-customers-1">
    通过客户 ID 获取特定客户的详细信息。
  </Card>

  <Card title="Update Customer" icon="pen" href="/api-reference/customers/patch-customer">
    更新客户的信息，例如姓名、电子邮件或元数据。
  </Card>

  <Card title="Delete Payment Method" icon="trash" href="/api-reference/customers/delete-payment-method">
    从客户账户中移除已保存的支付方式。
  </Card>

  <Card title="Create Portal Session" icon="arrow-up-right-from-square" href="/api-reference/customers/create-customer-portal-session">
    为特定客户生成安全的 Customer Portal 会话链接。
  </Card>
</CardGroup>

<Note>
  所有 API 端点都需要使用 API 密钥进行身份验证。始终在服务器端使用您的密钥，切勿将其暴露在客户端代码中。
</Note>

<Note>
  每个端点都需要您的 API key。请从您的服务器调用 API，切勿在客户端代码中暴露该密钥。
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.