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 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):{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.

Merchant flow
- Đi đến Sales → Customer.
- Nhấp Share invite.
- Sao chép Static link và chia sẻ với khách hà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ờ.
Merchant flow
- Đi đến Sales → Customer.
- Nhấp Share invite.
- Sao chép Dynamic link và chia sẻ với khách hàng.
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.
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.
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ữ | Mã | Ngôn ngữ | Mã |
|---|---|---|---|
| Tiếng Anh (mặc định) | en | Tiếng Indonesia | id |
| Tiếng Ả Rập | ar | Tiếng Ý | it |
| Tiếng Catalan | ca | Tiếng Nhật | ja |
| Tiếng Trung | zh | Tiếng Hàn | ko |
| Tiếng Hà Lan | nl | Tiếng Mã Lai | ms |
| Tiếng Pháp | fr | Tiếng Ba Lan | pl |
| Tiếng Đức | de | Tiếng Bồ Đào Nha | pt |
| Tiếng Hebrew | he | Tiếng Romania | ro |
| Tiếng Nga | ru | Tiếng Tây Ban Nha | es |
| Tiếng Thụy Điển | sv | Tiếng Thái | th |
| 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.Hành động có sẵn
| Hành động | Mô tả | Khi có sẵn |
|---|---|---|
| Nâng cấp | Chuyển sang gói cao hơn trong cùng bộ sưu tập | Doanh nghiệp đã bật cập nhật đăng ký |
| Hạ cấp | Chuyển sang gói thấp hơn trong cùng bộ sưu tập | Doanh nghiệp đã bật cập nhật đăng ký |
Cách thức thay đổi kế hoạch hoạt động
- Khách hàng xem đăng ký hiện tại của họ trong cổng thông tin
- 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
- Khách hàng chọn gói mới
- Proration được tính toán và thanh toán được xử lý ngay lập tức (nếu có)
- Đă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ý

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.

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.
| Giá trị | Nhãn đối diện khách hàng |
|---|---|
too_expensive | Quá đắt |
missing_features | Thiếu tính năng |
switched_service | Chuyển sang dịch vụ khác |
unused | Không sử dụng đủ nhiều |
customer_service | Dịch vụ khách hàng kém |
low_quality | Chất lượng kém |
too_complex | Quá phức tạp |
other | Khác |
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.
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.
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áion_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:
- Tạo một khoản phí cho số tiền còn lại
- Tạo hóa đơn cho khoản phí
- Xử lý thanh toán sử dụng phương thức thanh toán mới
- Kích hoạt lại đăng ký sang trạng thái
activekhi thanh toán thành công
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
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.
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.
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.
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.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.
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.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.
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
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ế.