Sản phẩm là nền tảng của Dodo Payments. Dù bạn bán một lần tải xuống, một đăng ký định kỳ, hay quyền truy cập dựa trên mức sử dụng, bạn 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á, trình bày tại thanh toán và thực hiện sau khi mua.
Một lần
Tính phí một lần cho quyền truy cập trọn đời hoặc một sản phẩm duy nhất.
Đăng ký
Tính phí theo lịch trình với các thử nghiệm, tỷ lệ và bổ sung.
Dựa trên mức sử dụng
Đ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.Tên & mô tả
Cung cấp một tiêu đề rõ ràng và một mô tả ngắn gọn, tập trung vào giá trị. Markdown được hỗ trợ trong các mô tả.
Mô hình giá & giá
Chọn mô hình giá:
- 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.
- 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.
Phương tiện sản phẩm
Tải lên hình ảnh để giới thiệu sản phẩm trong thanh toán và hóa đơn. Hỗ trợ PNG/JPG/WebP lên đến 3 MB. Sắp xếp lại hoặc thay thế bất cứ lúc nào.
Quyền lợi tự động (Dưới cài đặt nâng cao)
Gắn kết việc thực hiện tự động kích hoạt 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
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.
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
- 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)
- 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
- 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
- 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
Bộ sưu tập sản phẩm
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à các lộ trình nâng cấp/hạ 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.Tạo sản phẩm
Tạo sản phẩm
Một sản phẩm có thể là một mặt hàng một lần hoặc dịch vụ dựa trên đăng ký. Để tạo một sản phẩm mới, gửi một
POST yêu cầu đến điểm cuối /products với các chi tiết như tên, mô tả, giá, tiền tệ, và liệu đó có phải là sản phẩm định kỳ hay không.Đối với các sản phẩm định kỳ, thiết lập recurring: true và chỉ định một billing_cycle (daily, weekly, monthly, yearly).API Tạo sản phẩm
Xem chi tiết cấu trúc yêu cầu và phản hồi trong tài liệu API Tạo sản phẩm.
Cập nhật sản phẩm
Cập nhật sản phẩm
Để sửa đổi một sản phẩm hiện có, gửi một
PATCH yêu cầu đến điểm cuối /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 điểm cuối khớp với một sản phẩm hiện có.API Cập nhật sản phẩm
Xem chi tiết cấu trúc yêu cầu và phản hồi trong tài liệu API Cập nhật sản phẩm.
Truy xuất Sản phẩm
Truy xuất Sản phẩm
Bạn có thể lấy danh sách các sản phẩm được lưu trữ trong tài khoản của bạn bằng cách gửi một
GET yêu cầu đến điểm cuối /products. Điều này cho phép bạn truy xuất thông tin chi tiết sản phẩm, bao gồm sản phẩm đang hoạt động và đã lưu trữ.API Truy xuất Sản phẩm
Xem chi tiết cấu trúc yêu cầu và phản hồi trong tài liệu API Truy xuất Sản phẩm.
Tải lên Hình ảnh Sản phẩm
Tải lên Hình ảnh Sản phẩm
Bạn có thể liên kết một hình ảnh với một sản phẩm bằng cách tải lên nó lên AWS S3 thông qua một URL đã ký trước được cung cấp bởi API. Trước tiên, yêu cầu một URL tải lên hình ảnh từ điểm cuối
/products/{product_id}/images, sau đó sử dụng URL được cung cấp để tải lên hình ảnh trong vòng 60 giây.Khi nhận được URL đã ký, hãy tải lên hình ảnh bằng cách sử dụng phương thức PUT. Điều này đảm bảo quyền truy cập an toàn và tạm thời đến AWS S3 để tải lên hình ảnh.Các thư viện hỗ trợ tải lên S3:- Node.js:
axios,node-fetch - Python:
requests,boto3 - Go:
net/http - PHP:
GuzzleHttp - Ruby:
rest-client
200 OK trạng thái, cho biết rằng hình ảnh đã được lưu trữ thành công.API Tải lên Hình ảnh Sản phẩm
Xem chi tiết cấu trúc yêu cầu và phản hồi trong tài liệu API Tải lên Hình ảnh Sản phẩm.
Lưu trữ một Sản phẩm
Lưu trữ một Sản phẩm
Nếu bạn không còn muốn hiển thị hoặc sử dụng một sản phẩm, bạn có thể lưu trữ nó bằng cách gửi một
POST yêu cầu đến điểm cuối /products/{product_id}/archive. Hành động này ẩn sản phẩm nhưng không xóa nó vĩnh viễn.API Lưu trữ Sản phẩm
Xem chi tiết cấu trúc yêu cầu và phản hồi trong tài liệu API Lưu trữ Sản phẩm.
Khôi phục một Sản phẩm
Khôi phục một Sản phẩm
Nếu bạn cần khôi phục một sản phẩm đã được lưu trữ, hãy gửi một
POST yêu cầu đến điểm cuối /products/{product_id}/unarchive. Điều này sẽ kích hoạt lại sản phẩm và làm cho nó có sẵn sử dụng lại.API Khôi phục Sản phẩm
Xem chi tiết cấu trúc yêu cầu và phản hồi trong tài liệu API Khôi phục Sản phẩm.
Thanh toán & thực hiện
Thanh toán & thực hiện
Tạo quy trình thanh toán hoặc đăng ký từ các sản phẩm, và thực hiện tự động qua lợi ích và webhook.
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 hàng - một lần, định kỳ, hoặc theo mức sử dụng.