Tạo QR động

API: POST /v1/bank/generate-dynamic-qr

Tạo mã QR động cho từng giao dịch cụ thể, hỗ trợ thanh toán một lần hoặc nhiều lần.

Cách sử dụng

Node.js

const result = await client.bank.generateDynamicQr({
  vaAccountNumber: 'V1T199988811',
  qrCodeType: 'dynamic-one-time-payment',
  bankBin: '970418',
  amount: 500000,
  expireInMinute: 30,
  purpose: 'Thanh toan hoa don HD001',
});

Java

var req = new OpenApiGenerateDynamicQrDto();
req.setVaAccountNumber("V1T199988811");
req.setQrCodeType("dynamic-one-time-payment");
req.setBankBin("970418");
req.setAmount(500000);
req.setExpireInMinute(30);
req.setPurpose("Thanh toan hoa don HD001");

var result = client.bank.generateDynamicQr(req);

C#

var result = await client.Bank.GenerateDynamicQrAsync(new OpenApiGenerateDynamicQrDto
{
    VaAccountNumber = "V1T199988811",
    QrCodeType = "dynamic-one-time-payment",
    BankBin = "970418",
    Amount = 500000,
    ExpireInMinute = 30,
    Purpose = "Thanh toan hoa don HD001",
});

PHP

$result = $client->bank->generateDynamicQr(
    vaAccountNumber: 'V1T199988811',
    qrCodeType: 'dynamic-one-time-payment',
    bankBin: '970418',
    amount: 500000,
    expireInMinute: 30,
    purpose: 'Thanh toan hoa don HD001',
);

Tham số đầu vào

Trường	Kiểu	Bắt buộc	Mô tả
vaAccountNumber	string	✓	Số tài khoản định danh (VA)
qrCodeType	string	✓	dynamic-one-time-payment hoặc dynamic-recurring-payment
bankBin	string	✓	Mã BIN ngân hàng. Dùng BankBinEnum
amount	number	✓	Số tiền thanh toán
expireInMinute	number	✓	Thời gian hết hạn QR (phút)
merchantId	number	✕	ID Merchant (bắt buộc nếu qua Master Merchant)
purpose	string	✕	Nội dung thanh toán
extraInfo	string	✕	Thông tin bổ sung

Response

{
  "code": "00",
  "message": "Success",
  "data": {
    "qrCode": "00020101021238540010A00000072701...",
    "qrAccount": "88880935926988",
    "billId": "QR_BILL_202507231420"
  }
}

Trường	Kiểu	Mô tả
data.qrCode	string	Chuỗi nội dung QR
data.qrAccount	string	Số tài khoản nhận tiền
data.billId	string	Mã hóa đơn trên hệ thống Tingee