> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Thanh toán dựa trên mức sử dụng
> Tính phí khách hàng dựa trên những gì họ thực sự sử dụng với việc đo lường linh hoạt và thanh toán tự động.
Thanh toán dựa trên mức sử dụng cho phép bạn tính phí khách hàng cho những gì họ thực sự sử dụng—các cuộc gọi API, lưu trữ, token AI, hoặc bất kỳ chỉ số nào bạn định nghĩa. Khách hàng trả tiền cho mức tiêu thụ, không phải phí cố định.
**Hoàn hảo cho**: APIs, dịch vụ AI, nền tảng cơ sở hạ tầng, và bất kỳ sản phẩm nào mà giá trị tăng theo mức sử dụng.
## Cách hoạt động
Ứng dụng của bạn gửi sự kiện khi có hành động phải tính phí.
```javascript theme={null}
{
"event_id": "evt_123",
"customer_id": "cus_abc",
"event_name": "api.call",
"metadata": { "endpoint": "/v1/users" }
}
```
Meter tổng hợp sự kiện thành các đơn vị tính phí bằng cách sử dụng các phép tổng hợp Count, Sum, Max hoặc Last.
Đặt giá theo mỗi đơn vị và ngưỡng dùng miễn phí. Khách hàng được tính phí tự động mỗi chu kỳ.
## Khái niệm cốt lõi
### Sự kiện
Events đại diện cho các hành động sử dụng trong ứng dụng của bạn. Mỗi sự kiện bao gồm:
* **Tên sự kiện**: Loại sử dụng (ví dụ: `api.call`)
* **Customer ID**: Người đã sử dụng
* **Metadata**: Các thuộc tính bổ sung để tổng hợp
### Đồng hồ
Các đồng hồ tổng hợp sự kiện thành các số lượng tính phí:
* **Count**: Tổng số sự kiện (các cuộc gọi API)
* **Sum**: Cộng các giá trị (tổng số byte)
* **Max**: Giá trị cao nhất (người dùng cao điểm)
* **Last**: Giá trị gần nhất
### Sản phẩm với giá dựa trên mức sử dụng
Đặt giá theo đơn vị và ngưỡng miễn phí tùy chọn:
**Ví dụ**: 2,500 cuộc gọi - 1,000 miễn phí = 1,500 × $0.02 = $30.00
### Khấu Trừ Dựa trên Tín Dụng
Thay vì tính phí theo đơn vị bằng đô la, bạn có thể cấu hình các đồng hồ đo để trừ vào [số dư tín dụng](/features/credit-based-billing) của khách hàng. Tín dụng được làm mới mỗi chu kỳ thanh toán và áp dụng trước bất kỳ phí vượt mức nào.
## Bắt đầu nhanh
Trong bảng điều khiển của bạn: **Meters** → **Create Meter**
1. Đặt tên sự kiện (ví dụ: `api.call`)
2. Chọn phép tổng hợp (Count, Sum, Max, Last)
3. Thêm các bộ lọc tùy chọn
Liên kết meter với một sản phẩm có định giá:
1. Chọn **Usage-Based Billing**
2. Chọn meter của bạn
3. Đặt giá trên mỗi đơn vị và ngưỡng dùng miễn phí
```javascript theme={null}
await fetch('https://test.dodopayments.com/events/ingest', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.DODO_PAYMENTS_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
events: [{
event_id: "unique_event_id",
customer_id: "cus_abc123",
event_name: "api.call",
metadata: { endpoint: "/v1/users" }
}]
})
});
```
Kiểm tra bảng điều khiển của meter để xem các sự kiện và tổng hợp sử dụng. Khách hàng được tính phí tự động mỗi chu kỳ.
## Trường hợp sử dụng
Theo dõi cuộc gọi API, giờ tính toán, băng thông, dung lượng lưu trữ. Ví dụ: \$0.001 cho mỗi cuộc gọi sau 10.000 lượt miễn phí.
Theo dõi token, số lần tạo, thời gian xử lý. Ví dụ: \$0.04 cho hình ảnh tiêu chuẩn, \$0.08 cho HD.
Tính phí theo dữ liệu xử lý, truy vấn thực hiện, bản ghi phân tích. Ví dụ: \$5 cho mỗi GB sau 10 GB miễn phí.
Đếm tin nhắn, phút, dữ liệu truyền. Ví dụ: \$0.01 cho mỗi tin nhắn SMS gửi đi.
## Các bước tiếp theo
Tìm hiểu cách cấu trúc và gửi các sự kiện sử dụng từ ứng dụng của bạn.
Thành thạo cấu hình meter, các loại tổng hợp và lọc sự kiện.
Xây dựng một trình tạo ảnh AI đầy đủ với giá theo mức sử dụng từ đầu.
Hướng dẫn toàn diện về triển khai tính phí theo mức sử dụng trong ứng dụng của bạn.