PayBot

Next Update: The UI Update -> Done

Further updates: Bug fixes, UI optimization, plugin speed optimization, plugin response speed optimization.

Vietnamese:

📡 Công khai dữ liệu chia sẻ (Data Disclosure)

Plugin và Discord Bot này gửi các dữ liệu sau đến máy chủ bên thứ ba để xử lý giao dịch:

Dữ liệu gửi từ Plugin → Discord Bot (dịch vụ mở rộng):

• Tên người chơi (player_name) — để xác định ai đã thực hiện giao dịch
• Định danh server (server_id) — để bot nhận diện đúng server gửi yêu cầu
• URL callback của plugin — để bot gửi kết quả giao dịch về đúng server
• Thông tin thẻ cào (chỉ khi dùng /napthe): nhà mạng (telco), mệnh giá (denom), mã thẻ (card_code), số serial thẻ (card_serial)
• Số tiền giao dịch (chỉ khi dùng /napbank): giá trị người chơi nhập vào
• Danh sách tên người chơi đang online — gửi định kỳ mỗi 30 giây để bot xử lý reward đúng người

Dữ liệu gửi từ Discord Bot → Dịch vụ bên thứ ba:

• SePay — nhận IPN webhook xác nhận giao dịch ngân hàng/ví điện tử; nhận: mã đơn hàng, số tiền, trạng thái thanh toán
• TheSieuRe — xử lý đổi thẻ cào sang tiền; nhận: partner_id, partner_key, telco, mệnh giá, mã thẻ, serial thẻ, request_id
• GachThePro — xử lý đổi thẻ cào sang tiền (nhà cung cấp thay thế); nhận dữ liệu tương tự TheSieuRe
• GachTheFast — sẽ được hỗ trợ trong phiên bản tới; dữ liệu gửi đi sẽ được cập nhật khi tích hợp hoàn tất

Không có dữ liệu nào được gửi đi khi admin chưa cấu hình plugin qua /SePaySetup hoặc /CardSetup. Người chơi không tự động kết nối với bất kỳ máy chủ từ xa nào.

⚠️ Lưu ý kỹ thuật: Plugin mở một HTTP server nội bộ trên port 25580 (mặc định) (có thể thay đổi trong config.yml) để nhận callback từ bot Discord và webhook từ SePay. Admin cần đảm bảo port này được mở trên firewall của server nếu sử dụng tính năng tự động.

📌 Mô tả Plugin

Plugin này yêu cầu các server Minecraft sử dụng Purpur, Paper hoặc Folia và gần như mọi fork khác của PaperMC (1.20+).

Tính năng:

• /napbank: Hỗ trợ nạp toàn bộ các ngân hàng/ví điện tử hiện có ở Việt Nam thông qua SePay
• /napthe: Hỗ trợ nạp thẻ cào Viettel, Mobifone, Vinaphone, Zing, Gate, Garena, Vcoin, Appota thông qua TheSieuRe, GachThePro và các nhà cung cấp khác
• /SePaySetup: Cấu hình và kết nối plugin với SePay
• /CardSetup: Kết nối với các trung gian đổi thẻ cào

Plugin giúp admin server tự động xử lý donate, cấu hình lệnh thưởng riêng, số tiền tương ứng cho từng mệnh giá.

🤖 Discord Bot (Dịch vụ Tự động hóa — Tùy chọn)

Bot Discord hoạt động như một lớp trung gian giữa plugin Minecraft và các nhà cung cấp thanh toán, giúp tự động hóa toàn bộ quy trình xử lý giao dịch. Không thay đổi kết cấu plugin!

Cách Bot hoạt động:

• Nhận yêu cầu giao dịch từ plugin qua HTTP (nạp thẻ hoặc nạp bank)
• Gửi thông tin thẻ cào đến TheSieuRe/GachThePro để đổi; nhận kết quả và cập nhật trạng thái
• Nhận IPN webhook từ SePay khi người chơi chuyển khoản thành công
• Gửi lệnh thưởng về plugin sau khi giao dịch hoàn tất
• Lưu hàng đợi reward offline — nếu server Minecraft tạm offline, bot giữ reward lại và tự động trao khi server kết nối lại
• Gửi thông báo giao dịch về Discord (webhook) để admin theo dõi
• Theo dõi danh sách player online để đảm bảo reward trao đúng người, đúng lúc

Dữ liệu Bot lưu trữ nội bộ: cấu hình guild Discord, lịch sử giao dịch thẻ/bank, hàng đợi reward chờ xử lý, thông tin license, danh sách server kết nối.

Plugin này không trực tiếp xử lý thanh toán. Tất cả các giao dịch tài chính đều được xử lý độc quyền bởi các dịch vụ bên thứ ba được liệt kê trong phần Tiết lộ dữ liệu ở trên.

Quy trình: Người chơi sử dụng /napbank hoặc /napthe → plugin lưu các thông tin (chi tiết ở trên) và gửi đến SePay/TheSieuRe,... → Sau khi xác nhận đơn hàng, admin hoặc bot Discord tự động thực thi lệnh thưởng đã được cấu hình sẵn.

Để setup bot, liên hệ qua Discord: Shiroz (therealshiroz)

Quyền Sử Dụng

Bạn, với tư cách là người dùng, có thể làm những điều sau với plugin này mà không cần xin phép tôi:

• Bạn có thể tạo video hoặc chụp ảnh màn hình và đăng tải chúng ở bất cứ đâu bạn muốn, tôi chỉ yêu cầu bạn ghi chú plugin này là gì và cho mọi người biết nơi để tải nó.
• Bạn có thể sử dụng plugin này như một phần phụ thuộc của plugin khác, miễn là bạn ghi công và liên kết trở lại trang này.

Bạn, với tư cách là người dùng, KHÔNG được phép làm những điều sau với plugin này:

• Bạn không được phép phân phối lại hoặc tải lên lại plugin này khi không được cho phép!
• Bạn không được phép dịch ngược mã hoặc sửa đổi để chạy chung được với plugin khác, trường hợp đặc biệt có thể được cho phép tuỳ theo yêu cầu!

Links:

👉 Contact me

👉 Tải Trên Hangar

👉 Tải Trên Spigot

👉 Tải Trên Modrinth

English:

📡 Data Disclosure

This plugin and its companion Discord Bot transmit the following data to third-party servers for transaction processing:

Data sent from Plugin → Discord Bot (extended automation service):

• Player username (player_name) — to identify who initiated the transaction
• Server identifier (server_id) — so the bot can route requests to the correct server
• Plugin callback URL — so the bot can return transaction results to the correct server
• Prepaid card details (only when using /napthe): carrier (telco), denomination (denom), card code (card_code), card serial (card_serial)
• Transaction amount (only when using /napbank): the value entered by the player
• List of online player names — sent every 30 seconds so the bot can deliver rewards to the correct players

Data sent from Discord Bot → Third-party services:

• SePay — receives IPN webhooks confirming bank/e-wallet transactions; receives: invoice ID, amount, payment status
• TheSieuRe — handles prepaid card exchange; receives: partner_id, partner_key, carrier, denomination, card code, card serial, request_id
• GachThePro — handles prepaid card exchange (alternative provider); receives the same data as TheSieuRe
• GachTheFast — support coming in a future update; data transmitted will be documented here upon integration

No data is transmitted until the server admin configures the plugin via /SePaySetup or /CardSetup. Players are not automatically connected to any remote server.

⚠️ Technical note: This plugin opens an internal HTTP server on port 25580 (default) (configurable in config.yml) to receive callbacks from the Discord Bot and webhooks from SePay. Admins must ensure this port is open on the server's firewall when using the automation features.

📌 Plugin Description

This plugin requires a Minecraft server running Purpur, Paper, or Folia, and almost all other PaperMC forks (1.20 and above).

Features:

• /napbank: Supports deposits from all Vietnamese banks and e-wallets via SePay
• /napthe: Supports prepaid card top-ups — Viettel, Mobifone, Vinaphone, Zing, Gate, Garena, Vcoin, Appota — via TheSieuRe, GachThePro, and other providers
• /SePaySetup: Configure and connect the plugin with SePay
• /CardSetup: Connect with prepaid card exchange providers

The plugin allows server admins to automate donation handling, configure custom reward commands, and set reward amounts per denomination.

🤖 Discord Bot (Extended Automation Service — Optional)

The Discord Bot acts as a middleware layer between the Minecraft plugin and payment providers, fully automating the transaction workflow.

How the Bot works:

• Receives transaction requests from the plugin over HTTP (card top-up or bank transfer)
• Forwards card data to TheSieuRe/GachThePro for processing; receives results and updates transaction status
• Receives IPN webhooks from SePay when a player completes a bank transfer
• Sends reward commands back to the plugin once a transaction is confirmed
• Maintains an offline reward queue — if the Minecraft server is temporarily offline, the bot holds rewards and delivers them automatically when the server reconnects
• Sends transaction notifications to Discord (webhook) for admin monitoring
• Tracks the online player list to ensure rewards are delivered to the right player at the right time

Data stored internally by the Bot: Discord guild configuration, card/bank transaction history, pending reward queue, license information, connected server list.

This plugin does not directly process payments. All financial transactions are processed exclusively by the third-party services listed in the Data Disclosure section above.

Process: Players use /napbank or /napthe → the plugin saves the relevant information (detailed above) and sends it to SePay/TheSieuRe,... → Once the transaction is confirmed, the admin or Discord Bot automatically executes the preconfigured reward command.

For bot setup and support, contact via Discord: Shiroz (therealshiroz)

Rights of Use

You as the user may do the following with this plugin without asking my permission.

• You may create videos or take screenshots and post them anywhere you please, I just ask that you note what the plugin is and let people know where to get it.
• You can use this plugin as a dependency on another plugin, as long as you give credit and link back to this page.

You as the user, may NOT do the following with the plugin.

• You cannot redistribute or re-upload this plugin without permission!
• You are not allowed to reverse engineer or modify the code to run in conjunction with other plugins; exceptional cases may be permitted depending on requirements!

Links:

👉 Contact me:

👉 Download On Hangar

👉 Download On Spigot

👉 Download On Modrinth