Tạo mã QR (VietQR)

Sinh mã VietQR động để khách hàng quét và chuyển khoản. Endpoint trả về trực tiếp ảnh PNG, nên bạn có thể nhúng thẳng vào thẻ <img> mà không cần gọi API rồi tự vẽ QR.

GET /img-qr

• Xác thực: không cần — endpoint công khai.
• Trả về: ảnh (image/png). Có gắn header Access-Control-Allow-Origin: * nên dùng được từ trình duyệt.
• Mã QR sinh theo chuẩn VietQR / Napas 247 (dịch vụ chuyển nhanh QRIBFTTA).

Lưu ý: endpoint này nằm ở gốc https://app.qh2pay.com/img-qr (không có tiền tố /api).

#Tham số truy vấn

Tham số	Bắt buộc	Mô tả
bank_code		Mã ngân hàng thụ hưởng (ví dụ BIDV, MB). Lấy từ Danh sách ngân hàng.
account_no		Số tài khoản thụ hưởng.
account_name	—	Tên chủ tài khoản (hiển thị trên khung ảnh).
amount	—	Số tiền (VND). Chỉ áp dụng khi nằm trong khoảng 1.000 – 9.999.999.999.999.
memo	—	Nội dung chuyển khoản. Tối đa 25 ký tự (vượt quá sẽ bị bỏ qua).
template	—	default = ảnh có khung (mặc định) · only-qr = chỉ mã QR, không khung.
is_mask	—	1 = che bớt số tài khoản trên ảnh có khung (bảo mật hiển thị).

#Ví dụ

Nhúng trực tiếp vào HTML

<img
  src="https://app.qh2pay.com/img-qr?bank_code=BIDV&account_no=96247100868&amount=150000&memo=DH12345"
  alt="Quét QR để thanh toán"
  width="320"
/>

URL đầy đủ các tham số

https://app.qh2pay.com/img-qr?bank_code=BIDV&account_no=96247100868&account_name=NGUYEN VAN A&amount=150000&memo=DH12345&template=default&is_mask=1

Chỉ lấy mã QR (không khung)

https://app.qh2pay.com/img-qr?bank_code=BIDV&account_no=96247100868&amount=150000&memo=DH12345&template=only-qr

#Xử lý lỗi

Endpoint trả về văn bản (không phải ảnh) khi thiếu/sai tham số bắt buộc:

Tình huống	Trả về
bank_code không hợp lệ / không tồn tại	Vui lòng nhập đúng mã ngân hàng
Thiếu account_no	Vui lòng nhập số tài khoản

Gợi ý cho luồng thanh toán: đặt memo là một mã đơn hàng duy nhất (ví dụ DH12345). Khi khách chuyển khoản, QHTech sẽ đẩy giao dịch kèm nội dung này về Webhook của bạn — nhờ đó bạn khớp đúng đơn hàng và xác nhận thanh toán tự động.