Chuyển đến nội dung chính

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.

Cổng Khách hàng là một khu vực bảo mật, được lưu trữ nơi khách hàng của bạn có thể quản lý đăng ký, xem hóa đơn và truy cập chi tiết khóa cấp phép—mà không cần liên hệ bộ phận hỗ trợ.

Create Portal Session (API)

Tạo phiên cổng bảo mật có giới hạn thời gian một cách lập trình.

Subscriptions

Quản lý các gói định kỳ, nâng cấp, hạ cấp và tiện ích bổ sung.

Cổng thông tin khách hàng cải tiến hiển thị đăng ký hoạt động, phương thức thanh toán và lịch sử thanh toán

Cổng Thông Tin Khách Hàng Là Gì?

Cổng thông tin cung cấp một trải nghiệm tự phục vụ đáng tin cậy, có thương hiệu cho khách hàng để:
  • Truy cập lịch sử thanh toán: Xem hóa đơn và tải xuống biên lai.
  • Quản lý đăng ký: Xem chi tiết đăng ký, hủy đăng ký ngay lập tức hoặc vào ngày thanh toán tiếp theo.
  • Cập nhật phương thức thanh toán: Thay đổi phương thức thanh toán cho các đăng ký đang hoạt động hoặc kích hoạt lại các đăng ký đang tạm dừng.
  • Lấy lại khóa giấy phép: Truy cập tất cả các khóa liên quan đến giao dịch mua.
  • Điều hướng dễ dàng: Sử dụng nút quay lại để di chuyển giữa các phần của cổng thông tin mà không mất ngữ cảnh.

Lợi Ích Chính

  • Giảm khối lượng hỗ trợ: Khách hàng tự giải quyết các yêu cầu thanh toán thông thường
  • Thời gian đạt giá trị nhanh hơn: Truy cập hóa đơn và mã khóa ngay lập tức
  • Giảm nguy cơ mất khách: Tầm nhìn rõ ràng về gia hạn và chi tiết kế hoạch
  • Bảo mật theo thiết kế: Truy cập token hóa với các liên kết hết hạn
  • Trải nghiệm địa phương hóa: Cổng thông tin khả dụng bằng 21 ngôn ngữ, tự động nhận diện dựa trên tùy chọn trình duyệt của khách hàng

Phương Thức Truy Cập

Khách hàng có thể truy cập cổng thông tin bằng cách sử dụng liên kết tĩnh hoặc liên kết động một lần.

Liên kết tĩnh (truy cập qua email)

Khách hàng có thể yêu cầu truy cập cổng thông tin bằng cách nhập email của họ tại một liên kết tĩnh không bao giờ hết hạn. Định dạng liên kết cổng tĩnh thay đổi theo môi trường: Chế độ Kiểm Tra (dành cho kiểm tra và phát triển):
https://test.customer.dodopayments.com/login/{business_id}
Chế độ Trực Tiếp (dành cho sản xuất với các giao dịch thực):
https://customer.dodopayments.com/login/{business_id}
Thay {business_id} bằng định danh doanh nghiệp thực tế của bạn, sau đó chia sẻ liên kết phù hợp với khách hàng để họ nhập email và nhận quyền truy cập bảo mật vào cổng.
Màn hình đăng nhập dựa trên email
1

Merchant flow

  1. Đi đến Sales → Customer.
  2. Nhấp Share invite.
  3. Sao chép Static link và chia sẻ với khách hàng.
2

Customer flow

  1. Mở liên kết tĩnh.
  2. Nhập email đã dùng khi mua hàng.
  3. Nhận liên kết đăng nhập bảo mật để truy cập cổng.
Khách hàng hiện tại được nhận diện tự động.

Liên kết động (liên kết ma thuật)

Một liên kết ma thuật cá nhân hóa, một lần gửi khách hàng trực tiếp vào cổng thông tin. Liên kết này hết hạn trong 24 giờ.
Liên kết động hết hạn sau 24 giờ. Nếu quá hạn, hãy tạo và gửi liên kết mới.
Truy cập trực tiếp liên kết ma thuật
1

Merchant flow

  1. Đi đến Sales → Customer.
  2. Nhấp Share invite.
  3. Sao chép Dynamic link và chia sẻ với khách hàng.
2

Customer flow

  1. Mở liên kết động.
  2. Truy cập Cổng Khách hàng trực tiếp mà không cần nhập email.

Tính Năng Cổng Thông Tin

Cổng Khách hàng mới mang đến giao diện gọn gàng, thống nhất với thanh bên trái và các mục được tổ chức cho mọi nhu cầu quản lý tài khoản.

Active Subscriptions

Xem tất cả đăng ký đang hoạt động cùng tên gói, giá, ngày gia hạn và thời hạn hiệu lực. Nhấp “Manage subscription” để xem chi tiết, chỉnh sửa thông tin thanh toán hoặc hủy.

Payment Methods

Xem tất cả phương thức thanh toán đã lưu (thẻ, UPI, v.v.) trong nháy mắt. Chỉnh sửa phương thức trực tiếp từ chi tiết đăng ký.

Billing History

Xem tất cả giao dịch trong bảng chi tiết kèm ngày, trạng thái, loại giá, quyền lợi và hóa đơn có thể tải xuống.

Billing Information

Xem và chỉnh sửa tên, email, số điện thoại và địa chỉ thanh toán từ trang chi tiết đăng ký.

Tổng quan Cổng

Trang chính của cổng hiển thị tất cả đăng ký đang hoạt động, phương thức thanh toán đã lưu và lịch sử thanh toán chỉ trong một khung cuộn duy nhất.
Trang chính của Cổng thông tin khách hàng hiển thị đăng ký hoạt động và phương thức thanh toán

Phương thức thanh toán & Lịch sử thanh toán

Cuộn xuống để xem các phương thức thanh toán đã lưu và lịch sử thanh toán đầy đủ với chỉ báo trạng thái và hóa đơn có thể tải xuống.
Phương thức thanh toán và lịch sử thanh toán với tải xuống hóa đơn

Hỗ trợ ngôn ngữ

Cổng thông tin khách hàng khả dụng bằng 21 ngôn ngữ, cho phép khách hàng của bạn quản lý đăng ký, phương thức thanh toán và lịch sử thanh toán bằng ngôn ngữ họ cảm thấy thoải mái nhất.

Cách thức chọn ngôn ngữ hoạt động

  • Phát hiện tự động: Khi truy cập lần đầu, cổng thông tin sẽ phát hiện ngôn ngữ ưa thích của khách hàng từ cài đặt trình duyệt của họ và tải bản dịch tương ứng nếu có. Tiếng Anh sẽ được dùng làm ngôn ngữ dự phòng.
  • Ghi đè thủ công: Khách hàng có thể thay đổi ngôn ngữ đang hoạt động bất cứ lúc nào từ bộ chọn ngôn ngữ trong tiêu đề của cổng thông tin (có sẵn trên cả máy tính để bàn và di động).
  • Lưu lại sự lựa chọn: Ngôn ngữ đã chọn được lưu trong cookie NEXT_LOCALE (hợp lệ trong 1 năm) để cổng thông tin nhớ đến sự lựa chọn này qua các phiên làm việc.

Ngôn ngữ được hỗ trợ

Ngôn ngữNgôn ngữ
Tiếng Anh (mặc định)enTiếng Indonesiaid
Tiếng Ả RậparTiếng Ýit
Tiếng CatalancaTiếng Nhậtja
Tiếng TrungzhTiếng Hànko
Tiếng Hà LannlTiếng Mã Laims
Tiếng PhápfrTiếng Ba Lanpl
Tiếng ĐứcdeTiếng Bồ Đào Nhapt
Tiếng HebrewheTiếng Romaniaro
Tiếng NgaruTiếng Tây Ban Nhaes
Tiếng Thụy ĐiểnsvTiếng Tháith
Tiếng Thổ Nhĩ Kỳtr

Thay đổi kế hoạch (Nâng cấp/hạ cấp)

Khi sản phẩm được tổ chức thành Bộ sưu tập sản phẩm, khách hàng có thể nâng cấp hoặc hạ cấp giữa các gói trực tiếp từ Cổng thông tin khách hàng.
Muốn kích hoạt nâng cấp/hạ cấp cho các đăng ký hiện có? Thêm sản phẩm đăng ký của bạn vào một Bộ sưu tập sản phẩm. Một khi đã nhóm, khách hàng có thể chuyển đổi giữa các gói trong cùng một bộ sưu tập thông qua Cổng thông tin khách hàng.

Hành động có sẵn

Hành độngMô tảKhi có sẵn
Nâng cấpChuyển sang gói cao hơn trong cùng bộ sưu tậpDoanh nghiệp đã bật cập nhật đăng ký
Hạ cấpChuyển sang gói thấp hơn trong cùng bộ sưu tậpDoanh nghiệp đã bật cập nhật đăng ký

Cách thức thay đổi kế hoạch hoạt động

  1. Khách hàng xem đăng ký hiện tại của họ trong cổng thông tin
  2. Các tùy chọn nâng cấp/hạ cấp có sẵn được hiển thị dựa trên bộ sưu tập sản phẩm
  3. Khách hàng chọn gói mới
  4. Proration được tính toán và thanh toán được xử lý ngay lập tức (nếu có)
  5. Đăng ký được cập nhật sang gói mới
Thay đổi kế hoạch chỉ có sẵn giữa các sản phẩm trong cùng bộ sưu tập. Sản phẩm phải là loại thanh toán theo đăng ký hoặc sử dụng.

Kiểm soát kinh doanh

Doanh nghiệp có thể cấu hình hành vi thay đổi kế hoạch trong Cài đặt đăng ký:
  • Cho phép cập nhật đăng ký: Bật hoặc tắt khả năng cho khách hàng nâng cấp hoặc hạ cấp đăng ký của họ

Product Collections

Tìm hiểu cách thức thiết lập bộ sưu tập sản phẩm và cấu hình đường dẫn nâng cấp/hạ cấp.

Chi tiết đăng ký

Khi khách hàng nhấp vào “Quản lý đăng ký” trên bất kỳ đăng ký hoạt động nào, họ sẽ được dẫn đến trang chi tiết đăng ký. Trang này hiển thị:
  • Chi tiết kế hoạch: Tên đăng ký, giá, ngày gia hạn và thời gian có hiệu lực
  • Phương thức thanh toán: Thẻ hoặc phương thức thanh toán liên kết với đăng ký, với nút “Chỉnh sửa”
  • Thông tin thanh toán: Tên, email, số điện thoại và địa chỉ thanh toán với nút “Chỉnh sửa”
  • Lịch sử thanh toán: Một bảng chi tiết tất cả các khoản thanh toán cho đăng ký này
  • Hủy đăng ký: Nút nổi bật để hủy đăng ký
Trang chi tiết đăng ký hiển thị thông tin gói, phương thức thanh toán, thông tin thanh toán và tùy chọn hủy

Hủy đăng ký

Khách hàng có thể hủy đăng ký của họ trực tiếp từ trang chi tiết đăng ký. Nhấp vào “Hủy đăng ký” sẽ mở cửa sổ xác nhận với hai lựa chọn:
  • Hủy vào ngày thanh toán tiếp theo: Đăng ký vẫn hoạt động cho đến khi kết thúc kỳ thanh toán hiện tại, sau đó tự động hủy.
  • Hủy ngay: Đăng ký bị hủy ngay lập tức.
Hộp thoại hủy đăng ký với tùy chọn hủy vào ngày thanh toán tiếp theo hoặc hủy ngay

Lý Do Hủy Bỏ

Trước khi xác nhận hủy, khách hàng sẽ được hỏi “Tại sao bạn muốn hủy?” và được yêu cầu chọn một lý do từ danh sách đã chọn lọc. Lý do này được lưu trên đăng ký và hiển thị trong payload webhook và API, để bạn có thể phân tích nguyên nhân rời bỏ và điều chỉnh dòng chảy thu hồi lại khách hàng.
Hộp thoại hủy với danh sách lý do 'Tại sao bạn muốn hủy?' như Quá đắt, Thiếu tính năng, và Khác
Giá trịNhãn đối diện khách hàng
too_expensiveQuá đắt
missing_featuresThiếu tính năng
switched_serviceChuyển sang dịch vụ khác
unusedKhông sử dụng đủ nhiều
customer_serviceDịch vụ khách hàng kém
low_qualityChất lượng kém
too_complexQuá phức tạp
otherKhác
Giá trị đã chọn được ghi vào trường cancellation_feedback của đăng ký. Cũng có thể nắm bắt thêm một văn bản tự do tùy chọn cancellation_comment.
// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"
Cả hai trường cũng được bao gồm trong payload webhook subscription.cancelled, và bạn có thể điền chúng theo lập trình trên PATCH /subscriptions/{id} khi lập lịch hoặc thực hiện việc hủy qua API.
Kết hợp cancellation_feedback với Subscription Dunning để điều chỉnh email thu hồi — ví dụ, gửi mã giảm giá cho người hủy too_expensive và một khảo sát ‘còn thiếu gì?’ cho người hủy missing_features.

Cập Nhật Phương Thức Thanh Toán

Khách hàng có thể cập nhật phương thức thanh toán của họ trực tiếp từ trang chi tiết đăng ký bằng cách nhấp vào “Chỉnh sửa” cạnh phương thức thanh toán. Chức năng này đặc biệt quan trọng để kích hoạt lại các đăng ký đã bị tạm dừng do thanh toán thất bại.

Kích Hoạt Lại Đăng Ký Đang Bị Tạm Dừng

Khi một đăng ký được đặt vào trạng thái on_hold do thanh toán thất bại, khách hàng phải cập nhật phương thức thanh toán của mình để kích hoạt lại. Quá trình cập nhật tự động:
  1. Tạo một khoản phí cho số tiền còn lại
  2. Tạo hóa đơn cho khoản phí
  3. Xử lý thanh toán sử dụng phương thức thanh toán mới
  4. Kích hoạt lại đăng ký sang trạng thái active khi thanh toán thành công
Đăng ký trong trạng thái on_hold sẽ không tự động gia hạn. Khách hàng phải cập nhật phương thức thanh toán để xóa số tiền còn lại và kích hoạt lại đăng ký.
Sau khi cập nhật thành công phương thức thanh toán cho một đăng ký on_hold, khách hàng sẽ thấy một trang xác nhận và nhận được thông báo email về thanh toán thành công và kích hoạt lại đăng ký.

Luồng Cập Nhật Phương Thức Thanh Toán

1

Access subscription details

Nhấp vào “Quản lý đăng ký” trên bất kỳ đăng ký nào đang hoạt động từ trang chủ cổng thông tin.
2

Click Edit on payment method

Nhấp vào nút “Chỉnh sửa” bên cạnh phương thức thanh toán để mở giao diện cập nhật phương thức thanh toán.
3

Select or add payment method

Chọn một phương thức thanh toán đã lưu sẵn hoặc thêm một phương thức mới bằng cách nhập chi tiết thẻ thanh toán một cách an toàn.
4

Confirm changes

Xác nhận cập nhật. Đối với các đăng ký on_hold, thao tác này sẽ tự động tạo ra một khoản phí cho số tiền còn lại.
5

Complete payment (if on hold)

Nếu đăng ký bị tạm dừng, khách hàng sẽ được chuyển hướng để hoàn thành thanh toán cho số tiền còn lại. Khi thanh toán thành công, đăng ký sẽ tự động được kích hoạt lại.
6

Confirmation

Khách hàng nhận được xác nhận rằng phương thức thanh toán đã được cập nhật và nếu có, đăng ký đã được kích hoạt lại.

Ví Dụ Tích Hợp

Tạo một phiên Customer Portal có thời hạn cho một khách hàng cụ thể qua API, sau đó chuyển hướng người dùng đến URL phiên làm việc.
const session = await client.customers.customerPortal.create('cus_123');

// Redirect the user to the hosted Customer Portal
window.location.href = session.link;

Cổng Thông Tin Khách Hàng Thống Nhất

Ngoài cổng thông tin khách hàng cụ thể cho doanh nghiệp, Dodo Payments cung cấp Cổng Thông Tin Khách Hàng Thống Nhất tại customer.dodopayments.com, nơi khách hàng có thể xem và quản lý tất cả các giao dịch mua và đăng ký của họ qua các doanh nghiệp khác nhau sử dụng Dodo Payments.
Cổng Thông Tin Khách Hàng Thống Nhất

Tính Năng Cổng Thông Tin Thống Nhất

  • Tầm nhìn trên mọi doanh nghiệp: Xem tất cả các giao dịch mua và đăng ký từ bất kỳ thương gia Dodo Payments nào tại một nơi
  • Quản lý tập trung: Quản lý các đăng ký qua các doanh nghiệp khác nhau từ một bảng điều khiển duy nhất
  • Lịch sử thanh toán thống nhất: Truy cập hóa đơn và lịch sử thanh toán từ tất cả các giao dịch mua
  • Đăng nhập một lần: Đăng nhập một lần bằng email để truy cập các giao dịch mua từ tất cả các thương gia Dodo Payments
Cổng Thông Tin Khách Hàng Thống Nhất bổ sung cho các cổng thông tin cụ thể của doanh nghiệp. Khách hàng có thể sử dụng cả cổng thương hiệu của thương gia hoặc cổng thống nhất tùy theo sở thích của họ.

Khắc Phục Sự Cố

  • Liên kết đã hết hạn: Tạo và gửi liên kết động mới.
  • Email không được nhận diện: Yêu cầu khách hàng sử dụng email liên kết với giao dịch mua của họ
  • Đăng ký bị tạm dừng: Nếu đăng ký bị tạm dừng, khách hàng phải cập nhật phương thức thanh toán qua cổng thông tin để xóa số tiền còn lại và kích hoạt lại đăng ký. Quá trình cập nhật sẽ tự động trừ đi số tiền còn lại.
  • Cập nhật phương thức thanh toán thất bại: Nếu thanh toán thất bại trong quá trình cập nhật phương thức cho một đăng ký on_hold, đăng ký sẽ vẫn bị tạm dừng. Khách hàng có thể thử lại với một phương thức thanh toán khác.

Design & Theme Customization

Tùy chỉnh giao diện cổng thông tin khách hàng của bạn với chủ đề, kiểu chữ, màu sắc được xây dựng sẵn, và xem trước trực tiếp từ trang Thiết kế.
Last modified on May 14, 2026