# Ví token — số dư dùng cho AI Source: https://wiki.tudongsale.com/thanh-toan/tokens Cập nhật: 2026-08-12 > Token bị trừ khi hệ thống gọi AI phân tích bài viết, nhắn khách và chạy thử; mua thêm khi cần · ~4 phút đọc ![Số dư ví token hiện tại, mục "Mua thêm token" và "Lịch sử giao dịch".](https://wiki.tudongsale.com/guide/tokens/tokens-wallet.png) ## Tổng quan Ví token (/tokens) là nơi bạn theo dõi số dư token — loại "tiền" nội bộ dùng để trả cho các lần hệ thống gọi AI thật. Mỗi lần AI Agent phân tích bài viết/bình luận theo chủ đề, nhắn khách hàng tiềm năng (outreach), chạy thử trong Thử nghiệm chủ đề, hoặc nạp kiến thức vào Tri thức huấn luyện (embedding) đều trừ một lượng token tương ứng. Hết token thì các thao tác này sẽ báo lỗi cho tới khi bạn mua thêm. Ví thực chất gồm **hai loại số dư**, cộng lại thành số hiển thị trên thẻ "Số dư hiện tại": - **Hạn mức theo gói** — cấp lại đầu mỗi chu kỳ theo gói đăng ký, dùng không hết sẽ **hết hạn khi sang chu kỳ mới** (use-it-or-lose-it), không dồn qua tháng sau. - **Token đã mua thêm** — mua rời qua mục "Mua thêm token", **không bao giờ hết hạn**, giữ nguyên tới khi dùng hết. Mỗi lần trừ token, hệ thống trừ vào **hạn mức theo gói trước**, hết phần đó mới trừ sang token đã mua thêm. Màn hình chia làm 3 khối theo đúng thứ tự hiển thị: thẻ số dư hiện tại ở trên cùng, mục "Mua thêm token" liệt kê các gói token có thể mua, và bảng "Lịch sử giao dịch" ghi lại từng lần cộng/trừ token kèm số dư sau giao dịch. Luồng mua token dùng chung cơ chế thanh toán VietQR (SePay) với trang Thanh toán: bấm mua một gói token → hệ thống tạo phiên checkout → hiện dialog QR để quét bằng app ngân hàng → hệ thống tự động xác nhận và cộng token vào ví khi tiền về, không cần bấm xác nhận thủ công. ## Hạn mức tính thế nào - Mỗi gói cấp một hạn mức token theo tháng. Mỗi việc AI làm trừ nhiều hay ít tuỳ lượng chữ đọc vào và viết ra, nên số bài đọc được từ cùng một hạn mức thay đổi theo nội dung thật. - Ngoài hạn mức tháng, hệ thống còn giữ một **giới hạn tuần** — chặn không cho dùng dồn cả tháng vào một tuần, để hạn mức còn lại cho các tuần sau trong chu kỳ. - Giới hạn tuần chỉ áp dụng cho **hạn mức theo gói**; token đã mua thêm không tính vào giới hạn tuần và không bị chặn bởi nó. - Gói theo năm vẫn cấp hạn mức **từng tháng** như gói theo tháng, không cấp gộp một lần cho cả năm. ## Các bước ### 1. Xem số dư ví token Thẻ trên cùng của trang hiển thị "Số dư hiện tại" — con số token còn lại, định dạng theo chuẩn số Việt Nam. ### 2. Chọn gói ở mục "Mua thêm token" Danh sách các gói token dạng thẻ, mỗi thẻ hiển thị tên gói, giá tiền và số lượng token tương ứng, kèm nút "Mua ngay". ### 3. Bấm "Mua ngay" để khởi tạo thanh toán Gọi API khởi tạo checkout cho đúng gói đó. Nếu thành công, dialog thanh toán QR mở ra ngay. ### 4. Quét mã VietQR trong dialog thanh toán Quét mã QR bằng app ngân hàng, kèm đồng hồ đếm ngược tới thời điểm phiên thanh toán hết hạn. Hệ thống tự động kiểm tra trạng thái định kỳ — khi tiền về, dialog tự đóng và ví được cộng token ngay. ### 5. Xử lý khi phiên thanh toán hết hạn hoặc bị huỷ Nếu quá thời gian đếm ngược mà chưa thanh toán, hoặc phiên bị huỷ/thất bại, dialog dừng polling và báo trạng thái tương ứng — cần khởi tạo một phiên thanh toán mới. ### 6. Đối chiếu lịch sử giao dịch Bảng "Lịch sử giao dịch" liệt kê từng giao dịch token với 4 cột: Ngày, Loại (Cấp gói/Mua thêm/Sử dụng/Điều chỉnh/Hết hạn), Số lượng, và Số dư sau. Bảng có phân trang, mặc định 10 dòng/trang. ## Câu hỏi thường gặp ## Token bị trừ vào lúc nào? Mỗi lần hệ thống gọi AI thật đều trừ token: phân tích bài viết/bình luận cho chủ đề, AI nhắn khách hàng tiềm năng (outreach), lượt chạy thử trong Thử nghiệm chủ đề, và khi nạp kiến thức vào Tri thức huấn luyện (embedding) — kể cả khi chỉ để thử nghiệm cũng bị trừ như dùng thật. ## Vì sao bị chặn dù ví còn token? Có hai lý do khác nhau: - **Hết hạn mức tháng** — cả hạn mức theo gói lẫn token đã mua thêm đều về 0. Cách xử lý: mua thêm token hoặc nâng gói. - **Chạm giới hạn tuần** — hạn mức theo gói của tuần này đã dùng hết, dù cả tháng vẫn còn dư (phần dư dành cho các tuần sau). Cách xử lý: chờ sang tuần mới hệ thống tự mở lại, hoặc mua thêm token — vì token đã mua thêm không bị giới hạn tuần chặn nên vẫn dùng được ngay. ## Có mấy loại giao dịch trong lịch sử? 5 loại: "Cấp gói" — hạn mức được cấp lại đầu chu kỳ theo gói đăng ký; "Mua thêm" — bạn tự mua thêm token không hết hạn; "Sử dụng" — bị trừ khi AI Agent xử lý; "Điều chỉnh" — hệ thống chỉnh tay số dư (ví dụ hoàn token khi có lỗi); "Hết hạn" — phần hạn mức theo gói chưa dùng hết bị xóa khi chuyển sang chu kỳ mới (token đã mua thêm không bao giờ xuất hiện ở dòng này vì không hết hạn). ## Mua token xong bao lâu thì cộng vào ví? Gần như ngay lập tức — dialog thanh toán tự kiểm tra trạng thái mỗi vài giây, khi ngân hàng báo tiền về hệ thống tự cộng token và đóng dialog, không cần bạn xác nhận thủ công. ## Quét mã QR rồi nhưng dialog không tự đóng thì sao? Kiểm tra lại đồng hồ đếm ngược trong dialog — nếu còn thời gian, hệ thống vẫn đang chờ xác nhận từ ngân hàng. Nếu phiên đã hết hạn, đóng dialog và quay lại mục "Mua thêm token" để tạo phiên thanh toán mới. ## Hết token thì có báo trước không? Trang này chỉ hiển thị số dư hiện tại để bạn tự theo dõi; khi số dư về 0, các thao tác gọi AI sẽ báo lỗi ngay tại lúc thực hiện cho tới khi bạn mua thêm token. [Mở Ví token →](https://app.tudongsale.com/tokens)