# 🪄 Quick Link

Nguồn HTML: https://www.vietqr.io/qr-dong
Bản Markdown này: https://www.vietqr.io/qr-dong.md

## Cú pháp Quick Link

Cú pháp đầy đủ của Quick Link bao gồm 6 thành phần.

`https://img.vietqr.io/image/<BANK_ID>-<ACCOUNT_NO>-<TEMPLATE>.svg?amount=<AMOUNT>&addInfo=<DESCRIPTION>&accountName=<ACCOUNT_NAME>`

Ví dụ:

[https://img.vietqr.io/image/vietinbank-113366668888-compact2.svg?amount=790000&addInfo=dong%20qop%20quy%20vac%20xin&accountName=Quy%20Vac%20Xin%20Covid](https://img.vietqr.io/image/vietinbank-113366668888-compact2.svg?amount=790000&addInfo=dong%20qop%20quy%20vac%20xin&accountName=Quy%20Vac%20Xin%20Covid)

## Live Demo

Demo tương tác: [Tạo mã QR](https://www.vietqr.io/qr-dong#live-demo).

Ví dụ Quick Link: `https://img.vietqr.io/image/vietinbank-113366668888-compact.svg`

## Quy ước chi tiết

### 1. `<BANK_ID>`

`<BANK_ID>` có thể là:

* Mã BIN ngân hàng, được [quy định bởi ngân hàng nhà nước](https://www.sbv.gov.vn/webcenter/portal/vi/menu/trangchu/ttvnq/htmtcqht?)
* Tên thường gọi phổ biến / tên viết tắt quy ước bởi NAPAS của ngân hàng

Ví dụ ngân hàng Vietinbank có mã BIN là `970415`, và thường được gọi là `Vietinbank` , Napas quy ước tên viết tắt là `ICB` thì chúng ta có thể sử dụng BANK\_ID là `970415` hoặc `Vietinbank` hoặc `ICB` đều được.

Tra cứu danh sách BIN(**bin**)/ tên thường gọi (**short_name**) / tên viết tắt (**code**) của các ngân hàng bằng  [API danh sách ngân hàng](/api-bank)

### 2. `<ACCOUNT_NO>`

Số tài khoản người nhận tại ngân hàng thụ hưởng.

Số tài khoản người nhận quy ước bao gồm chữ hoặc số, tối đa 19 kí tự.

Mục số tài khoản còn hỗ trợ **biệt danh tài khoản** (Alias Name) hoặc **Số tài khoản định danh** (Virtual Account Number)

### 3. `<TEMPLATE>`

`<TEMPLATE>` quy định ID của template. Template là hình thức trình bày của file ảnh chứa mã VietQR.

Các template của VietQR kế thừa từ 3 theme gốc là:

| Theme    | Size    | ý nghĩa                                            |
| -------- | ------- | -------------------------------------------------- |
| compact2 | 540x640 | Bao gồm : Mã QR, các logo , thông tin chuyển khoản |
| compact  | 540x540 | QR kèm logo VietQR, Napas, ngân hàng               |
| qr_only | 480x480 | Trả về ảnh QR đơn giản, chỉ bao gồm QR             |
| print | 600x776 | Bao gồm : Mã QR, các logo và đầy đủ thông tin chuyển khoản |
| loax | 2583×3719 | Bao gồm : Mã QR, các logo, thông tin chuyển khoản, cho sản phẩm Loa thanh toán, Loa thông báo chuyển khoản |

Để sử dụng Quick Link trong các dự án chính thức, bạn sẽ cần phải tạo một template mới cho riêng mình , kế thừa từ các theme gốc này

### 4. `<AMOUNT>`

`<AMOUNT>` quy định số tiền chuyển khoản

Số tiền chuyển khoản phải là một số dương và tối đa 13 chữ số.

### 5.  `<DESCRIPTION>`

`<DESCRIPTION>` quy định nội dung chuyển khoản.

Nội dung chuyển khoản bao gồm tối đa 50 chữ cái, không bao gồm các kí tự đặc biệt.

### 6. `<ACCOUNT_NAME>`

`<ACCOUNT_NAME>` quy định tên người thụ hưởng hiển thị lên file ảnh VietQR. Trường này không nằm trong tiêu chuẩn tạo mã VietQR.

## Cam kết dịch vụ

- **SLA:** 99.99% — Thời gian hoạt động
- **Giới hạn gọi:** 10 QR / 10 giây — Mỗi IP
- **Quy mô:** 19 triệu — Mã QR tạo mỗi ngày