Chuyển đổi các sự kiện sử dụng thô thành các số lượng có thể tính phí với việc tổng hợp và lọc.
Meter chuyển đổi các sự kiện thô thành số lượng có thể tính phí. Chúng lọc sự kiện và áp dụng các hàm tổng hợp (Count, Sum, Max, Last) để tính mức sử dụng cho từng khách hàng.
Nhãn đơn vị dùng cho hóa đơn và báo cáo. Ví dụ: calls, tokens, GB, hours.
3
Filtering (Optional)
Thêm điều kiện để lọc các sự kiện được tính:
Logic AND: Tất cả các điều kiện phải khớp
Logic OR: Bất kỳ điều kiện nào cũng có thể khớp
Các toán tử so sánh hiện có: bằng, khác, lớn hơn, lớn hơn hoặc bằng, nhỏ hơn, nhỏ hơn hoặc bằng, chứa, không chứa.Bật tính năng lọc, chọn logic, sau đó thêm điều kiện với khóa thuộc tính, toán tử so sánh và giá trị.
Theo mặc định, meter tính phí khách hàng theo từng đơn vị bằng đô la (hoặc loại tiền tệ bạn đã cấu hình). Thay vào đó, bạn có thể cấu hình meter để trừ vào số dư credit của khách hàng, nhờ đó mức sử dụng sẽ tiêu thụ credit thay vì tạo ra khoản phí bằng tiền.
Tính năng khấu trừ dựa trên credit yêu cầu một Credit Entitlement được gắn với cùng một product. Trước tiên, hãy tạo credit entitlement, sau đó liên kết entitlement đó với meter.
Trước tiên, hãy tạo credit entitlement trong Products → Credits. Xác định đơn vị (ví dụ: “API Calls”, “Tokens”), độ chính xác và các cài đặt vòng đời (hết hạn, chuyển tiếp, overage).Xem Hướng dẫn Thanh toán theo tín chỉ để biết hướng dẫn chi tiết.
2
Create or Edit a Usage-Based Product
Vào sản phẩm tính phí theo mức sử dụng và mở phần cấu hình Meter.
3
Add a Meter
Nhấp nút + để đính kèm một đồng hồ. Cấu hình tên sự kiện, kiểu tổng hợp và đơn vị đo như thường lệ.
4
Enable 'Bill Usage in Credits'
Bật Bill usage in Credits trong cấu hình meter để hiển thị các cài đặt credit:
Toggle 'Bill usage in Credits' to switch from currency-based to credit-based deduction.
Số đơn vị sử dụng cần thiết để khấu trừ 1 tín chỉ. Ví dụ:
1 = mỗi sự kiện đồng hồ khấu trừ 1 tín chỉ
100 = 100 sự kiện đồng hồ khấu trừ 1 tín chỉ
1000 = 1.000 cuộc gọi API tiêu thụ 1 tín chỉ
5
Free Threshold and Credits
Free Threshold áp dụng cho các meter được tính phí bằng tiền, không áp dụng cho các meter được tính phí bằng credit. Khi meter tính phí bằng credit, mọi đơn vị đều được tính vào khoản khấu trừ credit.Ví dụ: Với meter-units-per-credit là 1, khách hàng thực hiện 2,500 lệnh gọi API sẽ bị khấu trừ 2,500 credit.
Sau khi được cấu hình, quy trình khấu trừ chạy tự động:
Sự kiện được gửi đến — Ứng dụng của bạn gửi các sự kiện sử dụng thông qua Event Ingestion API.
Meter tổng hợp — Các sự kiện được tổng hợp theo cấu hình meter của bạn (Count, Sum, Max, Last).
Background worker xử lý — Mỗi phút, một worker lấy các sự kiện mới kể từ checkpoint gần nhất.
Credit được khấu trừ — Mức sử dụng đã tổng hợp được chuyển đổi thành credit bằng rate meter_units_per_credit và được khấu trừ theo thứ tự FIFO (các khoản cấp credit hết hạn sớm nhất được sử dụng trước).
Overage được theo dõi — Nếu số dư chạm mức 0, mức sử dụng tiếp theo sẽ được ghi nhận là overage và được xử lý theo hành vi đã cấu hình (được miễn khi reset, tính phí ở hóa đơn tiếp theo hoặc chuyển tiếp dưới dạng thâm hụt). Dodo Payments không chặn mức sử dụng khi số dư cạn kiệt. Để dừng quyền truy cập khi số dư bằng 0, hãy kiểm tra số dư trong ứng dụng của bạn.
Khấu trừ credit chạy không đồng bộ (khoảng mỗi 1 phút). Có thể có một khoảng trễ ngắn giữa lúc tiếp nhận sự kiện và lúc khấu trừ vào số dư. Hãy thiết kế ứng dụng để xử lý độ trễ này và không dựa vào việc kiểm tra số dư theo thời gian thực để kiểm soát quyền truy cập cho từng request.
Bạn có thể liên kết nhiều meter trên cùng một product với cùng một credit entitlement. Tất cả meter đều trừ từ một số dư dùng chung.Ví dụ: Một nền tảng AI có hai meter:
text.generation — 1 credit cho mỗi 1.000 token
image.generation — 10 credit cho mỗi hình ảnh
Cả hai khấu trừ từ cùng pool “AI Credits”. Khách hàng thấy một số dư thống nhất trong cổng của họ.
Sử dụng các tỷ lệ meter_units_per_credit khác nhau giữa các đồng hồ để biểu đạt chi phí tương đối. Các hoạt động tốn kém (tạo hình ảnh) tiêu thụ ít đơn vị đồng hồ trên mỗi tín chỉ hơn các hoạt động rẻ hơn (hoàn thành văn bản).
List Customer Ledger
Xem toàn bộ lịch sử khấu trừ tín chỉ cho một khách hàng.
Get Customer Balance
Kiểm tra số dư tín chỉ hiện tại của khách hàng qua API.
