Bắt đầu nhanh

Hướng dẫn này sẽ giúp bạn thiết lập cổng thanh toán đầu tiên và nhận thanh toán đầu tiên trong vòng 5 phút.

Chọn cổng thanh toán

PayOS - Dễ setup nhất, phù hợp cho người mới bắt đầu

✅ Không cần webhook server
✅ QR code tự động
✅ Hỗ trợ tất cả ngân hàng Việt Nam
⚠️ Cần đăng ký tài khoản PayOS

Setup PayOS (Khuyến nghị)

Đăng ký tài khoản PayOS
- Truy cập https://my.payos.vn
- Đăng ký tài khoản
- Xác minh thông tin và liên kết ngân hàng theo hướng dẫn của PayOS
Tạo kênh thanh toán và lấy thông tin API

Vào Kênh thanh toán → Tạo kênh thanh toán → Chọn “Website” và điền thông tin cần thiết. Bạn sẽ cần chọn 2 tài khoản phụ và chính ở bước này.

Vào Kênh thanh toán vừa tạo và copy:
- Client ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- API Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- Checksum Key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Cấu hình plugin

Mở plugins/SimpPay/banking/payos-config.yml:

# PayOS Configuration
enabled: true

# API Credentials từ PayOS Dashboard
client-id: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
api-key: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
checksum-key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Timeout cho polling (giây)
timeout: 300

# Interval giữa các lần check (giây)
interval: 5

# Số tiền tối thiểu (VNĐ)
min-amount: 10000

# Số tiền tối đa (VNĐ)
max-amount: 50000000

Reload plugin

Trong game hoặc console:
```
/simppayadmin reload
```
Test thanh toán

Trong game:
```
/bank 10000
```
Bạn sẽ nhận được QR code để quét và thanh toán.

Setup TheSieuToc (Thẻ cào)

Đăng ký tài khoản
- Truy cập https://thesieutoc.net
- Đăng ký tài khoản
Lấy thông tin API

Vào Tích hợp API:
- APIKey: xxxxx
- APISecret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Cấu hình plugin

Mở plugins/SimpPay/card/thesieutoc-config.yml:

# TheSieuToc Configuration
enabled: true

# Partner credentials từ TheSieuToc
partner-id: "xxxxx"
partner-key: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Timeout cho polling (giây)
timeout: 300

# Interval giữa các lần check (giây)
interval: 10

# Loại thẻ được hỗ trợ
supported-card-types:
  - VIETTEL
  - MOBIFONE
  - VINAPHONE

# Mệnh giá được hỗ trợ (VNĐ)
supported-amounts:
  - 10000
  - 20000
  - 50000
  - 100000
  - 200000
  - 500000
  - 1000000

Reload plugin
```
/simppayadmin reload
```
Test nạp thẻ

Trong game:
```
/napthe
```
Chọn loại thẻ → Chọn mệnh giá → Nhập serial và PIN.

Cấu hình hệ thống xu

Chọn coins provider

Mở plugins/SimpPay/coins-config.yml:

# Coins Configuration

# Provider: PLAYERPOINTS, COINSENGINE
coins-provider: "PLAYERPOINTS"

# Tỷ lệ quy đổi cơ bản (VNĐ → Coins)
# 1000 VNĐ = 1 coin
base-card-rate: 1
base-bank-rate: 1

# Tỷ lệ thưởng thêm (%)
extra-card-rate: 0
extra-bank-rate: 0

# Tỷ lệ khuyến mãi (%)
promo-rate: 0

# Ngày kết thúc khuyến mãi (dd/MM/yyyy HH:mm)
end-promo: "31/12/2026 23:59"

Cài đặt PlayerPoints

Nếu chọn PLAYERPOINTS:
- Tải PlayerPoints
- Đặt vào plugins/ và khởi động lại
Test quy đổi

Với config trên:
- Nạp 50,000 VNĐ → Nhận 50 coins
- Nạp 100,000 VNĐ → Nhận 100 coins

Kiểm tra hoạt động

Test thanh toán thật
- Nạp một số tiền nhỏ (10k-20k)
- Kiểm tra coins được cộng đúng
- Xem lịch sử: /lichsunapthe

Kiểm tra database

Xem bảng card_payment hoặc banking_payment:

SELECT * FROM banking_payment ORDER BY created_at DESC LIMIT 5;

Kiểm tra leaderboard

Nếu có PlaceholderAPI:

/papi parse me %simppay_leaderboard_all_1_name%

Troubleshooting

QR code không hiển thị

Thẻ cào bị từ chối

Coins không được cộng

Bật debug mode

Để xem log chi tiết, mở plugins/SimpPay/main-config.yml:

# Main Configuration
debug: true # Bật debug logging

Reload plugin và kiểm tra console để thấy:

API requests/responses
Payment status polling
Event firing sequence
Database queries