PaymentKai | Bank QR, Card2K, GiftCode & Donation System ⭐⭐⭐⭐⭐

PaymentKai
A Modern Minecraft Donation Plugin
Hệ thống nạp tiền toàn diện dành cho máy chủ Minecraft Paper/Spigot

Hỗ trợ QR Banking, Card2K, GiftCode, Coupon, Mốc nạp, REST API, Discord Webhook, PlaceholderAPI và nhiều tính năng khác.

Compatibility: Paper / Spigot 1.16 - 1.21.x

✨ Tính năng
Chuyển khoản ngân hàng

• Hỗ trợ thanh toán bằng mã QR.
  
  
• Tự động kiểm tra giao dịch.
  
  
• Xác nhận giao dịch theo thời gian thực.
  
  
• Tuỳ chỉnh ngân hàng và nội dung chuyển khoản.
  
  
• Tự động trao thưởng sau khi giao dịch thành công.
  

Nạp thẻ cào (Card2K)
PaymentKai tích hợp trực tiếp với Card2K.

Các loại thẻ được hỗ trợ phụ thuộc vào hệ thống Card2K, bao gồm:

• Viettel
  
  
• Vinaphone
  
  
• Mobifone
  
  
• Vietnamobile
  
  
• Garena
  
  
• Zing
  
  
• Các loại thẻ khác do Card2K hỗ trợ
  

Sau khi Card2K xác nhận giao dịch, plugin sẽ tự động:

• Cộng Point
  
  
• Cộng PlayerPoints
  
  
• Cộng Vault Money
  
  
• Thực thi Command
  
  
• Gửi thông báo cho người chơi
  
  
• Lưu lịch sử giao dịch
  

Gift Code

• Tạo GiftCode không giới hạn.
  
  
• Giới hạn số lượt sử dụng.
  
  
• Giới hạn thời gian.
  
  
• Thưởng Item.
  
  
• Thưởng Command.
  
  
• Thưởng Point.
  

Coupon

• Coupon khuyến mãi.
  
  
• Coupon giảm giá.
  
  
• Coupon theo thời gian.
  
  
• Coupon theo người chơi.
  

Mốc nạp

• Phần thưởng theo tổng giá trị đã nạp.
  
  
• Nhận thưởng một lần.
  
  
• Hỗ trợ Command và Item Reward.
  

Bảng xếp hạng

• Top người nạp.
  
  
• Thống kê tổng số tiền.
  
  
• Cập nhật tự động.
  

Lịch sử giao dịch
Theo dõi toàn bộ:

• Chuyển khoản
  
  
• Thẻ cào
  
  
• GiftCode
  
  
• Coupon
  

Hồ sơ Donor
Hiển thị:

• Tổng số tiền đã nạp
  
  
• Số lần nạp
  
  
• Mốc nạp đã đạt
  
  
• Thông tin Donor
  

REST API
PaymentKai cung cấp REST API giúp Website hoặc Launcher có thể kết nối trực tiếp với plugin.

Có thể sử dụng để:

• Truy vấn dữ liệu người chơi
  
  
• Kiểm tra giao dịch
  
  
• Đồng bộ dữ liệu
  
  
• Tích hợp hệ thống bên ngoài
  

Discord Webhook

• Thông báo giao dịch thành công.
  
  
• Thông báo lỗi.
  
  
• Tuỳ chỉnh Embed.
  

Hỗ trợ Plugin

• PlaceholderAPI
  
  
• Vault
  
  
• PlayerPoints
  
  
• Floodgate
  
  
• Geyser-Spigot
  
  
• XuCoreKai
  

Giao diện

• GUI tuỳ chỉnh bằng YAML.
  
  
• Hỗ trợ đa ngôn ngữ.
  
  
• Tuỳ chỉnh Theme.
  
  
• Tuỳ chỉnh Icon.
  
  
• Tuỳ chỉnh Lore.
  
  
• Tuỳ chỉnh Sound.
  

Cấu trúc Plugin
plugins/
└── PaymentKai/
├── config.yml
├── settings.yml
├── database.yml
├── bank.yml
├── checkout.yml
├── dashboard.yml
├── promotion.yml
├── milestone.yml
├── coupon.yml
├── gift.yml
├── discord.yml
├── rest-api.yml
├── platform.yml
├── theme.yml
├── providers/
├── gui/
└── lang/

⚙️ Cài đặt
1. Cài Plugin
Đặt PaymentKai.jar vào thư mục:

plugins/

Khởi động server.

2. Cấu hình Database
Plugin hỗ trợ:

• SQLite
  
  
• MySQL
  
  
• MariaDB
  

3. Cấu hình Card2K
Ví dụ:

card2k:
enabled: true
api-key: "YOUR_API_KEY"
partner-id: "YOUR_PARTNER_ID"
callback-secret: "YOUR_SECRET"

Sau khi tạo API trên Card2K, hãy nhập thông tin vào file cấu hình để kích hoạt chức năng nạp thẻ.

4. Reload Plugin
/paymentkai reload

⌨️ Commands
Command Chức năng
/nap Menu nạp tiền
/napbank Chuyển khoản
/napthe Nạp thẻ
/napthedt Nạp thẻ điện thoại
/gift Nhập GiftCode
/coupon Nhập Coupon
/mocnap Xem mốc nạp
/topnap Bảng xếp hạng
/lichsu Lịch sử giao dịch
/donor Hồ sơ Donor
/paymentkai Lệnh quản trị
/naptheadmin Quản lý thẻ
Permissions
Permission Mô tả
paymentkai.use Sử dụng plugin
paymentkai.bank Chuyển khoản
paymentkai.card Nạp thẻ
paymentkai.history Xem lịch sử
paymentkai.admin Toàn quyền quản trị
API
PaymentKai cung cấp Event API cho Developer.

Một số Event:

• PaymentPendingEvent
  
  
• PaymentSuccessEvent
  
  
• PaymentReviewEvent
  
  
• PaymentExpiredEvent
  

PlaceholderAPI
Ví dụ Placeholder:

%paymentkai_total%
%paymentkai_today%
%paymentkai_month%
%paymentkai_rank%
%paymentkai_last_amount%

️ Yêu cầu

• Java 17 hoặc mới hơn.
  
  
• Paper 1.16 – 1.21.x.
  
  
• Spigot 1.16 – 1.21.x.
  

Khuyến nghị:

• PlaceholderAPI
  
  
• Vault
  
  
• PlayerPoints
  

Hiệu năng

• Async Database.
  
  
• Async HTTP Request.
  
  
• Cache dữ liệu.
  
  
• GUI tối ưu.
  
  
• Hỗ trợ máy chủ quy mô lớn.
  

Phiên bản
PaymentKai v1.5.0

❤️ Cảm ơn
Cảm ơn bạn đã sử dụng PaymentKai.

Nếu gặp lỗi hoặc có ý tưởng mới, hãy liên hệ tác giả để được hỗ trợ.

Made with ❤️ by Kai