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.1
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ả.
2
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.
3
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.
4
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ì 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). Bạn có thể trình bày nhiều sản phẩm cạnh nhau trong cùng một thanh toán và cho phép khách hàng chuyển đổi giữa chúng.Điều này giữ cho các API có thể dự đoán và đơn giản hóa báo cáo. Mỗi sản phẩm có một mô hình giá duy nhất.
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 qua API. API cung cấp quyền kiểm soát hoàn toàn đối với 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 và quyền lợi bất cứ lúc nào (mô hình giá là không thay đổi).
- Lưu trữ: Ẩn một sản phẩm khỏi các giao dịch mới mà không làm gián đoạn khách hàng hiện tại. Bạn có thể bỏ lưu trữ sau này.
Quản lý API
Các hướng dẫn sau 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 một sản phẩm
Tạo một 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 một 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 /products điểm cuối với các chi tiết như tên, mô tả, giá, loại tiền tệ và liệu nó có phải là một 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).Tạo sản phẩm 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.
Cập nhật một sản phẩm
Cập nhật mộ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 /products/{product_id} điểm cuối. 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ó.Cập nhật sản phẩm 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.
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 sử dụng một
GET yêu cầu đến /products điểm cuối. Điều này cho phép bạn truy xuất chi tiết sản phẩm, bao gồm các sản phẩm đang hoạt động và đã lưu trữ.Truy xuất sản phẩm 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.
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ó vào AWS S3 sử dụng một URL đã ký trước được cung cấp bởi API. Đầu tiên, yêu cầu một URL tải lên hình ảnh từ
/products/{product_id}/images điểm cuối, 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ý trước từ API, 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 vào AWS S3 để tải lên hình ảnh.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.Tải lên hình ảnh sản phẩm 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 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 sử dụng một
POST yêu cầu đến /products/{product_id}/archive điểm cuối. Hành động này ẩn sản phẩm nhưng không xóa nó vĩnh viễn.Lưu trữ sản phẩm 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.
Bỏ lưu trữ một sản phẩm
Bỏ lưu trữ một sản phẩm
Nếu bạn cần khôi phục một sản phẩm đã lưu trữ, hãy gửi một
POST yêu cầu đến /products/{product_id}/unarchive điểm cuối. Đ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 một lần nữa.Bỏ lưu trữ sản phẩm API
Xem cấu trúc yêu cầu và phản hồi chi tiết trong tài liệu API Bỏ lưu trữ 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 quyền lợi và webhooks.
Thực tiễn tốt nhất
- Bắt đầu với sự rõ ràng: Tách biệt các sản phẩm cho mỗi tùy chọn giá (Hàng tháng so với Hàng năm)
- Sử dụng thử nghiệm một cách hợp lý: Kết hợp thử nghiệm với việc hướng dẫn để thúc đẩy kích hoạt
- Tự động thực hiện: Sử dụng quyền lợi và webhooks để giao hàng ngay lập tức
- Gán với siêu dữ liệu: Lưu trữ ID hệ thống của bạn để đối chiếu
Bạn đã sẵn sàng để tạo sản phẩm và bắt đầu bán - một lần, định kỳ, hoặc theo mức sử dụng.