Generate static QR

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

Generates a static QR code (VietQR) for a fixed bank account. Suitable for fixed payment points.

Usage

Node.js

const result = await client.bank.generateVietQr({
  bankBin: '970418',
  accountNumber: '21510002865945',
  amount: 100000,
  content: 'Thanh toan don hang',
});

Java

var req = new OpenApiGenerateVietQrDto();
req.setBankBin("970418");
req.setAccountNumber("21510002865945");
req.setAmount(100000);
req.setContent("Thanh toan don hang");

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

C#

var result = await client.Bank.GenerateVietQrAsync(new OpenApiGenerateVietQrDto
{
    BankBin = "970418",
    AccountNumber = "21510002865945",
    Amount = 100000,
    Content = "Thanh toan don hang",
});

PHP

$result = $client->bank->generateVietQr(
    bankBin: '970418',
    accountNumber: '21510002865945',
    amount: 100000,
    content: 'Thanh toan don hang',
);

Parameters

Field	Type	Required	Description
bankBin	string	✓	Bank BIN. Use BankBinEnum
accountNumber	string	✓	Receiving account number
merchantId	number	✕	Merchant ID (required when calling via Master Merchant)
amount	number	✕	Default amount shown when the QR is scanned
content	string	✕	Default transfer description

Response

{
  "code": "00",
  "message": "Success",
  "data": {
    "qrCode": "00020101021238540010A000000727...",
    "qrCodeImage": "data:image/png;base64,iVBORw0K..."
  }
}

Field	Type	Description
data.qrCode	string	QR content string
data.qrCodeImage	string	QR image in Base64