Thanh toán và số dư

Trong GetMyBot có hai vòng "thanh toán" khác nhau: số dư yêu cầu của nền tảng (cho hoạt động của bot) và nhận thanh toán từ người dùng của bot qua Telegram. Mục Thanh toán (còn gọi là "Nhận thanh toán") quản lý gói cước và số dư.

Bot được tính phí như thế nào

Nền tảng tính công việc bằng yêu cầu: mỗi tin nhắn được bot gửi đi sẽ trừ một yêu cầu khỏi số dư tài khoản. Số dư là bộ đếm số nguyên; nguồn xác thực là nhật ký không thể thay đổi của các lần ghi có và ghi nợ (thưởng khi đăng ký, ghi có gói cước, nạp tiền, chi tiêu).

Gói cước và số dư

Trong mục Thanh toán hiển thị số dư hiện tại và các gói cước có sẵn. Gói cước có tên, giá và số lượng yêu cầu, cũng như giới hạn (ví dụ: số bot tối đa). Nút Chọn kích hoạt gói cước.

  • Số dư — số yêu cầu còn lại hiện tại (cũng hiển thị trên màn hình Tổng quan và Thống kê).
  • Dự báo, ngày trên màn hình Thống kê ước tính số dư đủ dùng bao lâu với mức chi tiêu hiện tại.

Nhật ký ghi có (ledger)

Số dư yêu cầu là bộ đếm số nguyên, nhưng nguồn xác thực của nó là nhật ký thao tác không thể thay đổi (ledger). Mỗi thay đổi số dư được ghi vào đó:

  • Thưởng khi đăng ký — số yêu cầu ban đầu cho tài khoản mới.
  • Ghi có gói cước — yêu cầu được cấp khi kích hoạt gói cước.
  • Nạp tiền — yêu cầu đã mua thêm.
  • Chi tiêu — trừ một yêu cầu cho mỗi tin nhắn bot gửi đi.

Nhật ký chỉ được bổ sung (bản ghi cũ không thay đổi), vì vậy lịch sử chi tiêu và ghi có luôn có thể đối chiếu. Số dư hiện tại là tổng theo nhật ký.

Nạp tiền

Nạp tiền tạo ra thanh toán cho số lượng yêu cầu cần thiết; sau khi nhà cung cấp xác nhận, số dư được ghi có tự động và idempotent (callback lặp lại không tạo ghi có trùng lặp). Nhà cung cấp thanh toán cụ thể phụ thuộc vào cấu hình instance.

Nhận thanh toán từ người dùng (Telegram Payments)

Bot có thể nhận và ghi lại các thanh toán Telegram:

  • Yêu cầu pre_checkout_query được xác nhận tự động.
  • Thanh toán thành công (successful_payment) được ghi lại (số tiền, tiền tệ, định danh giao dịch, payload), rồi có thể kích hoạt phản ứng — ví dụ: cấp quyền truy cập, đặt nhãn "đã thanh toán" và ghi đơn hàng vào bộ sưu tập.

Tổng số thanh toán thành công có thể xem trong Phân tích ("Thanh toán").

Tạo hóa đơn (sendInvoice) và các nút "Nhận thanh toán" / "Thông báo" trong trình tạo nút hiện được đánh dấu là "sắp có": bot ghi lại các thanh toán đến, nhưng trong phiên bản hiện tại không thể khởi tạo hóa đơn từ phản ứng.

Tiếp theo