Chuyển đến nội dung chính
Sản phẩm là nền tảng của Dodo Payments. Dù bạn bán tải xuống một lần, đăng ký định kỳ hay truy cập theo mức sử dụng, bạn cũng bắt đầu bằng cách tạo một sản phẩm. Mỗi sản phẩm xác định cách nó được định giá, hiển thị tại thanh toán và thực hiện sau khi mua.

One‑Time

Tính phí một lần cho quyền truy cập trọn đời hoặc một sản phẩm giao duy nhất.

Subscriptions

Lập hóa đơn theo lịch với thời gian dùng thử, chia tỷ lệ và tiện ích bổ sung.

Usage‑Based

Đo lường mức tiêu thụ và tính phí theo mức sử dụng thực tế.

​
Tạo một sản phẩm

Bạn có thể tạo sản phẩm từ bảng điều khiển hoặc qua API. Chọn mô hình giá cả ngay từ đầu, Một lần, Đăng ký, hoặc Dựa trên mức sử dụng và sau đó cấu hình chi tiết. Mô hình giá không thể thay đổi sau này; hãy tạo một sản phẩm mới nếu bạn cần một mô hình khác.
1

Name & description

Cung cấp tiêu đề rõ ràng và mô tả ngắn gọn tập trung vào giá trị. Markdown được hỗ trợ trong phần mô tả.
Giữ câu đầu tiên hướng đến khách hàng và tập trung vào kết quả; nó xuất hiện nổi bật trong trang thanh toán.
Products
2

Pricing model & price

Select the pricing model:
  • Một lần: Giá cố định được thanh toán một lần.
  • Đăng ký: Giá định kỳ với khoảng thời gian và thử nghiệm tùy chọn.
  • Dựa trên mức sử dụng: Giá được xác định từ các sự kiện đo lường.
Sau đó thiết lập giá:
  • Giá: Số tiền cơ bản và loại tiền tệ.
  • Giảm giá (%): Giảm giá tùy chọn hiển thị trong thanh toán và hóa đơn.
  • Đối với các đăng ký, thiết lập Lặp lại mỗi (ví dụ: 1 tháng hoặc 1 năm) và Ngày thử nghiệm nếu cần.
Thay đổi giá chỉ ảnh hưởng đến các giao dịch mua mới. Các đăng ký hiện có tuân theo quy tắc thay đổi gói.
3

Product media

Tải hình ảnh để giới thiệu sản phẩm trên trang thanh toán và hóa đơn. Hỗ trợ PNG/JPG/WebP lên đến 3 MB. Có thể sắp xếp lại hoặc thay thế bất cứ lúc nào.
4

Automated entitlements (Under Advanced Settings)

Đính kèm phần thực hiện kích hoạt tự động sau khi thanh toán:
  • Khóa bản quyền: Cấp phát và xác thực các khóa duy nhất
  • Tải xuống tệp: Cấp quyền truy cập tệp an toàn
  • Tùy chỉnh: Kích hoạt logic quyền lợi của riêng bạn qua webhooks
Add or remove benefits as your offer evolves. Existing subscribers gain or lose access accordingly.

​
Biến thể và tùy chọn giá

Thay vì tạo các biến thể dưới một sản phẩm, hãy tạo các sản phẩm riêng biệt cho mỗi tùy chọn giá (ví dụ, hàng tháng và hàng năm). Sau đó nhóm chúng vào một Bộ sưu tập sản phẩm để trình bày tất cả các tùy chọn trong một quy trình thanh toán duy nhất và cho phép chuyển đổi kế hoạch trong Cổng thông tin Khách hàng.
Product Collections

​
Tại sao lại chọn phương pháp này?

  • Mô hình giá rõ ràng: Mỗi sản phẩm có một mô hình giá duy nhất, xác định rõ (một lần, đăng ký, hoặc theo mức sử dụng)
  • API dự đoán được: Tích hợp đơn giản hơn mà không có logic biến thể lồng nhau
  • Báo cáo dễ dàng hơn: Theo dõi doanh thu và số liệu theo từng sản phẩm mà không cần tổng hợp biến thể
  • Quy trình thanh toán linh hoạt: Hiển thị nhiều sản phẩm cạnh nhau, cho phép khách hàng so sánh và chọn lựa

​
Cách thức hoạt động của Bộ sưu tập sản phẩm

  1. Tạo sản phẩm: Thiết lập các sản phẩm riêng cho mỗi kế hoạch (ví dụ, Gói Khởi đầu hàng tháng, Gói Khởi đầu hàng năm, Gói Chuyên nghiệp hàng tháng, Gói Chuyên nghiệp hàng năm)
  2. Nhóm vào một bộ sưu tập: Thêm các sản phẩm liên quan vào một Bộ sưu tập sản phẩm
  3. Thanh toán thống nhất: Khách hàng thấy tất cả tùy chọn trong một quy trình thanh toán và chọn kế hoạch mong muốn
  4. Chuyển đổi kế hoạch: Khách hàng có thể nâng cấp hoặc hạ cấp giữa các sản phẩm trong cùng một bộ sưu tập thông qua Cổng thông tin Khách hàng

Product Collections

Nhóm các sản phẩm liên quan lại với nhau để có trải nghiệm thanh toán thống nhất và đường nâng cấp/giảm cấp liền mạch.

​
Quản lý sản phẩm

Bạn có thể quản lý sản phẩm thông qua bảng điều khiển hoặc lập trình thông qua API. API cung cấp quyền kiểm soát đầy đủ về việc tạo, cập nhật, truy xuất, tải lên hình ảnh và lưu trữ sản phẩm.

​
Quản lý Bảng điều khiển

  • Cập nhật: Chỉnh sửa tên, mô tả, hình ảnh, giá, trường dữ liệu và lợi ích bất kỳ lúc nào (mô hình giá là không thể thay đổi).
  • Lưu trữ: Ẩn một sản phẩm khỏi các giao dịch mua mới mà không làm gián đoạn khách hàng hiện tại. Bạn có thể khôi phục lại sau.

​
Quản lý API

Các hướng dẫn sau đây cho phép bạn tạo, cập nhật, quản lý và truy xuất sản phẩm, bao gồm cả việc tải lên hình ảnh.
Sản phẩm có thể là mặt hàng mua một lần hoặc dịch vụ dựa trên đăng ký. Để tạo sản phẩm mới, gửi yêu cầu POST đến endpoint /products với các thông tin như tên, mô tả, giá, đơn vị tiền tệ và liệu nó có phải là sản phẩm định kỳ hay không.Đối với sản phẩm định kỳ, thiết lập recurring: true và chỉ định billing_cycle (daily, weekly, monthly, yearly).

Create Product API

Xem cấu trúc yêu cầu và phản hồi chi tiết trong tài liệu API Tạo Sản phẩm.
Để sửa đổi một sản phẩm hiện có, gửi yêu cầu PATCH đến endpoint /products/{product_id}. Bạn có thể cập nhật các thuộc tính như tên, giá và mô tả trong khi giữ nguyên các chi tiết khác.Đảm bảo rằng product_id trong endpoint trùng khớp với một sản phẩm hiện có.

Update Product API

Xem cấu trúc yêu cầu và phản hồi chi tiết trong tài liệu API Cập nhật sản phẩm.
Bạn có thể lấy danh sách các sản phẩm lưu trữ trong tài khoản bằng cách gửi yêu cầu GET đến endpoint /products. Điều này cho phép bạn truy xuất chi tiết sản phẩm, bao gồm cả sản phẩm đang hoạt động và đã lưu trữ.

Retrieve Products API

Xem cấu trúc yêu cầu và phản hồi chi tiết trong tài liệu API Truy xuất sản phẩm.
Bạn có thể liên kết hình ảnh với một sản phẩm bằng cách tải nó lên AWS S3 thông qua URL được ký trước do API cung cấp. Trước tiên, yêu cầu URL tải hình ảnh từ endpoint /products/{product_id}/images, sau đó dùng URL đó để tải hình ảnh lên trong vòng 60 giây.
URL được ký trước hết hạn sau 60 giây, vì vậy hình ảnh phải được tải lên trong khoảng thời gian đó.
Sau khi nhận được URL được ký trước từ API, tải hình ảnh lên bằng phương thức PUT. Điều này đảm bảo truy cập tạm thời và an toàn tới AWS S3 để tải hình ảnh lên.Các thư viện được hỗ trợ để tải lên S3:
  • Node.js: axios, node-fetch
  • Python: requests, boto3
  • Go: net/http
  • PHP: GuzzleHttp
  • Ruby: rest-client
Nếu việc tải lên thành công, AWS S3 sẽ trả về tình trạng 200 OK, cho biết hình ảnh đã được lưu trữ thành công.

Upload Product Image API

Xem cấu trúc yêu cầu và phản hồi chi tiết trong tài liệu API Tải hình ảnh sản phẩm.
Nếu bạn không còn muốn hiển thị hoặc sử dụng sản phẩm, bạn có thể lưu trữ nó bằng cách gửi yêu cầu POST đến endpoint /products/{product_id}/archive. Hành động này ẩn sản phẩm nhưng không xóa vĩnh viễn.

Archive Product API

Xem cấu trúc yêu cầu và phản hồi chi tiết trong tài liệu API Lưu trữ sản phẩm.
Nếu bạn cần khôi phục một sản phẩm đã lưu trữ, gửi yêu cầu POST đến endpoint /products/{product_id}/unarchive. Điều này sẽ kích hoạt lại sản phẩm và cho phép sử dụng trở lại.

Unarchive Product API

Xem cấu trúc yêu cầu và phản hồi chi tiết trong tài liệu API Khôi phục sản phẩm.

​
Các thực tiễn tốt nhất

  • Bắt đầu với sự rõ ràng: Tạo các sản phẩm cho mỗi tùy chọn giá (Hàng tháng vs Hàng năm)
  • Sử dụng dùng thử một cách hợp lý: Kết hợp dùng thử với hướng dẫn để tăng cường hoạt động
  • Tự động hóa việc thực hiện: Sử dụng lợi ích và webhook để giao hàng ngay lập tức
  • Ghi nhãn với siêu dữ liệu: Lưu trữ các ID hệ thống của bạn để giải quyết
Bạn đã sẵn sàng tạo sản phẩm và bắt đầu bán - mua một lần, định kỳ hoặc theo mức sử dụng.

​
Liên quan

Product Analytics

Theo dõi doanh thu, khách hàng, tỷ lệ giữ chân, người đăng ký và MRR cho từng sản phẩm riêng lẻ.