Tài Liệu Kết Nối API & Cổng Banking Tự Động
Tích hợp cổng nạp tiền VietQR Napas 24/7, tra cứu tài khoản ngân hàng, webhook biến động số dư và toàn bộ kho tài nguyên MMO tự động với tốc độ phản hồi cực nhanh dưới 50ms.
1. API VietQR & Cổng Banking Tự Động
Mở VietQR Studio SandboxTrả về danh sách đầy đủ các ngân hàng kèm mã định danh BIN Napas, tên viết tắt (shortName), tên đầy đủ và link logo VietQR.
{
"status": "success",
"total": 28,
"data": [
{
"id": "MB",
"name": "Ngân hàng Quân Đội",
"shortName": "MBBank",
"bin": "970422",
"logo": "https://api.vietqr.io/img/MB.png"
}
]
}
Truyền thông tin tài khoản ngân hàng thụ hưởng, số tiền và nội dung chuyển khoản để nhận về link ảnh VietQR và chuỗi EMVCo payload chuẩn Napas 24/7.
{
"bankId": "MB",
"accountNo": "0988888888",
"accountName": "NGUYEN VAN KYO",
"amount": 200000,
"memo": "NAP KYO 849201",
"template": "compact2"
}
{
"status": "success",
"data": {
"bank_id": "MB",
"bank_name": "Ngân hàng Quân Đội",
"bin": "970422",
"account_no": "0988888888",
"account_name": "NGUYEN VAN KYO",
"amount": 200000,
"memo": "NAP KYO 849201",
"qr_image_url": "https://img.vietqr.io/image/MB-0988888888-compact2.png?amount=200000&addInfo=NAP+KYO+849201",
"emvco_payload": "00020101021238570010A00000072701270006970422011009888888880208QRIBFTTA530370454062000005802VN62180814NAP KYO 84920163047D3B"
}
}
Frontend gọi định kỳ 2-3 giây để kiểm tra xem đơn hàng hoặc giao dịch chuyển khoản với mã Memo tương ứng đã được Webhook ghi nhận và cộng tiền thành công chưa.
{
"status": "success",
"is_paid": true,
"deposit_status": "completed",
"data": {
"id": 14,
"username": "user123",
"amount": 200000,
"bonus_amount": 6000,
"total_received": 206000,
"gateway": "SePay MBBank",
"status": "completed"
}
}
2. API Đại Lý & Kho Hàng Reseller
Trả về danh sách tất cả sản phẩm MMO kèm giá bán đại lý, số lượng tài khoản còn trong kho và đơn vị tính.
Gửi yêu cầu mua hàng bằng số dư tài khoản đại lý kèm Header Authorization: Bearer YOUR_API_KEY. Hệ thống tự động trừ tiền và bàn giao danh sách tài khoản ngay lập tức.
3. API Cloudflare DNS & Xoay Proxy Tự Động
Hỗ trợ các bot/tool MMO hoặc Cron job gọi để xoay IP máy chủ/proxy tự động, tự động xóa cache Cloudflare sau khi đổi IP.
{
"record_name": "@", // hoặc "api", "proxy", "vpn"
"new_ip": "103.82.90.15", // hoặc để trống và truyền "rotate_pool": true để xoay ngẫu nhiên từ IP Pool
"proxied": true // Bật đám mây cam Cloudflare (Ẩn IP gốc & Chống DDoS)
}
Làm mới bộ nhớ đệm CDN Cloudflare ngay lập tức trên toàn cầu khi bạn vừa cập nhật mã nguồn hoặc thay đổi DNS.