Đến nội dung
BankGatewayBankGateway
Console ↗
↑ ↓ Điều hướng↵ ChọnEsc Đóng
Mục lục tài liệu:Tạo đơn thanh toán QR ▾
Tài liệu›Cổng Thanh Toán (Checkout)›Tạo đơn thanh toán QR
Phiên bản:v1.0.5 (Chính thức)

Khởi tạo phiên thanh toán QR Hosted và nhận đường dẫn checkoutUrl (payment.bankgateway.pro/pay/pay_xxx).

POST/api/v1/payment-gateway/checkoutHeader: X-API-Key

Tham số Body (JSON)

TrườngKiểuBắt buộcMô tả
merchantIdstringCóMã định danh cửa hàng (VD: BGW_A1B2C3D4).
orderIdstringCóMã đơn hàng duy nhất trên hệ thống của bạn (1-64 ký tự).
amountnumberCóSố tiền VND nguyên dương (2.000 – 500.000.000).
timestampnumberCóUnix timestamp tính bằng mili-giây (Date.now()). Chênh lệch tối đa ±5 phút.
signaturestringCóHMAC-SHA256 hex của chuỗi "${merchantId}|${orderId}|${amount}|${timestamp}" với Secret Key.
descriptionstringKhôngMô tả đơn hàng hiển thị cho người mua.
returnUrlstringKhôngGhi đè Return URL mặc định khi thanh toán thành công.
cancelUrlstringKhôngGhi đè Cancel URL mặc định khi người mua bấm Hủy.
webhookUrlstringKhôngGhi đè Webhook URL mặc định (chặn IP nội bộ chống SSRF).

Code mẫu tạo đơn (Node.js / PHP / Python)

import crypto from "node:crypto";

const merchantId = process.env.BGW_MERCHANT_ID;
const secretKey = process.env.BGW_SECRET_KEY;
const orderId = "DH_10001";
const amount = 50000;
const timestamp = Date.now();

const signature = crypto
  .createHmac("sha256", secretKey)
  .update(`${merchantId}|${orderId}|${amount}|${timestamp}`)
  .digest("hex");

const res = await fetch("https://api.bankgateway.pro/api/v1/payment-gateway/checkout", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ merchantId, orderId, amount, timestamp, signature })
});
const json = await res.json();
// Redirect khách sang json.data.checkoutUrl
Tài liệu phát hành theo chuẩn OpenBanking 2.0 · Cập nhật v1.0.5 (Chính thức)Góp ý tài liệu & Báo lỗi ↗