Cổng Thông Tin Khách Hàng - Dodo Payments Documentation

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ý các gói đăng ký: Xem chi tiết gói đăng ký, tạm dừng và tiếp tục gói đăng ký, cũng như hủy gói đă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 gói đăng ký đang hoạt động hoặc kích hoạt lại các gói đăng ký đang bị tạm giữ.
Lấy khóa bản quyền: Truy cập tất cả các khóa liên kết với 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 mục trong portal 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.

Merchant flow

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

Customer flow

Mở liên kết tĩnh.
Nhập email đã dùng khi mua hàng.
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.

Merchant flow

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

Customer flow

Mở liên kết động.
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ả các gói đă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 vào “Quản lý gói đăng ký” để xem chi tiết, chỉnh sửa thông tin thanh toán, tạm dừng 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ữ	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.

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 độ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 đăng ký của portal trong Subscription Settings:

Cho phép cập nhật gói đăng ký: Bật hoặc tắt khả năng nâng cấp hoặc hạ cấp gói đăng ký của khách hàng
Cho phép hủy gói đăng ký: Bật hoặc tắt khả năng khách hàng tự hủy gói đăng ký
Cho phép tạm dừng gói đăng ký: Bật hoặc tắt khả năng khách hàng tự tạm dừng và tiếp tục gói đăng ký

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 gói: Tên gói đăng ký, giá, ngày gia hạn và thời hạn hiệu lực
Phương thức thanh toán: Thẻ hoặc phương thức thanh toán được liên kết với gói đăng ký, cùng 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 cùng nút “Chỉnh sửa”
Lịch sử thanh toán: Bảng chi tiết tất cả các khoản thanh toán cho gói đăng ký này
Tạm dừng: Tùy chọn tạm dừng gói đăng ký, được hiển thị khi bạn cho phép khách hàng tự tạm dừng
Hủy gói đăng ký: Nút nổi bật để hủy gói đă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.

Tính năng tự hủy được kiểm soát bởi cài đặt Allow Subscription Cancellation trong Settings → Subscriptions, được bật theo mặc định. Khi bạn tắt tùy chọn này, nút Cancel Subscription sẽ bị vô hiệu hóa và hiển thị tooltip yêu cầu khách hàng liên hệ với bạn; cả hai cách hủy trong portal — hủy ngay và hủy vào ngày thanh toán tiếp theo — đều bị từ chối. Khách hàng đã lên lịch hủy vẫn có thể thu hồi yêu cầu hủy, để họ có thể chọn tiếp tục sử dụng. Các lần hủy do bạn tự thực hiện không bao giờ bị ảnh hưởng.

Hộp thoại hủy gói đăng ký với các tùy chọn hủy vào ngày thanh toán tiếp theo hoặc hủy ngay lập tức

Lý do hủy

Trước khi xác nhận hủy, khách hàng được hỏi “Why are you cancelling?” và yêu cầu chọn một lý do từ danh sách được tuyển chọn. Lý do này được lưu trong gói đăng ký và xuất hiện trong webhook payload cũng như API, giúp bạn phân tích các nguyên nhân gây rời bỏ và điều chỉnh các quy trình win-back phù hợp.

Modal hủy với menu thả xuống 'Why are you cancelling?' hiển thị các lý do như Too expensive, Missing features và Other

Value	Customer-facing label
`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 đủ
`customer_service`	Dịch vụ khách hàng kém
`low_quality`	Chất lượng thấp
`too_complex`	Quá phức tạp
`other`	Khác

Giá trị đã chọn được ghi vào trường cancellation_feedback của gói đăng ký. Bạn cũng có thể thu thập tùy chọn nhập văn bản tự do 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/{subscription_id} khi lên lịch hoặc thực hiện việc hủy thông qua API.

Kết hợp cancellation_feedback với Subscription Dunning để điều chỉnh email win-back — ví dụ: gửi mã giảm giá cho những khách hàng hủy vì too_expensive và gửi khảo sát “what’s missing?” cho những khách hàng hủy vì missing_features.

Tạm dừng gói đăng ký

Tạm dừng cung cấp cho khách hàng một lựa chọn trung gian giữa việc duy trì gói đăng ký và hủy hoàn toàn. Gói đăng ký bị tạm dừng sẽ ngừng tính phí nhưng vẫn giữ nguyên gói và lịch sử, để khách hàng có thể quay lại sau thay vì phải bắt đầu lại. Khách hàng mở hộp thoại tạm dừng từ trang chi tiết gói đăng ký. Hộp thoại hiển thị gói hiện tại, cảnh báo rằng quyền truy cập sẽ kết thúc ngay lập tức và giải thích cách các ngày thanh toán thay đổi. Khách hàng xác nhận bằng Tạm dừng gói đăng ký.

Thông tin khách hàng được thông báo và những gì thực sự xảy ra:

Quyền truy cập dừng ngay lập tức. Các tính năng, nội dung tải xuống và khóa bản quyền đi kèm gói đăng ký sẽ ngừng hoạt động cho đến khi gói đăng ký được tiếp tục.
Việc tạm dừng không có ngày kết thúc. Gói đăng ký vẫn bị tạm dừng cho đến khi khách hàng tiếp tục gói.
Không mất thời gian sử dụng. Ngày thanh toán tiếp theo và ngày gia hạn đều được lùi lại tương ứng với thời gian tạm dừng.

Việc tiếp tục gói đăng ký cũng diễn ra theo quy trình tương tự. Gói đăng ký trở về trạng thái active và quyền truy cập được khôi phục.

Tính năng tự tạm dừng được kiểm soát bởi cài đặt Cho phép tạm dừng gói đăng ký trong Settings → Subscriptions, và tính năng này bị tắt theo mặc định. Khi tính năng này tắt, khách hàng không thể bắt đầu lượt tạm dừng mới, dù khách hàng đang có gói bị tạm dừng vẫn có thể tiếp tục lượt tạm dừng do chính họ bắt đầu. Các lượt tạm dừng do bạn thực hiện từ dashboard không bị ảnh hưởng.

How Pausing Works

Toàn bộ hành vi tạm dừng, bao gồm ảnh hưởng đến thanh toán, quyết toán mức sử dụng và webhooks.

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 trực tiếp từ trang chi tiết gói đăng ký bằng cách nhấp vào “Chỉnh sửa” bên cạnh phương thức thanh toán. Tính năng này đặc biệt quan trọng để kích hoạt lại các gói đăng ký bị tạm giữ do thanh toán thất bại.

Kích hoạt lại các gói đăng ký bị tạm giữ

Khi một gói đăng ký chuyển sang 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 để kích hoạt lại gói. Quy trình cập nhật sẽ tự động:

Tạo một khoản charge cho các khoản còn nợ
Tạo một hóa đơn cho khoản charge
Xử lý khoản thanh toán bằng phương thức thanh toán mới
Kích hoạt lại gói đăng ký về trạng thái active khi thanh toán thành công

Các gói đăng ký ở 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 để thanh toán các khoản còn nợ và kích hoạt lại gói đăng ký.

Sau khi cập nhật thành công phương thức thanh toán cho gói đăng ký on_hold, khách hàng sẽ thấy trang xác nhận và nhận được email thông báo về việc thanh toán thành công cũng như kích hoạt lại gói đăng ký.

Quy trình cập nhật phương thức thanh toán

Access subscription details

Nhấp vào “Quản lý gói đăng ký” trên bất kỳ gói đăng ký đang hoạt động nào từ trang chủ của portal.

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 hoặc thêm phương thức mới bằng cách nhập thông tin thẻ một cách an toàn.

Confirm changes

Xác nhận cập nhật. Đối với các gói đăng ký on_hold, thao tác này sẽ tự động tạo một khoản charge cho các khoản còn nợ.

Complete payment (if on hold)

Nếu gói đăng ký đang bị tạm giữ, khách hàng sẽ được chuyển hướng để hoàn tất thanh toán các khoản còn nợ. Sau khi thanh toán thành công, gói đăng ký sẽ tự động được kích hoạt lại.

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 phù hợp, gói đă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ể thông qua API, sau đó chuyển hướng người dùng đến URL của phiên.

const session = await client.customers.customerPortal.create('cus_123');

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

Customer Portal hợp nhất

Ngoài các Customer Portal dành riêng cho từng doanh nghiệp, Dodo Payments cung cấp Customer Portal hợp nhất tại customer.dodopayments.com, nơi khách hàng có thể xem và quản lý tất cả giao dịch mua và gói đăng ký của họ trên nhiều doanh nghiệp khác nhau sử dụng Dodo Payments.

Tính năng của portal hợp nhất

Khả năng xem giữa các doanh nghiệp: Xem tất cả giao dịch mua và gói đăng ký từ bất kỳ merchant Dodo Payments nào tại một nơi
Quản lý tập trung: Quản lý các gói đăng ký trên nhiều doanh nghiệp khác nhau từ một dashboard duy nhất
Lịch sử thanh toán hợp nhất: Truy cập hóa đơn và lịch sử thanh toán của tất 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ả merchant Dodo Payments

Customer Portal hợp nhất bổ trợ cho các portal dành riêng cho từng doanh nghiệp. Khách hàng có thể sử dụng portal merchant mang thương hiệu hoặc portal hợp nhất tùy theo lựa chọn của họ.

Khắc phục sự cố

Liên kết đã hết hạn: Tạo và gửi một liên kết động mới.
Không nhận diện được email: Yêu cầu khách hàng sử dụng email được liên kết với giao dịch mua của họ
Gói đăng ký bị tạm giữ: Nếu một gói đăng ký bị tạm giữ, khách hàng phải cập nhật phương thức thanh toán thông qua portal để thanh toán các khoản còn nợ và kích hoạt lại gói đăng ký. Quy trình cập nhật sẽ tự động charge các khoản còn nợ.
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 cho gói đăng ký on_hold, gói đăng ký sẽ vẫn bị tạm giữ. Khách hàng có thể thử lại bằng một phương thức thanh toán khác.

Design & Theme Customization

Tùy chỉnh giao diện Customer Portal với các theme, kiểu chữ, màu sắc được tạo sẵn và bản xem trước trực tiếp từ trang Design.

Create Portal Session (API)

Subscriptions

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

​Lợi Ích Chính

​Phương Thức Truy Cập

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

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

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

Active Subscriptions

Payment Methods

Billing History

Billing Information

​Tổng quan Cổng

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

​Hỗ trợ ngôn ngữ

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

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

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

​Hành động có sẵn

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

​Kiểm soát kinh doanh

Product Collections

​Chi tiết đăng ký

​Hủy đăng ký

​Lý do hủy

​Tạm dừng gói đăng ký

How Pausing Works

​Cập nhật phương thức thanh toán

​Kích hoạt lại các gói đăng ký bị tạm giữ

​Quy trình cập nhật phương thức thanh toán

​Ví dụ tích hợp

​Customer Portal hợp nhất

​Tính năng của portal hợp nhất

​Khắc phục sự cố

Design & Theme Customization

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

Lợi Ích Chính

Phương Thức Truy Cập

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

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

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

Tổng quan Cổng

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

Hỗ trợ ngôn ngữ

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

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

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

Hành động có sẵn

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

Kiểm soát kinh doanh

Chi tiết đăng ký

Hủy đăng ký

Lý do hủy

Tạm dừng gói đăng ký

Cập nhật phương thức thanh toán

Kích hoạt lại các gói đăng ký bị tạm giữ

Quy trình cập nhật phương thức thanh toán

Ví dụ tích hợp

Customer Portal hợp nhất

Tính năng của portal hợp nhất

Khắc phục sự cố