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

Tổng doanh thu

0 VND

Đã đối soát tự động

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

Đã nhận đủ tiền

Đơn đang chờ (PENDING)

Đang chờ khách quét QR

Cổng ngân hàng khả dụng

Sẵn sàng nhận thanh toá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.

Cấu hình file: config/bank-accounts.json

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	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.