Sử dụng và thanh toán API Gateway
Theo dõi yêu cầu, token, chi phí; chọn gói, nạp credit qua VietQR và quản lý hạn mức theo cửa sổ 5 giờ hoặc 24 giờ.
Trên trang này
API Gateway tính phí theo token, trừ vào hạn mức gói thuê bao hoặc số dư credit. Bạn theo dõi mức dùng ở API Gateway › Sử dụng và quản lý gói, credit ở API Gateway › Thanh toán.
Gói thuê bao và credit
Mỗi yêu cầu được tính theo một trong hai chế độ:
- Thuê bao — bạn có gói còn hạn. Chi phí trừ vào ngân sách của cửa sổ sử dụng (5 giờ hoặc 24 giờ).
- Trả theo dùng — không có gói còn hạn nhưng có số dư credit. Chi phí trừ thẳng vào credit, không giới hạn theo cửa sổ.
Giá tính bằng credit, với $1 = 1 credit. Không có gói và cũng hết credit thì yêu cầu bị từ chối với mã 402.
Nạp credit qua VietQR
Mở Credit & nạp tiền
Vào API Gateway › Thanh toán, chọn tab Credit & nạp tiền. Hoặc nhấn Nạp Credits trên trang Tổng quan.
Nhập số tiền
Trong thẻ Nạp credit qua VietQR, nhập Số tiền nạp (10.000 – 5.000.000 VND) hoặc chọn mức nhanh 50K, 100K, 200K, 500K. Trang hiện số credit bạn sẽ nhận theo tỷ giá hiện hành.
Tạo mã QR
Nhấn Tạo mã QR thanh toán. Thẻ Quét mã để thanh toán hiện mã QR, Ngân hàng, Số tài khoản, Chủ tài khoản, Số tiền và Nội dung CK.
Chuyển khoản
Quét mã bằng ứng dụng ngân hàng. Giữ nguyên nội dung chuyển khoản. Khi hệ thống nhận tiền, thẻ Nạp tiền thành công hiện số dư mới.
- 1Chọn tab Credit & nạp tiền
- 2Nhập số tiền hoặc chọn mức nạp nhanh
- 3Nhấn Tạo mã QR thanh toán
- 4Sao chép Nội dung CK nếu chuyển khoản thủ công
Hệ thống dựa vào nội dung CK để tự cộng credit. Mã QR có thời hạn đếm ngược. Nếu mã hết hạn sau khi bạn đã chuyển tiền, credit vẫn được cộng khi hệ thống nhận được giao dịch.
Thẻ Số dư hiện Credit khả dụng và các đợt Credit có thời hạn (credit thưởng). Credit có thời hạn được trừ trước số dư chính và không dùng để mua gói.
Chọn, gia hạn và đổi gói
Ở trang Thanh toán, các gói chia theo nhóm Bắt đầu và Chuyên nghiệp. Mỗi thẻ gói hiện giá bằng credit, tính năng và Cửa sổ ngân sách để chọn 5 giờ hoặc 24 giờ.
- Nhấn Chọn … để mua gói. Giá trừ từ số dư credit khi kích hoạt.
- Nhấn Gia hạn để cộng thêm một chu kỳ.
- Nhấn Đổi gói rồi Chuyển sang …. Thời gian còn lại của gói cũ được hoàn thành credit, gói mới bắt đầu chu kỳ ngay.
Hộp thoại xác nhận hiện Trừ và Số dư sau giao dịch. Nếu thiếu credit, thẻ gói hiện Cần thêm … để chọn … và nút Nạp thêm credit.
Hạn mức gói và cửa sổ sử dụng
Thẻ Hạn mức gói trên trang Tổng quan cho biết Đã dùng, Còn lại, Ngân sách và Đặt lại sau, cùng giới hạn RPM và số Khóa API tối đa.
- Cửa sổ sử dụng — mỗi chu kỳ được đổi một lần giữa 5h và 24h. Đổi sang cửa sổ dài hơn có hiệu lực ngay; đổi sang cửa sổ ngắn hơn áp dụng khi cửa sổ hiện tại kết thúc.
- Đặt lại hạn mức — làm mới ngân sách 24 giờ ngay lập tức, đổi lại 1 ngày của gói. Số lần mỗi ngày có giới hạn.
- Chuyển sang dùng credit khi hết hạn mức — bật để yêu cầu trừ vào số dư credit thay vì bị chặn khi hết ngân sách cửa sổ.
Theo dõi mức sử dụng
Trang Sử dụng (/api-gateway/dashboard/usage) có ba tab:
| Tab | Nội dung |
|---|---|
| Tổng quan | Tổng yêu cầu, Token đầu vào, Token đầu ra, Chi phí ước tính; biểu đồ theo ngày (Token hoặc Chi phí) trong 24h, 7D, 30D, 60D |
| Phân tích | Tổng hợp Theo model hợp nhất và Theo khóa API; nhấn một dòng để lọc |
| Lịch sử | Từng yêu cầu với model, token, Chi phí, Độ trễ, Thời điểm, Trạng thái; lọc theo khoảng thời gian, model và Thanh toán (Free / Tính phí) |
Số ở tab Tổng quan là ước tính, không phải hoá đơn. Các khoản trừ thực tế nằm ở Thanh toán › Lịch sử giao dịch.
Lịch sử giao dịch
Tab Lịch sử giao dịch liệt kê Nạp tiền, Kích hoạt gói, Gia hạn gói, Đổi gói, Hoàn tiền gói và Thưởng. Lọc theo Loại giao dịch, Từ ngày, Đến ngày; nhấn một dòng để xem Chi tiết giao dịch.