Tạo QR tĩnh

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

Tạo mã QR tĩnh (VietQR) cho tài khoản ngân hàng cố định. Phù hợp điểm thanh toán cố định.

Cách sử dụng

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

Tham số đầu vào

Trường	Kiểu	Bắt buộc	Mô tả
bankBin	string	✓	Mã BIN ngân hàng. Dùng BankBinEnum
accountNumber	string	✓	Số tài khoản nhận tiền
merchantId	number	✕	ID Merchant (bắt buộc nếu qua Master Merchant)
amount	number	✕	Số tiền mặc định hiển thị khi quét
content	string	✕	Nội dung chuyển khoản mặc định

Response

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

Trường	Kiểu	Mô tả
data.qrCode	string	Chuỗi nội dung QR
data.qrCodeImage	string	Ảnh QR dạng Base64