Payment Gateway Admin & API Docs - Quản lý Cổng Thanh toán & VietQR

Tổng số dư ngân hàng

0 VND

Dữ liệu thực tế

Tổng doanh thu

0 VND

Đã đối soát

Đơn thành công (PAID)

Đã nhận đủ tiền

Đơn đang chờ (PENDING)

Chờ khách quét QR

Cổng ngân hàng

Sẵn sàng nhận tiền

Quản lý Cổng Thanh toán & Tài khoản Ngân hàng

Tài khoản ngân hàng và thông tin đăng nhập được quản lý cố định qua file config/bank-accounts.json trên server. Đã khóa thêm/sửa qua Web để bảo mật tuyệt đối.

File: config/bank-accounts.json

Số dư thực tế theo từng Ngân hàng

Từng ngân hàng hiển thị số dư riêng biệt & đối soát trực tiếp

Mã Cổng (Code)	Tên Cổng / Tên hiển thị	Ngân hàng & Số tài khoản	Chủ tài khoản	Số dư thực tế	Mặc định	Nguồn cấu hình	Bảo mật	Trạng thái
Đang tải dữ liệu...

Danh sách Đơn hàng & Mã VietQR

Các đơn hàng được website đối tác gửi qua API `POST /api/v1/orders`.

Mã CK (Ref)	Mã đơn Website	Cổng nhận tiền	Số tiền	Trạng thái	Tạo lúc	Mã QR
Đang tải đơn hàng...

Lịch sử Biến động Số dư phát hiện từ Ngân hàng

Dữ liệu tiền vào được kéo tự động từ connector ngân hàng và đối soát với đơn hàng.

Mã GD (RefNo)	Số tiền	Nội dung chuyển khoản	Thời gian GD	Đối soát
Chưa có giao dịch nào được ghi nhận.

Quy Trình Tích Hợp Thanh Toán 2 Bước Tự Động

Dành cho các Website bán hàng, dịch vụ, game, khóa học. Chỉ cần tích hợp 2 API duy nhất:

Bước 1: Tạo đơn & Lấy VietQR

Website gọi POST /api/v1/orders, truyền số tiền và mã Cổng (vd: channelCode: "TK1" hoặc "TK2"). Nhận ngay ảnh QR VietQR để khách quét.

Bước 2: Tự Động Xử Lý & Check

Website kiểm tra trạng thái qua GET /api/v1/orders/:id/status hoặc nhận Webhook tự động ngay khi tiền vào tài khoản ngân hàng!

Công Cụ Thử Nghiệm API Trực Tiếp (Interactive Sandbox)

Bấm thử nghiệm tạo đơn thanh toán thật ngay trên hệ thống và quét mã VietQR thử!

X-Api-Key: pk_live_default_demo_key

Chọn Cổng thanh toán (Tài khoản nhận tiền)

Mã đơn hàng test (orderId)

Số tiền (VND)

Mô tả đơn hàng

Chưa có kết quả. Hãy bấm "Gọi API Tạo Đơn & Sinh VietQR" để chạy thử.

POST /api/v1/orders

Tạo đơn thanh toán, sinh VietQR & chọn Cổng

Headers yêu cầu:

X-Api-Key: your_merchant_api_key (Ví dụ: pk_live_default_demo_key)

Content-Type: application/json

Request Body (JSON):

{ "orderId": "DH_100234", // Bắt buộc: Mã đơn hàng duy nhất từ website bạn "amount": 250000, // Bắt buộc: Số tiền VND cần thanh toán "channelCode": "TK1", // Tùy chọn: Chọn Cổng "TK1" hoặc "TK2" (để trống sẽ chọn cổng mặc định) "description": "Thanh toan goi PRO", // Tùy chọn: Ghi chú "expiresIn": 15 // Tùy chọn: Số phút hết hạn đơn (mặc định: 30 phút) }

Response Trả Về (HTTP 201 Created):

{ "success": true, "data": { "id": "ord_1789109405649", "orderId": "DH_100234", "amount": 250000, "status": "PENDING", "paymentReference": "PAY12F37C2BOVUC", // Mã nội dung chuyển khoản bắt buộc "bankAccount": { "channelCode": "TK1", "channelName": "Cổng 1 - MB Bank Cá nhân", "bankCode": "MB", "accountNumber": "0123456789", "accountName": "NGUYEN VAN A", "bin": "970422" }, "qrPayload": "00020101021238540010A0000007270124000697042201100123456789...", "qrImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." // Gắn trực tiếp vào thẻ <img src="..."> } }

GET /api/v1/orders/:id/status

Kiểm tra trạng thái đơn hàng (Polling)

Hỗ trợ tra cứu bằng Mã đơn của Gateway (vd: ord_xxx) HOẶC Mã đơn trên Website bạn (vd: DH_100234) HOẶC Mã chuyển khoản (vd: PAY12F37C2BOVUC).

Response Khi Đã Thanh Toán Thành Công:

{ "success": true, "data": { "id": "ord_1789109405649", "orderId": "DH_100234", "status": "PAID", // Đã thanh toán xong! "paidAt": "2026-09-11T07:05:22.000Z", "expiresAt": "2026-09-11T07:15:00.000Z" } }

Đoạn Code JavaScript Polling Tự Động Kiểm Tra Trên Frontend:

// Tự động kiểm tra mỗi 3 giây sau khi khách mở trang thanh toán const orderId = 'DH_100234'; const checkInterval = setInterval(async () => { const res = await fetch(`/api/v1/orders/${orderId}/status`, { headers: { 'X-Api-Key': 'pk_live_default_demo_key' } }); const json = await res.json(); if (json.data && json.data.status === 'PAID') { clearInterval(checkInterval); alert('🎉 Thanh toán thành công! Đang chuyển hướng...'); window.location.href = '/order-success?orderId=' + orderId; } }, 3000);

GET /api/v1/banks

Lấy danh sách các Cổng thanh toán để hiển thị cho khách chọn

Gọi API này để lấy danh sách các Cổng ngân hàng đang bật (Tài khoản 1, Tài khoản 2...) và hiển thị lựa chọn cho khách hàng tại trang checkout.

Real-time Stream 0 Loa trực tuyến

Cấu Hình & Quản Lý Loa Thông Báo Thanh Toán (Soundbox)

Kết nối điện thoại Android hoặc Loa thông minh Android làm loa quầy thu ngân. Loa sẽ tự động phát chuông "Ting ting" và đọc to số tiền bằng tiếng Việt chuẩn khi có khách chuyển khoản.

Mã QR Ghép Đôi Nhanh

Dùng App Android để quét

Quét mã bằng App Loa Android

Tự động cấu hình Server URL & API Key chỉ trong 1 giây

Server URL

API Key (Merchant Key)

Luồng SSE Stream URL

GET /api/v1/soundbox/stream?apiKey=pk_live_default_demo_key

Bảng Thử Nghiệm Phát Âm Thanh (Test Loa)

Bắn tín hiệu tức thời

Chọn số tiền thử nghiệm

Hoặc tự nhập: VNĐ

Ngân hàng phát âm thanh

Nội dung / Tên đơn hàng

Nhật ký phát loa (Live Audio Log)

Chưa có giao dịch thử nghiệm nào. Bấm "Phát Ra Loa Android" để gửi tín hiệu.

Đăng Nhập Quản Trị