Cơ sở kiến thức GetMyBot

Thanh toán và số dư

Nhận tiền từ khách và cấp quyền truy cập sau khi thanh toán. Kết nối cổng thanh toán, trạng thái, hoàn tiền và thanh toán phí nền tảng riêng.

Trên trang này

Để bán hàng qua bot, hãy kết nối tài khoản của bạn ở một dịch vụ thanh toán, gọi là cổng thanh toán. Bot tạo hóa đơn, khách thanh toán, rồi phản ứng khi thanh toán thành công có thể cấp quyền truy cập hoặc xác nhận đơn hàng.

Trong tài khoản GetMyBot có hai loại thanh toán:

  • Bot thu tiền từ khách: bot lập hóa đơn cho người đăng ký, tiền chuyển trực tiếp cho bạn. Phần lớn bài này nói về việc ấy.
  • Số dư lượt yêu cầu của nền tảng: khoản bạn trả để dùng GetMyBot. Phần cuối bài giải thích riêng.

Cổng thanh toán là gì

Ở đây, cổng thanh toán là tài khoản của bạn tại dịch vụ thanh toán được kết nối với bot. Bạn lấy thông tin kết nối trong tài khoản của nhà cung cấp, nhập vào GetMyBot; bot dùng khóa của chính bạn để lập hóa đơn.

Tiền vào tài khoản người bán của bạn ở dịch vụ thanh toán, tức tài khoản merchant. GetMyBot không nhận hoặc giữ khoản tiền này, cũng không thu phần trăm doanh số. Nền tảng gửi yêu cầu tạo hóa đơn tới dịch vụ, rồi nhận thông báo thanh toán để chạy phản ứng.

Vì vậy:

  • hợp đồng, phí, rút tiền, xét duyệt và giới hạn là quan hệ giữa bạn với dịch vụ thanh toán;
  • khóa bí mật được lưu ở dạng mã hóa và không hiện lại. Khi mở thiết lập lần sau, ô bí mật để trống; để trống nghĩa là giữ khóa cũ;
  • hoàn tiền cũng là thao tác của bạn: nền tảng chỉ gọi API nhà cung cấp bằng khóa của bạn.

Một bot có thể có nhiều cổng, chẳng hạn một cổng cho RUB và một cổng cho ngoại tệ. Bạn có thể chọn một cổng làm cổng mặc định cho hóa đơn không chỉ định cổng.

Khả năng thu tiền phụ thuộc gói cước. Nếu gói hiện tại không hỗ trợ, màn hình Cổng thanh toán sẽ giải thích và hành động Lập hóa đơn sẽ không tạo hóa đơn.

Kết nối cổng thanh toán

  1. Mở Cổng thanh toán. Trong nhật ký thanh toán có nút Cổng thanh toán ở góc trên bên phải.
  2. Bấm Kết nối cổng và chọn nhà cung cấp. Biểu mẫu sẽ đổi theo nhà cung cấp, vì mỗi hệ thống yêu cầu thông tin khác nhau.
  3. Điền tên cổng và thông tin kết nối. Chỉ bạn thấy tên này, dùng để phân biệt các cổng trong danh sách.
  4. Bật Cổng mặc định nếu bot chủ yếu lập hóa đơn qua cổng ấy.
  5. Lưu. Thẻ cổng sẽ hiện Callback URL, địa chỉ nhà cung cấp gửi thông báo thanh toán.
  6. Bấm Sao chép và dán địa chỉ ấy vào tài khoản nhà cung cấp ở ô nhận thông báo. Tên ô có thể là webhook, Result URL, notification URL.
  7. Bấm Kiểm tra kết nối. Hệ thống kiểm tra thông tin đã điền và nhà cung cấp có chấp nhận không. Thông báo «Kết nối hoạt động» nghĩa là bạn có thể lập hóa đơn.

Phải đặt Callback URL ở phía nhà cung cấp. Nếu thiếu, họ có thể thu tiền nhưng GetMyBot không biết: hóa đơn vẫn ở «Chờ thanh toán», phản ứng sau thanh toán không chạy.

Công tắc trên thẻ cổng cho phép tạm tắt mà không xóa thông tin kết nối. Xóa cổng không xóa các khoản thanh toán của cổng ấy khỏi nhật ký.

Các nhà cung cấp

Dưới đây là thông tin cần lấy từ từng tài khoản nhà cung cấp. Biểu mẫu kết nối sẽ hiển thị chính xác các trường theo mô tả của nhà cung cấp.

Trường Hệ thống thuế xuất hiện ở vài cổng, dùng cho biên lai theo luật Nga 54-FZ. Các lựa chọn: OSN, USN thu nhập, USN thu nhập trừ chi phí, ENVD, ESKHN, bằng sáng chế thuế.

MIXPLAT

  • ID dự án: tài khoản MIXPLAT, mục «Dự án».
  • Khóa API: dự án, «Thiết lập API». Đây là ô bí mật.
  • Phương thức thanh toán: thẻ, thanh toán di động, ví hoặc ngân hàng. Mặc định là thẻ.
  • Chế độ thử nghiệm: dùng để thử kịch bản mà không thu tiền thật.

Tiền tệ: RUB, EUR, BYN, KZT, UAH. Hỗ trợ biên lai, hoàn toàn bộ và hoàn một phần.

YooKassa

  • ID cửa hàng: tài khoản YooKassa, «Thiết lập → Cửa hàng».
  • Khóa bí mật: «Thiết lập → API». Ô bí mật.

Tiền tệ: RUB. Hỗ trợ biên lai, hoàn toàn bộ và một phần.

Telegram Payments

Cổng này hoạt động khác các cổng còn lại. Hóa đơn đến người đăng ký dưới dạng hóa đơn tích hợp ngay trong cuộc trò chuyện Telegram, không phải đường dẫn. Telegram xác nhận thanh toán qua cập nhật thông thường của bot, không gọi Callback URL. Vì vậy không cần đặt địa chỉ thông báo ở nhà cung cấp, và biến {payment:url} rỗng.

  • Token nhà cung cấp thanh toán: trong BotFather, vào /mybots → bot của bạn → Payments → kết nối nhà cung cấp như YooKassa hoặc Sberbank, rồi sao chép token được cấp. Không cần token nếu bot chỉ nhận Telegram Stars.
  • Tiền tệ mặc định: RUB, USD, EUR hoặc XTR (Telegram Stars), áp dụng khi hóa đơn không chỉ định tiền tệ.

GetMyBot không thực hiện hoàn tiền cho cổng này. Với thanh toán thông thường, bạn hoàn trong tài khoản nhà cung cấp đã kết nối. Trình dựng không hiện các mục biên lai cho cổng này: nhà cung cấp kết nối với bot lập biên lai.

Robokassa

  • Mã cửa hàng (MerchantLogin): tài khoản Robokassa, phần thiết lập cửa hàng.
  • Password1 và Password2 là hai mật khẩu khác nhau: mật khẩu đầu tạo đường dẫn thanh toán, mật khẩu sau xác minh thông báo. Đặt đúng mỗi mật khẩu vào đúng ô.
  • Bộ mật khẩu thử nghiệm riêng nếu bật chế độ thử nghiệm.
  • Hệ thống thuế và công tắc Chế độ thử nghiệm.

Tiền tệ: RUB. Hỗ trợ biên lai. Việc hoàn tiền thực hiện trong tài khoản Robokassa, không qua GetMyBot.

Prodamus

  • Tên miền phụ của biểu mẫu thanh toán: ví dụ my-shop nếu biểu mẫu ở my-shop.payform.ru.
  • Khóa bí mật của biểu mẫu.

Tiền tệ: RUB. Hỗ trợ biên lai; không thể hoàn tiền từ GetMyBot.

CloudPayments

  • Public ID: tài khoản CloudPayments, «Thiết lập → API».
  • API secret ở cùng mục. Ô bí mật.
  • Hệ thống thuế.

Tiền tệ: RUB, USD, EUR. Hỗ trợ biên lai, hoàn toàn bộ và một phần.

T-Kassa

  • TerminalKey: tài khoản T-Kassa, mục «Thiết bị đầu cuối».
  • Mật khẩu thiết bị đầu cuối. Ô bí mật.
  • Hệ thống thuế.

Tiền tệ: RUB. Hỗ trợ biên lai, hoàn toàn bộ và một phần.

Stripe

  • Khóa bí mật (Secret key): Stripe Dashboard, «Developers → API keys». Ô bí mật.
  • Bí mật webhook (Signing secret): Stripe Dashboard, «Developers → Webhooks», endpoint tương ứng. Ô bí mật.

Khách thanh toán trên trang Stripe Checkout. Khi nhận thông báo, GetMyBot kiểm tra chữ ký và thời điểm gửi. Thông báo cũ hơn năm phút bị từ chối để không thể phát lại.

Với tiền tệ không có phần lẻ, như JPY và KRW, số tiền hóa đơn phải là số nguyên. Hóa đơn 199.90 bằng yên sẽ không được tạo.

Tiền tệ: USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY, HKD, SGD, SEK, NOK, DKK, PLN, CZK, KRW, INR, BRL, MXN, ZAR, TRY, AED, ILS, NZD, THB, IDR, PHP, VND, BHD, KWD. Hỗ trợ hoàn toàn bộ và một phần. Cổng này không lập biên lai theo luật Nga 54-FZ, nên không hiện mục biên lai.

Lava.top

  • ID cửa hàng (Shop ID): tài khoản Lava.top, mục «Cửa hàng».
  • Khóa API: mục «Khóa API». Ô bí mật.
  • Bí mật webhook: mục «Webhook», dùng ký thông báo thanh toán. Ô bí mật.

Tiền tệ: USD, EUR, GBP. GetMyBot không hỗ trợ biên lai hoặc hoàn tiền cho cổng này: bạn hoàn trong tài khoản Lava.top.

Cổng này cũng không hỗ trợ hỏi lại trạng thái. Nếu thông báo thất lạc, hóa đơn sẽ không tự chuyển thành đã thanh toán. Hãy kiểm tra trong Lava.top rồi liên hệ hỗ trợ để đối soát thủ công.

CryptoCloud

  • ID cửa hàng (Shop ID): tài khoản CryptoCloud, mục «Cửa hàng».
  • Khóa API: mục «API». Ô bí mật.
  • Bí mật postback: «Cửa hàng → Postback», dùng ký token thông báo. Ô bí mật.

Hóa đơn được lập bằng tiền tệ thông thường; khách tự chọn tiền điện tử trên trang CryptoCloud. Nhà cung cấp chốt tỷ giá lúc lập hóa đơn.

Thông báo có chữ ký nhưng tự nó chưa đủ xác nhận thanh toán: nền tảng hỏi lại hóa đơn từ CryptoCloud và lấy số tiền trong phản hồi, không lấy từ thông báo. Thanh toán thiếu không đóng hóa đơn: nó vẫn «Chờ thanh toán» và phản ứng không chạy. Thanh toán thừa được coi là đã thanh toán.

Tiền tệ: USD, EUR, RUB. Hỗ trợ hỏi trạng thái. Không hỗ trợ biên lai hoặc hoàn tiền: chuyển khoản trên blockchain không thể đảo ngược; muốn trả tiền phải chuyển khoản riêng cho khách.

NOWPayments

  • Khóa API: tài khoản NOWPayments, «Settings → API keys». Ô bí mật.
  • Bí mật IPN: «Settings → IPN», dùng ký thông báo. Ô bí mật.

Như CryptoCloud, hóa đơn dùng tiền tệ thông thường, khách chọn tiền điện tử trên trang NOWPayments. Toàn bộ thông báo IPN được ký, gồm trạng thái và số tiền, nên không cần hỏi thêm nhà cung cấp.

Nền tảng truyền địa chỉ thông báo cho nhà cung cấp ngay trong hóa đơn, nhưng bạn vẫn phải bật cơ chế IPN trong tài khoản NOWPayments.

Thanh toán một phần không đóng hóa đơn: khi số tiền nhận còn thấp hơn số tiền đã lập, trạng thái vẫn là «Chờ thanh toán».

Tiền tệ: USD, EUR, RUB. Hỗ trợ hỏi trạng thái; không hỗ trợ biên lai hoặc hoàn tiền.

VK Pay

Như Telegram Payments, cổng này chỉ hoạt động trong ứng dụng nhắn tin của nó. Hóa đơn đến dưới dạng nút thanh toán trong cuộc trò chuyện VKontakte, không phải đường dẫn; xác nhận là sự kiện thông thường của cộng đồng, không gọi Callback URL. Vì vậy không cần đặt địa chỉ thông báo và {payment:url} rỗng.

  • ID cộng đồng VK (group_id): số ID của cộng đồng nhận tiền, không có dấu trừ.

Nếu phản ứng với cổng này chạy trong Telegram hoặc WhatsApp, hóa đơn không được tạo: chỉ VKontakte hiển thị được nút VK Pay. Lý do từ chối nằm ở bước «Hóa đơn» trên thẻ phản ứng.

Tiền tệ: RUB. Không hỗ trợ biên lai, hỏi trạng thái hoặc hoàn tiền qua GetMyBot; xử lý giao dịch tranh chấp trong tài khoản VK Pay.

Kịch bản «thanh toán → cấp quyền»

Để cấp quyền sau thanh toán, tạo hai phản ứng: phản ứng đầu lập hóa đơn, phản ứng thứ hai chạy khi tiền đã được xác nhận. Giữa hai sự kiện có thể trôi qua một thời gian; khách có thể đóng cuộc trò chuyện rồi quay lại.

Phản ứng 1: lập hóa đơn

Trigger là hành động bắt đầu mua hàng: lệnh, văn bản hoặc bấm nút. Sau đó thêm Lập hóa đơn và cấu hình:

  • Cổng: cổng cụ thể hoặc «Cổng mặc định».
  • Số tiền: theo đơn vị tiền chính, tức rúp thay vì kopek. Có thể dùng dấu chấm hoặc dấu phẩy cho phần lẻ (199.90). Có thể dùng biến thay thế hoặc công thức, chẳng hạn {user:cart_total}.
  • Tiền tệ: trong danh sách tiền tệ của cổng hoặc «Tiền tệ mặc định của cổng».
  • Mô tả: nội dung khách thấy trên trang thanh toán; hỗ trợ biến thay thế.
  • Thời hạn cục bộ của hóa đơn trong MyBot, giây: 0 tắt hết hạn cục bộ. Nếu bật, nhập số nguyên từ 300 đến 2592000. Thời hạn này không đóng đường dẫn ở nhà cung cấp; khách vẫn có thể thanh toán ở đó. Nếu nhà cung cấp xác nhận tiền về muộn, hóa đơn vẫn chuyển sang «Đã thanh toán».
  • Lưu đường dẫn vào tham số người đăng ký: tùy chọn, hữu ích khi muốn nhắc lại trong phản ứng khác.
  • Các mục trên biên lai: tên và số tiền tính bằng kopek cho mỗi mục. Chỉ hiện với cổng hỗ trợ biên lai.
  • Quà tặng: người nhận: tùy chọn. Biến thay thế hoặc số tg_user_id của người đăng ký mà bạn mua cho, ví dụ {user:gift_to}. Nếu người nhận khác người mua, hóa đơn được coi là quà tặng.
  • Quà tặng: lời nhắn: văn bản của người tặng cho người nhận; hỗ trợ biến thay thế và chỉ lưu ở hóa đơn quà tặng.

Sau hành động, thêm tin nhắn chứa đường dẫn thanh toán: chèn {payment:url}, nếu không khách sẽ không nhận được đường dẫn. Trình dựng cảnh báo khi có hóa đơn nhưng tin nhắn không có biến này.

Ngoài {payment:url}, bạn có thể dùng {payment:id} (ID nội bộ MyBot), {payment:provider_id} (ID tại nhà cung cấp, như payment_id YooKassa), {payment:order} (số đơn hàng), {payment:amount}, {payment:currency}, {payment:description}, {payment:charge_kind} (one_off, initial hoặc recurring) và {payment:plan} (khóa gói đăng ký). Với quà tặng có {payment:gift} (1/0), {payment:gift.from_id}, {payment:gift.to_id} và {payment:gift.message}. Trong phản ứng khi trạng thái đổi, {payment:audience} là buyer hoặc recipient.

Phản ứng 2: cấp quyền

Tạo phản ứng riêng với trigger Thanh toán. Trigger có các bộ lọc:

  • Trạng thái thanh toán: «Đã thanh toán», «Thất bại» hoặc «Đã hoàn tiền». Mặc định là «Đã thanh toán».
  • Cổng: chỉ phản hồi khoản thanh toán qua cổng cụ thể hoặc mọi cổng.
  • Số tiền tối thiểu, kopek: loại hóa đơn nhỏ; so với số tiền hóa đơn.
  • Loại lần thu: bất kỳ, «Một lần», «Lần đầu của gói đăng ký» hoặc «Thu định kỳ». «Thất bại» + «Thu định kỳ» là sự kiện thu định kỳ không thành.
  • Khóa gói đăng ký: chỉ phản hồi các khoản thuộc một gói cụ thể.
  • Gửi đến ai: «Người mua» (mặc định) hoặc «Người nhận quà». Phản ứng dành cho người nhận chỉ chạy với hóa đơn quà tặng, gửi vào cuộc trò chuyện Telegram riêng của họ nếu họ đã nhắn bot. Người mua vẫn nhận phản ứng dành cho đối tượng người mua.

Tiếp theo là hành động bình thường: cấp quyền, gắn nhãn «Đã thanh toán», ghi đơn vào bộ sưu tập, gửi tài liệu. Trong văn bản có cùng các biến {payment:...}, gồm {payment:status} và {payment:refunded}.

Trigger Thanh toán hoạt động cho cả chiều hoàn tiền: phản ứng với trạng thái «Đã hoàn tiền» có thể tự thu hồi quyền truy cập.

Gói đăng ký thu tiền tự động

Gói đăng ký là khoản thu định kỳ qua phương thức thanh toán đã lưu. YooKassa (save_payment_method) và Stripe (setup_future_usage cùng việc gắn thẻ vào đối tượng khách hàng customer) hỗ trợ đầy đủ việc thu tự động.

Đăng ký gói

Đăng ký gói lập hóa đơn đầu và yêu cầu cổng lưu phương thức thanh toán. Chọn cổng, khóa gói như premium, số tiền, tiền tệ, chu kỳ (week, month hoặc year), mô tả và các mục biên lai nếu cần. Sau khi trả tiền, gói hoạt động và lần thu tự động đầu được lên lịch sau một chu kỳ. Nếu cổng không trả phương thức thanh toán đã lưu, gói bị hủy với lý do method_not_saved; kỳ đầu đã trả tiền vẫn còn.

Khi hóa đơn đầu chưa được trả, chạy lại hành động sẽ hủy hóa đơn chưa trả cũ và tạo hóa đơn mới. Nếu gói cùng khóa đang active hoặc past_due, hệ thống không tạo hóa đơn mới.

Thu định kỳ và các lần thất bại

Khoản thu tự động chạy khi kỳ hiện tại kết thúc. Mỗi lần thử là hóa đơn riêng trong nhật ký, loại recurring. Sau lần thất bại thứ nhất, gói thành past_due và thử lại sau một ngày; sau lần thứ hai, thử lại sau ba ngày. Lần thứ ba thất bại làm gói thành expired. Lần thu thất bại kích hoạt trigger Thanh toán → Thất bại + Thu định kỳ; thành công kích hoạt Đã thanh toán + Thu định kỳ.

Dừng gói và đổi điều kiện

Hủy gói đăng ký dừng thu tự động cho người đăng ký theo khóa hoặc cho mọi gói còn hoạt động của họ. Sửa gói đăng ký đổi chu kỳ và/hoặc số tiền từ lần thu kế tiếp. Cả hai hành động được phép trong phản ứng thanh toán, chẳng hạn dừng thu sau hoàn tiền; Đăng ký gói bị cấm trong phản ứng thanh toán.

Biến thay thế của gói đăng ký

Có thể dùng {subscription:id}, {subscription:plan}, {subscription:status} (none, pending, active, past_due, canceled, expired), {subscription:period}, {subscription:amount}, {subscription:currency}, {subscription:period_end}, {subscription:next_charge_at}, {subscription:attempts} và {subscription:method} (tên phương thức thanh toán đã che). Ngoài phản ứng thanh toán, các biến lấy gói mới nhất của người đăng ký có trạng thái active hoặc past_due; nếu không có, trạng thái là none.

Chủ tài khoản có thể quản lý gói qua REST và MCP. Dừng bằng cancel_subscriber_subscription không hoàn khoản tiền đã thu.

Quyền truy cập có hạn: câu lạc bộ theo gói

Để quyền hết hạn cùng kỳ đã trả tiền, dùng nhãn có thời hạn:

  1. Ở phản ứng sau thanh toán (trigger Thanh toán), dùng Sửa nhãn → thêm «Câu lạc bộ», Số ngày hiệu lực = 30. Sau đó gửi đường dẫn nhóm kín và hướng dẫn xin tham gia.
  2. Tạo phản ứng riêng cho Sự kiện hệ thống → Yêu cầu tham gia. Thêm điều kiện có nhãn «Câu lạc bộ» để không chấp nhận khách chưa trả tiền, rồi dùng Sửa quyền → Duyệt yêu cầu với chat_id rõ ràng của nhóm kín. Bot chỉ duyệt được yêu cầu đã gửi; phản ứng này chạy cho người gửi yêu cầu.
  3. Phản ứng cho Sự kiện hệ thống → Nhãn hết hạn: dùng Sửa quyền → Loại khỏi nhóm với cùng chat_id. Trong lúc phản ứng chạy, nhãn vẫn được gắn và chỉ bị gỡ sau khi xử lý sự kiện thành công. Nếu hành động lỗi, sự kiện được thử lại và nhãn không mất. Văn bản có {{event.label_name}} và {{event.expired_at}}.
  4. Trước khi hết hạn, tin nhắn có thể dùng {{label.Câu lạc bộ.days_left}} và {{label.Câu lạc bộ.expires_at}} để hiện thời gian còn lại. Lần trả tiền tiếp sẽ đặt nhãn lại thành 30 ngày từ lúc thanh toán.

Cùng quy trình áp dụng cho VK Donut (sự kiện đăng ký thay trigger Thanh toán, xem Kênh → VK Donut) và chiến dịch: nút Trì hoãn, sau đó Hành động → Sửa quyền với chat_id rõ ràng.

Trạng thái hóa đơn

Trạng thái có trong nhật ký và thẻ thanh toán:

  • Đã tạo: hóa đơn có trong GetMyBot, nhà cung cấp chưa báo kết quả. Thường kéo dài vài giây trước khi có đường dẫn.
  • Chờ thanh toán: đã cấp đường dẫn, khách chưa trả tiền.
  • Đã thanh toán: tiền đã đến, số tiền và tiền tệ khớp hóa đơn. Lúc này phản ứng thanh toán chạy.
  • Lỗi: thanh toán không thành, chẳng hạn ngân hàng từ chối hoặc thẻ không qua kiểm tra. Đây chưa phải trạng thái cuối: nếu nhà cung cấp xác nhận sau, hóa đơn vẫn thành «Đã thanh toán».
  • Đã hủy: giao dịch bị hủy, sẽ không đổi tiếp.
  • Hết hạn: hết thời hạn hóa đơn. Nếu tiền vẫn đến sau đó, hóa đơn thành «Đã thanh toán» vì tiền thực nhận luôn được ghi nhận.
  • Đã hoàn tiền: hoàn toàn bộ.
  • Đã hoàn một phần: hoàn một phần; có thể hoàn phần còn lại sau, khi đó thành «Đã hoàn tiền».

Thông báo lặp lại với cùng trạng thái không thay đổi gì, nên quyền truy cập không bị cấp hai lần. Thông báo đến sau không thể kéo hóa đơn đã trả về «Chờ thanh toán».

Nhật ký thanh toán

Phần Thanh toán liệt kê tất cả hóa đơn của bot. Bạn có thể tìm theo số đơn hàng, lọc trạng thái và cổng. Thẻ thanh toán cũng có ID của nhà cung cấp, thông tin quà tặng và liên kết tới gói đăng ký nếu khoản tiền thuộc gói.

Bấm hàng để mở thẻ: số tiền, trạng thái, cổng, người trả, thời điểm tạo và trả, mô tả cùng nhật ký sự kiện. Nhật ký ghi từng lần thử đổi trạng thái và nguồn: callback, hỏi trạng thái, đối soát thủ công, hoàn tiền. Hãy xem ở đây trước khi xử lý sự cố.

Hoàn tiền

GetMyBot hỗ trợ hoàn tiền trong giao diện với MIXPLAT, YooKassa, CloudPayments, T-Kassa và Stripe. Với Robokassa, Prodamus, Lava.top, VK Pay và Telegram Payments, hãy hoàn trong tài khoản nhà cung cấp. CryptoCloud và NOWPayments không có chức năng hoàn tiền: chuyển trên blockchain không thể đảo ngược, cần chuyển khoản khác cho khách.

Cách làm: Thanh toán → chọn khoản → bấm Hoàn tiền trên thẻ. Nút chỉ hiện cho hóa đơn đã thanh toán qua cổng hỗ trợ hoàn tiền. Hệ thống hỏi xác nhận riêng.

Bạn không phải hoàn toàn bộ. Cả năm cổng kể trên hỗ trợ hoàn một phần, nên cạnh nút có ô số tiền: mặc định là phần chưa hoàn của hóa đơn, nhưng bạn có thể trả ít hơn rồi hoàn phần còn lại sau. Không thể hoàn quá số dư ấy.

Sau khi nhà cung cấp xác nhận, hóa đơn thành «Đã hoàn tiền» hoặc «Đã hoàn một phần». Sự kiện hoàn tiền nằm trong nhật ký. Nếu có phản ứng với trigger Thanh toán và trạng thái «Đã hoàn tiền», phản ứng sẽ chạy.

Biên lai và quy định thuế

Biên lai theo luật Nga 54-FZ do nhà cung cấp thanh toán của bạn lập, không phải GetMyBot. Nền tảng chỉ truyền các mục bạn đặt trong Lập hóa đơn và hệ thống thuế đã chọn cho cổng.

Hệ quả:

  • tổng các mục phải bằng tổng hóa đơn, nếu không nhà cung cấp từ chối;
  • thuế VAT cho mỗi mục phải chọn rõ ràng, mặc định là «không VAT»; số lượng mặc định bằng một nếu không đặt khác;
  • với tư cách người bán, bạn chịu trách nhiệm về tên hàng, thuế suất và loại đối tượng tính tiền. Hãy kiểm tra biên lai mẫu trong tài khoản nhà cung cấp trước khi bán thật.

Khi gặp sự cố

Tiền đã trừ nhưng phản ứng không chạy

Mở thẻ thanh toán, xem trạng thái và nhật ký sự kiện, rồi kiểm tra:

  • Chưa ở «Đã thanh toán»: nhà cung cấp chưa gửi xác nhận hoặc xác nhận bị từ chối. Kiểm tra Callback URL của cổng đã đặt bên nhà cung cấp và xem các sự kiện.
  • Đã thanh toán nhưng không có phản ứng: kiểm tra bộ lọc trigger Thanh toán, nhất là cổng và số tiền tối thiểu. Bộ lọc cổng khác sẽ không khớp.
  • Hóa đơn được lập ngoài cuộc trò chuyện: nếu khoản tiền không gắn người trả, không có ai để gửi phản ứng. Khoản tiền vẫn nằm trong nhật ký.
  • Gói cước không hỗ trợ thu tiền: hệ thống không lập hóa đơn và sự kiện thanh toán không khởi chạy phản ứng.
  • Khách không nhận đường dẫn: tin nhắn thiếu {payment:url}. Kiểm tra văn bản của phản ứng lập hóa đơn.

Muốn biết phản ứng đã làm gì, mở cuộc trò chuyện của người đăng ký ở Người dùng hoặc Trò chuyện: dưới tin nhắn có thẻ các bước đã chạy. Bước «Hóa đơn» cho biết cả kết quả thành công lẫn lý do từ chối như «không tìm thấy cổng» hoặc «cổng không nhận USD».

Nhà cung cấp gửi thông báo liên tục

Điều này thường bình thường: hệ thống thanh toán gửi lại tới khi nhận xác nhận. Lặp lại là an toàn: thông báo với trạng thái đã áp dụng không thay đổi gì và không cấp quyền lần hai.

Nếu gửi mãi, nhà cung cấp có thể không nhận được xác nhận. Nguyên nhân thường là sai địa chỉ thông báo hoặc chữ ký không khớp vì khóa trong cổng sai. Thông báo sai chữ ký bị từ chối hoàn toàn và không đổi trạng thái hóa đơn; callback giả không thể cấp quyền.

Thanh toán khác số tiền trên hóa đơn

Nếu nhà cung cấp báo số tiền khác, hóa đơn không được đánh dấu đã trả; nhật ký ghi lý do từ chối. Đây là cơ chế bảo vệ: trả một trăm không thể mở món hàng giá mười nghìn.

Hãy đối chiếu số tiền trong tài khoản nhà cung cấp. Vì tiền đã vào tài khoản của bạn, bạn quyết định hoàn cho khách hay lập hóa đơn đúng số tiền. Nếu giao dịch là hợp lệ và cần ghi nhận, liên hệ hỗ trợ để đối soát bằng thao tác riêng; nhật ký sẽ ghi «đối soát thủ công».

Cổng không có trong gói cước

Màn hình Cổng thanh toán giải thích và dẫn đến bảng giá; nút kết nối không hoạt động. Cổng đã kết nối vẫn được giữ nhưng không lập hóa đơn và sự kiện thanh toán không chạy phản ứng. Sau khi chuyển sang gói phù hợp, cổng lại hoạt động với thông tin cũ.

Số dư và gói cước nền tảng

Chi phí dùng GetMyBot tách riêng tiền khách trả cho bạn. Mức sử dụng được tính bằng lượt yêu cầu: khi phản ứng chạy, số dư tài khoản bị trừ theo các hành động đã thực hiện, nhưng ít nhất một lượt. Xem Thống kê và nhật ký.

Phần Thanh toán cho thấy số dư hiện tại và gói có thể chọn. Gói có giá, số lượt yêu cầu và giới hạn như số bot tối đa. Nút Chọn kích hoạt gói.

Số dư được tính từ nhật ký cộng trừ không thể sửa: thưởng đăng ký, cộng lượt theo gói, nạp thêm và tiêu dùng. Chỉ thêm bản ghi mới vào nhật ký, nên có thể đối chiếu lịch sử và số dư hiện tại bằng tổng các bản ghi.

Nạp thêm tạo giao dịch thanh toán cho số lượt yêu cầu cần mua. Khi nhà cung cấp xác nhận, số dư tự được cộng; thông báo lặp lại không cộng hai lần.

Đọc tiếp

Số dư chung và ví của bot

Số dư chung và các ví riêng của bot đều thuộc một tài khoản. Bot không có ví riêng dùng số dư chung. Trong Phân bổ số dư, chọn nguồn và nơi nhận, nhập số dương không vượt số dư khả dụng, rồi kiểm tra cả hai số dư trên bản xem trước. Việc chuyển chỉ phân bổ số dư đã có; nó không nạp thêm hoặc rút tiền.

Thưởng giới thiệu và rút tiền

Sao chép đường dẫn trong Chương trình giới thiệu để mời khách. Nhật ký tách tiền thưởng đang giữ, có thể dùng, khoản trừ và tiền rút theo từng đơn vị tiền tệ. Khi tạo yêu cầu rút, chọn tiền tệ có số dư khả dụng, nhập số không vượt số dư và thông tin nhận tiền. Theo dõi trạng thái: chờ, đã duyệt, bị từ chối hoặc đã trả. Được duyệt chưa có nghĩa tiền đã được gửi.