Generate dynamic QR

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

Generates a dynamic QR code for a specific transaction, supporting one-time or recurring payments.

Usage

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',
);

Parameters

Field	Type	Required	Description
vaAccountNumber	string	✓	Virtual account (VA) number
qrCodeType	string	✓	dynamic-one-time-payment or dynamic-recurring-payment
bankBin	string	✓	Bank BIN. Use BankBinEnum
amount	number	✓	Payment amount
expireInMinute	number	✓	QR expiry time (minutes)
merchantId	number	✕	Merchant ID (required when calling via Master Merchant)
purpose	string	✕	Payment description
extraInfo	string	✕	Additional information

Response

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

Field	Type	Description
data.qrCode	string	QR content string
data.qrAccount	string	Receiving account number
data.billId	string	Bill ID in the Tingee system