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

# Customer Management

> Manage customer relationships, track purchase history, and provide self-service options through the Dodo Payments dashboard and API.

## Overview

Tính năng Khách hàng trong Dodo Payments cung cấp một trung tâm tập trung để quản lý tất cả mối quan hệ với khách hàng của bạn. Theo dõi mọi tương tác với khách hàng, xem lịch sử mua hàng, quản lý đăng ký, truy cập sổ cái giao dịch ví và kích hoạt các tùy chọn tự phục vụ — tất cả từ một bảng điều khiển duy nhất.

<CardGroup cols={2}>
  <Card title="Customer Dashboard" icon="table-columns">
    View and manage all customers in one place with search and filtering capabilities.
  </Card>

  <Card title="Customer Wallets" icon="wallet">
    Quản lý số dư tiền trả trước, nạp tiền vào ví và theo dõi lịch sử giao dịch.
  </Card>

  <Card title="Customer Portal" icon="id-card">
    Empower customers to self-manage subscriptions, invoices, and license keys.
  </Card>

  <Card title="API Management" icon="code">
    Programmatically create, update, and retrieve customer data via API.
  </Card>
</CardGroup>

## Accessing the Customers Page

<Steps>
  <Step title="Navigate to Customers">
    From the dashboard, click on **Sales > Customers** in the navigation menu.
  </Step>

  <Step title="View Customer List">
    The Customers Page will display a list of all current and past customers who have interacted with your business.
  </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="Trang danh sách khách hàng hiển thị tất cả khách hàng cùng với chi tiết của họ" style={{ maxHeight: '500px', width: 'auto' }} width="1662" height="782" data-path="images/customer/customers-list.png" />
</Frame>

## Customer Information

On the **Customers Page**, you can see a comprehensive overview of your entire customer base. The table displays all customers with the following information:

### Customer List Columns

* **Customer Name**: The full name of the customer with an avatar indicator.
* **Customer Id**: A unique identifier (e.g., `cus_5fpsWAa...`) for each customer.
* **Email**: The customer's email address for communication and portal access.
* **Phone Number**: The customer's phone number (if provided).
* **Created At (UTC)**: The date and time when the customer account was created.
* **Invite**: Quick action button to share Customer Portal invites.

### Page Features

* **Edit Columns**: Customize which columns are displayed in the customer table.
* **Build Report**: Generate custom reports based on your customer data.
* **Search**: Quickly find specific customers by name, email, or customer ID.
* **Pagination**: Navigate through your customer list with adjustable rows per page.

<Tip>
  Use the "Edit Columns" feature to customize your view and show only the information most relevant to your workflow.
</Tip>

## Customer Details Page

Click on any customer to view their detailed information page, which includes:

<Frame>
  <img src="https://mintcdn.com/dodopayments/IKECEhkZu9f1KFmK/images/customer/customer-details.png?fit=max&auto=format&n=IKECEhkZu9f1KFmK&q=85&s=4f1d97a2d31f5e64fb4a075dde6239ff" alt="Trang chi tiết khách hàng hiển thị thông tin khách hàng và lịch sử giao dịch" style={{ maxHeight: '500px', width: 'auto' }} width="1657" height="931" data-path="images/customer/customer-details.png" />
</Frame>

### About Section

The About section displays core customer information:

* **Name**: Customer's full name
* **Email**: Customer's email address
* **Customer ID**: Unique identifier for API and tracking purposes
* **Created At**: Timestamp of when the customer account was created

### Customer Activity Tabs

The customer details page includes three tabs for viewing different aspects of customer activity:

<Tabs>
  <Tab title="Transactions History">
    View all payment transactions for this customer including:

    * **Payment ID**: Unique transaction identifier
    * **Status**: Payment status (Successful, Failed, Pending, Refunded)
    * **Amount**: Transaction amount
    * **Date (UTC)**: When the transaction occurred
    * **Pricing Type**: Whether it's a one-time purchase or subscription
    * **Payment Method**: Payment method used (Card, UPI, etc.)
    * **Customer Email**: Email associated with the transaction
    * **Refund**: Quick action to initiate refunds
    * **Actions**: Additional options for managing the transaction
  </Tab>

  <Tab title="Active Subscriptions">
    View all active subscriptions for this customer:

    * Subscription plan details
    * Billing cycle and next renewal date
    * Subscription status
    * Options to manage or cancel subscriptions
  </Tab>

  <Tab title="Wallet Ledger">
    Xem sổ cái giao dịch ví của khách hàng hiển thị:

    * Tất cả các lần bổ sung và khấu trừ quỹ

    * Số dư ví hiện tại theo từng loại tiền (USD, INR)

    * Lý do giao dịch và dấu thời gian

    * Lịch sử giao dịch chi tiết để đối chiếu
      Xem sổ cái tín dụng ví của khách hàng hiển thị:

    * Tất cả các giao dịch tín dụng và ghi nợ

    * Số dư ví hiện tại theo từng loại tiền

    * Lý do giao dịch và dấu thời gian

    * Lịch sử giao dịch chi tiết để đối chiếu
  </Tab>
</Tabs>

<Note>
  Tab Sổ cái Ví cung cấp độ minh bạch đầy đủ về các giao dịch ví của khách hàng, giúp dễ dàng theo dõi việc bổ sung quỹ, khấu trừ và số dư tiền hiện tại.
</Note>

## Cổng Khách hàng

Cổng Khách hàng là một khu vực tự phục vụ được lưu trữ an toàn, nơi khách hàng của bạn có thể quản lý đăng ký, xem lịch sử thanh toán, truy cập khóa giấy phép và cập nhật hồ sơ — mà không cần liên hệ bộ phận hỗ trợ.

### Khả năng của Cổng

Khách hàng có thể truy cập cổng để:

* **Xem Lịch sử Thanh toán**: Xem tất cả giao dịch trước đây và tải xuống hóa đơn.
* **Quản lý Đăng ký**: Hủy hoặc xem chi tiết đăng ký.
* **Lấy Khóa Giấy phép**: Truy cập tất cả khóa giấy phép liên quan đến giao dịch mua của họ.
* **Cập nhật Hồ sơ**: Thay đổi tên, email hoặc số điện thoại.

<Card title="Learn More About Customer Portal" icon="id-card" href="/features/customer-portal">
  Khám phá tài liệu chi tiết về các tính năng cổng, phương thức truy cập và ví dụ tích hợp.
</Card>

## Ví của Khách hàng

Ví của Khách hàng là các tài khoản số dư tiền trả trước dành cho khách hàng của bạn. Mỗi khách hàng tự động nhận được một ví có thể chứa tiền thật bằng nhiều loại tiền (USD và INR), có thể áp dụng cho hóa đơn đăng ký, dùng để hoàn tiền hoặc nạp tiền bằng tiền thưởng khuyến mãi.

### Tính năng chính

* **Hỗ trợ Đa tiền tệ**: Theo dõi số dư tiền riêng biệt theo USD và INR.
* **Số dư Trả trước**: Khách hàng có thể giữ quỹ để áp dụng cho các hóa đơn và thanh toán đăng ký trong tương lai.
* **Lịch sử Giao dịch**: Xem sổ cái đầy đủ của tất cả các lần bổ sung và khấu trừ quỹ.
* **Thiết kế API-First**: Thêm, khấu trừ và kiểm tra số dư ví theo chương trình.
* **Thanh toán Dựa trên Tín dụng**: Cho phép khách hàng mua tín dụng trước và sử dụng chúng cho dịch vụ của bạn.
* **Lịch sử Giao dịch**: Xem sổ cái đầy đủ của tất cả tín dụng và ghi nợ.
* **Thiết kế API-First**: Thêm, xóa và kiểm tra số dư ví theo chương trình.

<Card title="Learn More About Customer Wallets" icon="wallet" href="/features/customer-wallet">
  Khám phá tài liệu chi tiết, ví dụ mã và các phương pháp hay nhất để quản lý số dư ví khách hàng.
</Card>

## Quản lý API

Dodo Payments cung cấp một REST API toàn diện để quản lý khách hàng theo chương trình. Bạn có thể tạo, truy xuất, cập nhật và quản lý khách hàng hoàn toàn thông qua API.

### Các điểm cuối API có sẵn

<CardGroup cols={2}>
  <Card title="Create Customer" icon="user-plus" href="/api-reference/customers/create-customer">
    Tạo một khách hàng mới trong tài khoản Dodo Payments của bạn với thông tin của họ.
  </Card>

  <Card title="List Customers" icon="list" href="/api-reference/customers/get-customers">
    Truy xuất danh sách phân trang tất cả khách hàng liên kết với tài khoản của bạn.
  </Card>

  <Card title="Get Customer Details" icon="user" href="/api-reference/customers/get-customers-1">
    Nhận thông tin chi tiết về một khách hàng cụ thể theo ID của họ.
  </Card>

  <Card title="Update Customer" icon="pen" href="/api-reference/customers/patch-customer">
    Cập nhật thông tin khách hàng như tên, email hoặc metadata.
  </Card>

  <Card title="Delete Payment Method" icon="trash" href="/api-reference/customers/delete-payment-method">
    Xóa phương thức thanh toán đã lưu khỏi tài khoản khách hàng.
  </Card>

  <Card title="Create Portal Session" icon="arrow-up-right-from-square" href="/api-reference/customers/create-customer-portal-session">
    Tạo liên kết phiên Cổng thông tin khách hàng an toàn cho một khách hàng cụ thể.
  </Card>
</CardGroup>

<Note>
  Tất cả các điểm cuối API đều yêu cầu xác thực bằng khóa API của bạn. Luôn sử dụng khóa bí mật của bạn ở phía máy chủ và không bao giờ tiết lộ nó trong mã phía máy khách.
</Note>
