> ## 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、INR）的当前钱包余额

    * 交易原因和时间戳

    * 便于对账的详细交易记录
      查看客户的钱包信用分类账，显示：

    * 所有信用和借记交易

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

    * 交易原因和时间戳

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

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

## 客户门户

客户门户是一个安全托管的自助区域，客户可以在其中管理订阅、查看账单历史、访问许可证密钥并更新个人资料——无需联系支持。

### 门户功能

客户可以访问门户以：

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

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

## 客户钱包

客户钱包是面向客户的预付货币余额账户。每位客户自动拥有一个钱包，可持有多种货币（USD 和 INR）形式的真实资金，这些资金可用于支付订阅发票、作为退款余额，或用于推广奖金注资。

### 关键功能

* **多货币支持**：分别跟踪 USD 和 INR 的货币余额。
* **预付余额**：客户可持有用于未来发票和订阅付款的资金。
* **交易历史**：查看所有资金添加与扣除的完整分类账。
* **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">
    为特定客户生成一个安全的客户门户会话链接。
  </Card>
</CardGroup>

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