Nạp tiền & Thanh toán
Nạp tiền & Thanh toán
Dưới đây là thông tin chi tiết về cơ chế hoạt động của số dư, cách nạp tiền và cách theo dõi chi tiêu.
Cơ chế hoạt động của Số dư (Credits)
Tài khoản người dùng hoạt động theo hình thức trả trước với số dư được tính bằng Việt Nam đồng (VND). Người dùng nạp tiền trước vào tài khoản, và mỗi request thành công sẽ trừ dần vào số dư dựa trên chi phí thực tế của request đó.
Một vài điểm cần lưu ý:
- Số dư luôn hiển thị bằng VND. Chi phí sử dụng model được tính và khấu trừ trực tiếp bằng VND tính theo tỉ giá realtime của Vietcombank, giúp người dùng dễ dàng kiểm soát ngân sách.
- Người dùng chỉ bị tính phí cho các request thành công (xem mục Cơ chế tính phí).
- Người dùng có thể nạp tiền bất cứ lúc nào, không cần đăng ký gói thuê bao và không bị áp đặt mức chi tiêu tối thiểu hàng tháng.
Nạp tiền vào tài khoản (Top-up)
Người dùng có thể nạp tiền trực tiếp qua hình thức chuyển khoản ngân hàng bằng VietQR, không cần đến thẻ thanh toán quốc tế (Visa/Mastercard).
Các bước nạp tiền:
- Truy cập vào mục Tài khoản => Số dư => Nhấn vào nút “Nạp tiền”.
- Nhập số tiền muốn nạp (tính bằng VND) => Nhấn vào nút “Tạo mã QR”.
- Kiểm tra lại bảng tóm tắt thanh toán. Phí dịch vụ và thuế GTGT (VAT) sẽ được cộng thêm vào số tiền đã chọn — cả hai khoản này đều được liệt kê chi tiết để người dùng thấy rõ tổng số tiền phải trả trước khi xác nhận.
- Bấm xác nhận để hệ thống tạo một mã VietQR chứa thông tin tài khoản đích kèm nội dung chuyển khoản (payment reference) duy nhất.
- Mở ứng dụng ngân hàng, quét mã QR (hoặc nhập thủ công thông tin). Hãy giữ nguyên nội dung chuyển khoản mặc định— đây là cơ sở để hệ thống tự động đối soát và cộng tiền vào đúng tài khoản.
Sau khi giao dịch được ngân hàng xác nhận, số tiền nạp sẽ tự động cộng vào tài khoản của người dùng, thường chỉ mất vài phút.
Số tiền thanh toán thực tế và Số dư nhận được
Số tiền nhập ban đầu là số tiền thực nhận trong tài khoản. Phí dịch vụ và VAT sẽ được tính thêm vào số tiền đó:
Tỷ lệ phần trăm chính xác của phí dịch vụ và VAT, cùng tất cả các khoản mục trên luôn được hiển thị rõ ràng ở bảng tóm tắt trước khi xác nhận.
Cách tính Phí dịch vụ và VAT
Hai khoản phí phát sinh thêm ngoài số tiền nạp là phí dịch vụ và VAT. Chúng được tính toán theo thứ tự sau:
- Phí dịch vụ = Số tiền nạp × Tỷ lệ % phí (Mặc định: 5%).
- Thuế VAT được áp dụng cho tổng của [Số tiền nạp + Phí dịch vụ], chứ không chỉ tính riêng trên số tiền nạp (Mặc định: 10%, theo mức chuẩn tại Việt Nam).
- Tổng tiền thanh toán là tổng của cả ba mục trên.
Công thức tính toán:
Ví dụ thực tế — Nạp 100.000 VND với mức phí dịch vụ 5% và VAT 10%:
Trong ví dụ này, người dùng chuyển khoản 115.500 VND và sẽ nhận được đúng 100.000 VND vào số dư tài khoản.
Tỷ lệ phần trăm phí và VAT có thể cấu hình và thay đổi tùy thời điểm. Các mức mặc định trên chỉ mang tính chất minh họa — bảng tóm tắt thanh toán của người dùng sẽ luôn phản ánh đúng tỷ lệ hiện tại và số tiền chính xác trước khi bấm xác nhận.
Trường hợp giao dịch không thành công
- Sai hoặc thiếu nội dung chuyển khoản (Reference): Các giao dịch không khớp nội dung sẽ không thể cộng tiền tự động. Vui lòng liên hệ với bộ phận hỗ trợ (support) kèm biên lai chuyển tiền để chúng tôi đối soát thủ công.
- Yêu cầu nạp tiền hết hạn: Nếu yêu cầu nạp tiền trên hệ thống bị hết hạn trước khi tiền gửi đến, số dư sẽ không được cộng tự động. Hãy tạo một lệnh nạp tiền mới và chuyển khoản theo mã nội dung mới vừa tạo.
Cơ chế tính phí
Khi thực hiện một request, chi phí sẽ được khấu trừ từ số dư ngay sau khi request đó hoàn thành thành công.
- Tính phí trên mỗi request thành công: Chi phí phản ánh đúng mức độ sử dụng thực tế (ví dụ: số lượng token đầu vào và đầu ra) theo biểu giá của model đó.
- Không tính phí các request lỗi: Nếu request bị lỗi hoàn toàn hoặc không thể hoàn thành, người dùng sẽ không phải trả tiền cho request đó.
- Đối với phản hồi dạng Streaming: Chi phí được tính và quyết toán một lần duy nhất sau khi quá trình stream kết thúc, dựa trên lượng dữ liệu tiêu thụ thực tế.
- Minh bạch lịch sử: Mỗi lượt trừ phí sẽ hiển thị như một dòng lịch sử trong phần biến động số dư (transaction history), giúp người dùng luôn theo dõi được chi phí của từng request.
Số dư khả dụng và Request bị từ chối
Để tránh tình trạng chi tiêu vượt quá số dư, hệ thống sẽ kiểm tra tài khoản của người dùng trước khi chạy request.
- Trước khi request được gửi đi, hệ thống sẽ tạm giữ (set aside) một khoản nhỏ trong số dư để ước tính chi phí. Nếu số dư hiện tại không đủ bù đắp khoản ước tính này, request sẽ bị từ chối ngay lập tức và trả về lỗi 402 (insufficient credit) thay vì tiếp tục chạy.
- Sau khi request hoàn thành, chi phí thực tế sẽ được quyết toán và phần tiền tạm giữ còn thừa (nếu có) sẽ được hoàn lại vào số dư của người dùng.
- Đối với các phản hồi streaming dài, số dư có thể bị âm nhẹ nếu phản hồi kéo dài hơn dự kiến — mức âm này được giới hạn và rất nhỏ. Khi số dư không còn đủ để duy trì một request mới, các request tiếp theo sẽ bị từ chối cho đến khi nạp thêm tiền.
Kinh nghiệm thực tế: Hãy luôn duy trì một khoản dư nhỏ trong tài khoản để tránh việc request bị gián đoạn giữa chừng.
Xem số dư và lịch sử giao dịch
Truy cập Billing (Thanh toán) → Balance & transactions (Số dư & Giao dịch) để xem:
- Số dư hiện tại tính bằng VND.
- Toàn bộ lịch sử giao dịch — bao gồm các lượt nạp tiền, chi phí sử dụng, hoàn tiền và điều chỉnh — mỗi dòng đều hiển thị rõ ngày tháng, loại giao dịch, số tiền, số dư sau giao dịch và mã tham chiếu.
Danh sách lịch sử được phân trang và hiển thị các hoạt động mới nhất lên trên đầu.
Theo dõi lưu lượng sử dụng và mức chi tiêu
Giao diện hiển thị Sử dụng (Usage) giúp người dùng nắm được dòng tiền của mình đang tiêu tốn vào đâu theo thời gian.
- Chọn khoảng thời gian: Hôm nay, 7 ngày qua, 30 ngày qua hoặc một khoảng thời gian tùy chỉnh.
- Xem tổng chi phí và lượng token đã tiêu thụ trong khoảng thời gian đó.
- Phân tích chi tiết theo từng API key và từng model để biết chính xác key nào hoặc model nào đang tiêu tốn nhiều chi phí nhất.
Đây là cách nhanh nhất để phát hiện ra các nguồn hoặc ứng dụng tích hợp đang gây tốn kém.
Cảnh báo sắp hết tiền và Hết tiền tài khoản
Để tránh tình trạng các request bị lỗi đột ngột, hệ thống sẽ đưa ra cảnh báo khi số dư của người dùng xuống thấp.
- Sắp hết tiền (Low balance): Khi số dư giảm xuống dưới ngưỡng thiết lập, người dùng sẽ nhận được một email thông báo và một biểu ngữ (banner) hiển thị trên trang quản lý, cả hai đều kèm đường dẫn trực tiếp để nạp tiền nhanh.
- Hết tiền (Out of credit): Nếu một request bị từ chối vì số dư không đủ trang trải, hệ thống sẽ gửi một cảnh báo hết tiền riêng biệt.
🛡️ Tiêu chí không làm phiền: Các cảnh báo này hoàn toàn không gây phiền toái (spam) — người dùng sẽ chỉ nhận tối đa một thông báo cho mỗi đợt số dư xuống thấp, và hệ thống sẽ kích hoạt lại tính năng này sau khi nạp tiền thành công.
Người dùng có thể tự điều chỉnh ngưỡng cảnh báo sắp hết tiền trong phần cài đặt thanh toán; nếu không thiết lập, hệ thống sẽ tự động áp dụng một mức mặc định hợp lý.
Hoàn tiền và điều chỉnh số dư
Trong một vài trường hợp, Trạm AI có thể điều chỉnh số dư của người dùng để hoàn tiền hoặc khắc phục sai sót kỹ thuật.
- Thay đổi sẽ xuất hiện trong lịch sử giao dịch dưới dạng điều chỉnh (adjustment) hoặc hoàn tiền (refund), kèm lý do cụ thể và tham chiếu đến lần nạp tiền hoặc khoản phí gốc.
- Số tiền hoàn và các khoản điều chỉnh sẽ được cộng/trừ vào số dư tài khoản của người dùng ngay lập tức.
Nếu người dùng cho rằng tài khoản của mình bị tính phí sai, vui lòng liên hệ với Trạm AI kèm theo mã tham chiếu giao dịch tương ứng để được hỗ trợ kiểm tra và xử lý nhanh nhất.