# VietQR API — Tài liệu đầy đủ --- --- > Payment Kit cho mọi người --- > Tạo tự động từ https://www.vietqr.io lúc 2026-09-16T07:03:01.080Z --- --- # Changelog Nguồn: https://www.vietqr.io/changelog ## \[2.18] - 2026-07-31 #### Added - Deeplink MBBank hỗ trợ autofill: Tự động điền thông tin thanh toán khi bấm deeplink thanh toán bằng app MBBank. Cú pháp deeplink theo [tài liệu](/danh-sach-api/deeplink-app-ngan-hang#vietqr-deeplink-by-vietqrio) - Ví dụ: - Mở MBBank: [Thanh toán bằng MBBank](https://dl.vietqr.io/pay?app=mb&ba=22102025@icb&am=2000&tn=ck&bn=BAN%20VAN%20DONG%20CUU%20TRO%20TRUNG%20UONG&url=https://payos.vn) - Deeplink: https://dl.vietqr.io/pay?app=mb&ba=22102025@icb&am=2000&tn=ck&bn=BAN%20VAN%20DONG%20CUU%20TRO%20TRUNG%20UONG&url=https://payos.vn ## \[2.17] - 2026-02-13 #### Added - Deeplink VietinBank hỗ trợ autofill: Tự động điền thông tin thanh toán khi bấm deeplink thanh toán bằng app VietinBank iPay. Cú pháp deeplink theo [tài liệu](/danh-sach-api/deeplink-app-ngan-hang#vietqr-deeplink-by-vietqrio) - Ví dụ: - Mở VietinBank iPay: [Thanh toán bằng VietinBank iPay](https://dl.vietqr.io/pay?app=icb&ba=22102025@icb&am=2000&tn=ck&bn=BAN%20VAN%20DONG%20CUU%20TRO%20TRUNG%20UONG&url=https://payos.vn) - Deeplink: https://dl.vietqr.io/pay?app=icb&ba=22102025@icb&am=2000&tn=ck&bn=BAN%20VAN%20DONG%20CUU%20TRO%20TRUNG%20UONG&url=https://payos.vn ## \[2.16] - 2026-01-09 #### Added - Deeplink BIDV hỗ trợ autofill: Tự động điền thông tin thanh toán khi bấm deeplink thanh toán bằng app BIDV SmartBanking. Cú pháp deeplink theo [tài liệu](/danh-sach-api/deeplink-app-ngan-hang#vietqr-deeplink-by-vietqrio) - Ví dụ: - Mở BIDV SmartBanking: [Thanh toán bằng BIDV SmartBanking](https://dl.vietqr.io/pay?app=bidv&ba=22102025@icb&am=2000&tn=ck&bn=BAN%20VAN%20DONG%20CUU%20TRO%20TRUNG%20UONG&url=https://payos.vn) - Deeplink: https://dl.vietqr.io/pay?app=bidv&ba=22102025@icb&am=2000&tn=ck&bn=BAN%20VAN%20DONG%20CUU%20TRO%20TRUNG%20UONG&url=https://payos.vn ## \[2.15] - 2025-10-31 #### Added - Bổ sung 2 trường trong API deeplink: - `bn`: Tên tài khoản nhận tiền - `url`: Đường dẫn trở về ứng dụng của bạn khi thanh toán thành công - Deeplink ACB hỗ trợ autofill: Tự động điền thông tin thanh toán khi bấm deeplink thanh toán bằng app ACB ONE. Cú pháp deeplink theo [tài liệu](/danh-sach-api/deeplink-app-ngan-hang#vietqr-deeplink-by-vietqrio) - Ví dụ: - Mở ACB ONE: [Thanh toán bằng ACB ONE](https://dl.vietqr.io/pay?app=acb&ba=22102025@icb&am=2000&tn=ck&bn=BAN%20VAN%20DONG%20CUU%20TRO%20TRUNG%20UONG&url=https://payos.vn) - Deeplink: https://dl.vietqr.io/pay?app=acb&ba=22102025@icb&am=2000&tn=ck&bn=BAN%20VAN%20DONG%20CUU%20TRO%20TRUNG%20UONG&url=https://payos.vn ## \[2.14] - 2025-10-28 #### Added * API VietQR : Bổ sung Ví MoMo * API Lookup : Bổ sung Ví MoMo ## \[2.13] - 2025-06-06 #### Changed - Đổi tên Ocean Bank thành MBV: Ngân hàng TNHH MTV Việt Nam Hiện Đại - Đổi tên Đông Á Bank thành Vikki: Ngân hàng TNHH MTV Số Vikki - Đổi tên PGBank: Ngân hàng TMCP Thịnh vượng và Phát triển - Đổi tên MSB: Ngân hàng TMCP Hàng Hải Việt Nam ## \[2.12] - 2024-05-28 #### Added - Deeplink OCB hỗ trợ autofill: Tự động điền thông tin thanh toán khi bấm deeplink thanh toán bằng app OCB Omni. Cú pháp deeplink theo [tài liệu](/danh-sach-api/deeplink-app-ngan-hang#vietqr-deeplink-by-vietqrio) - Ví dụ: - Mở OCB Omni: [Thanh toán bằng OCB Omni](https://dl.vietqr.io/pay?app=ocb&ba=22102025@icb&am=2000&tn=ck) - Deeplink: https://dl.vietqr.io/pay?app=ocb&ba=22102025@vtb&am=2000&tn=ck ## \[2.11] - 2023-11-23 #### Changed - Chỉnh sửa tính năng tạo VietQR động và tĩnh theo tiêu chuẩn Napas: - Tạo QR động khi có thiết lập số tiền. #### Fixed - Sữa lỗi quét VietQR có khóa số tiền trên app VietcomBank. ## \[2.10] - 2023-06-29 #### Added - Thêm 5 ngân hàng mới : - Citibank: Ngân hàng Citibank, N.A. - Chi nhánh Hà Nội - KEBHanaHCM: Ngân hàng KEB Hana – Chi nhánh Thành phố Hồ Chí Minh - KEBHanaHN: Ngân hàng KEB Hana – Chi nhánh Hà Nội - MAFC: Công ty Tài chính TNHH MTV Mirae Asset (Việt Nam) - VBSP: Ngân hàng Chính sách Xã hội - Đổi tên của Viettel Money thành : Tổng Công ty Dịch vụ số Viettel - Chi nhánh tập đoàn công nghiệp viễn thông Quân Đội ## \[2.9] - 2023-03-03 #### Added * API VietQR: Bổ sung Timo ## \[2.8] - 2022-11-22 #### Added * API tra cứu thông tin doanh nghiệp bằng Mã số thuế * Tài liệu (beta) tạo Link thanh toán ## \[2.7] - 2022-10-11 #### Added * New Homepage ## \[2.6] - 2022-10-06 #### Added * API VietQR : Bổ sung Viettel Money, VNPT Money * API Lookup : Bổ sung Viettel Money, VNPT Money, Ngân hàng KBank, Ngân hàng CB ## \[2.5] - 2022-10-01 #### Added * Công cụ thiết kế chủ đề VietQR mới dành cho các nhà thiết kế (Beta launch) * Cải tiến engine render tối ưu tốc độ ## \[2.4] - 2022-08-28 #### Added * Deeplink thanh toán ngân hàng * API danh sách deeplink 36 ngân hàng Việt Nam ## \[2.3] - 2022-06-14 #### Added * Thêm 3 Banks : Cake , Ubank, Coop * Thêm field `lookupSupported` trong api `/banks` xác định một ngân hàng có đươc hỗ trợ bởi api `/lookup` hay không? ## \[2.2] - 2022-05-24 #### Added * API tra cứu số tài khoản (Beta) ## \[2.1] - 2022-01-18 #### Added * QuickLink 2.0 ## \[2.0] - 2021-12-24 #### Added * Công cụ tạo template VietQR tuỳ biến [https://my.vietqr.io](https://my.vietqr.io) * API tạo mã VietQR theo template tuỳ biến #### Changed * API Version 2 sẽ hoạt động dưới endpoint https://api.vieqr.io/v2 * Đổi tên field trong API `/generate` : `format` thành `template` * Template **vietqr\_net\_2** đổi tên thành **compact** **Removed** * Dừng hỗ trợ template **vietqr\_net** và **text**, Api version 1 vẫn tếp tục hỗ trợ 2 template này tới tháng 6/2022 ## \[1.1] - 2021-10-22 #### Added * Nội dung chuyển khoản hỗ trợ 40 kí tự (thay vì 25 ở V1) * Hỗ trợ số tài khoản biệt danh (Alias) : có thể nhập số. * Hỗ trợ #### Changed * Fix bug một số mã QR không thể quét được vì bị logo ở trung tâm che mất 1 phần thông tin * Cải tiến cơ chế và thuật toán tăng tốc API tạo mã QR lên gấp đôi. ## \[1.0] - 2021-06-26 Ra mắt phiên bản đầu tiên. --- # Bảng tính Nguồn: https://www.vietqr.io/cong-cu/bang-tinh Bạn có thể tạo QR hàng loạt bằng công cụ bảng tính như : Excel , Google Sheet, Air Table hoặc Autotable. 1. [Tạo mã VietQR trên Google Sheet](tao-ma-qr-bang-googe-sheet.md) 2. Tạo mã VietQR trên Excel _(Đang phát triển)_ 3. Tạo mã VietQR trên Airtable _(Đang phát triển)_ 4. Tạo mã VietQR trên Autotable _(Đang phát triển)_ --- # Tạo QR bằng Googe Sheet Nguồn: https://www.vietqr.io/cong-cu/bang-tinh/tao-ma-qr-bang-googe-sheet VietQR.IO cung cấp cơ chế tạo mã QR nhanh bằng link. Dựa trên cơ chế này, Chúng ta có thể tự động tạo mã QR động thay đổi theo nội dung các ô khác trong bảng Hàm [IMAGE(url) ](https://support.google.com/docs/answer/3093333?hl=en)trong Google Sheet sẽ hiển thị một hình ảnh dựa vào url cung cấp. Chúng ta có thể tạo Link ảnh QR bằng các nối các nội dung ngân hàng, số tài khoản, số tiền, nội dung chuyển với nhau. Sau đó truyền tham số này vào hàm IMAGE và chúng ta sẽ được QR code trên sheet. Link Demo [VietQR - Demo Tạo mã QR trong Google Sheet](https://docs.google.com/spreadsheets/d/1N36riNk5dMPGg\_ueN\_\_pG4iFL-qS\_1arftBueWEsS5c/edit#gid=449931516)  --- # Plugin tích hợp cổng thanh toán Nguồn: https://www.vietqr.io/cong-cu/cong-thanh-toan Một số nền tảng đã có giải pháp tích hợp VietQR xây dựng sẵn, bạn có thể sử dụng nhanh chóng 1. [Wordpress - Woocommerce](tich-hop-vietqr-vao-woocommerce.md) 2. [Haravan](tich-hop-vietqr-vao-haravan.md) 3. [Sapo](tich-hop-vietqr-vao-sapo.md) --- # Tích hợp VietQR vào Haravan Nguồn: https://www.vietqr.io/cong-cu/cong-thanh-toan/tich-hop-vietqr-vao-haravan ### Bước 1: Tạo phương thức thanh toán Vietqr Vào admin store haravan của bạn và thực hiện ![Tạo phương thức thanh toán mới]() ![]() {% hint style="info" %} Lưu ý: Khi đặt tên phương thức thanh toán phải chứa từ vietqr (Không phân biệt hoa thường) {% endhint %} ### Bước 2: Thực hiện thêm code vào trang thanh toán ``` ``` Sao chép code này và sửa lại theo thông tin của bạn ![]() Sau khi sửa xong thì vào trang thanh toán để thêm code vào ![]() Dán code vào mục xử lý đơn hàng và ấn lưu ![]() Kết quả sau khi thanh toán ![]() --- # Tích hợp VietQR vào Sapo Nguồn: https://www.vietqr.io/cong-cu/cong-thanh-toan/tich-hop-vietqr-vao-sapo ### Bước 1: Tạo phương thức thanh toán Vietqr Vào admin store Sapo của bạn và thực hiện ![]() ![Tạo ra phương thức thanh toán vietqr]() ### Bước 2: Thực hiện thêm code vào trang thanh toán ``` ``` Sao chép code này và sửa lại theo thông tin của bạn ![]() Sau khi sửa xong thì vào trang thanh toán để thêm code vào ![]() ![]() Kết quả sau khi thanh toán ![]() --- # Tích hợp VietQR vào Woocommerce Nguồn: https://www.vietqr.io/cong-cu/cong-thanh-toan/tich-hop-vietqr-vao-woocommerce ### Hướng dẫn cài đặt ### Demo giao diện thanh toán trên Desktop ![]() ### Demo thanh toán trên VietQR trên điện thoại ![]() --- # 🏦 API danh sách ngân hàng Nguồn: https://www.vietqr.io/danh-sach-api/api-danh-sach-ma-ngan-hang ## Công dụng Api trả về danh sách các ngân hàng mà VietQR hỗ trợ. Và từ đó lấy trích ra mã ngân hàng dùng trong Quick Link ## Đặc tả **GET** `https://api.vietqr.io/v2/banks` ## Sử dụng curl https://api.vietqr.io/v2/banks Cài đặt thư viện npm install vietqr Sử dụng let vietQR = new VietQR({ clientID: 'client_id_here', apiKey: 'api_key_here', }); // list banks are supported create QR code by Vietqr vietQR.getBanks().then((banks)=>{ console.log(banks); }).catch((err)=>{}); ## Kết quả trả về ```javascript { "code": "00", "desc": "Get Bank list successful! Total 55 banks", "data": [{ "id": 1, "name": "Ngân hàng TMCP An Bình", "code": "ABB", "bin": "970425", "shortName": "ABBANK", "logo": "https://api.vietqr.io/img/ABB.png", "transferSupported": 1, "lookupSupported": 1 }, { "id": 2, "name": "Ngân hàng TMCP Á Châu", "code": "ACB", "bin": "970416", "shortName": "ACB", "logo": "https://api.vietqr.io/img/ACB.png", "transferSupported": 1, "lookupSupported": 1 } //và 53 bank khác } ``` Mỗi ngân hàng sẽ có các thông số: | id | ID | 1 | | ----------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | name | Tên pháp nhân ngân hàng | Ngân hàng TMCP Đầu tư và Phát triển Việt Nam | | shortName | Tên ngắn gọn thường gọi | BIDV | | code | Tên mã ngân hàng | BIDV | | bin | Mã ngân hàng, **sử dụng mã này trong Quick Link** | 970418 | | logo | Đường dẫn tới logo ngân hàng | [https://api.vietqr.io/img/ICB.3d4d6760.png](https://api.vietqr.io/img/ICB.3d4d6760.png) | | transferSupported | App của Bank hỗ trợ chuyển tiền bằng cách quét mã VietQR | 0 hoặc 1 | | lookupSupported | Số tài khoản của Bank có thể tra cứu bằng[ API tra cứu số tài khoản](api-tra-cuu-so-tai-khoan.md) | 0 hoặc 1 | | ~~short\_name~~ |
Tương tự shortName
(sẽ bỏ field này ở v3)
Tương tự transferSupported
(sẽ bỏ field này ở v3)
Mức độ hỗ trợ VietQR của ngân hàng
(sẽ bỏ field này ở v3)
Định tài khoản nhận tiền.
Có dạng SO_TAI_KHOAN @ MA_NGAN_HANG, chứa thông tin số tài khoản và ngân hàng người nhận tiền
| | am | 790000 | Số tiền chuyển | | tn | Thanh toan DH123 | Nội dung chuyển tiền | | app | ocb | App ngân hàng ưu tiên dùng để thanh toán | | bn | NGUYEN VAN A | Tên tài khoản nhận tiền | | url | https://payos.vn | Đường dẫn trở về ứng dụng khi thanh toán thành công | ### VietQR Deeplink by VietQR.io Chúng tôi tin rằng để một tiêu chuẩn deeplink như trên được đưa vào thực tế sẽ còn cần nhiều thời gian, cần sự nỗ lực của nhiều bên, đặc biệt là từ các ngân hàng. Hiện tại, thông qua việc nghiên cứu hơn 44 app ngân hàng, chúng tôi ghi nhận khoảng 80% số app đã hỗ trợ deeplink với scheme riêng rẽ. Ví dụ, deeplink của mbbank là `mbbank://` , deeplink của Cake by VPbank là `cake.vn://` Với tình hình khả năng hiện tại, VietQR.io có thể xây dựng được một deeplink ở mức cơ bản là điều hướng người dùng mở app ngân hàng mà họ muốn dùng thanh toán, giảm được thao tác thủ công chuyển đổi giữa shop app qua bank app. Deeplink hiện tại sẽ có dạng như sau: ```html Thanh toán bằng VCB ``` Khi click vào link này, người dùng sẽ được điều hướng tới ứng dụng Vietcombank, nhưng hiện tại sẽ chưa thể tự động điền các thông tin người nhận tiền và số tiền vào app Vietcombank được. Bạn có thể sử dụng deeplink với đẩy đủ tham số, để trong tương lai, khi deeplink của chúng tôi hỗ trợ việc truyền các thông số này vào bank app thì bạn sẽ không phải thay đổi source code. ### API danh sách deeplink App ngân hàng Để lấy danh sách các deeplink của các app ngân hàng Việt Nam, bạn có thể sử dụng 2 API sau tương ứng với 2 hệ điều hành Android và iOS: * Danh sách deeplink của app Android [https://api.vietqr.io/v2/android-app-deeplinks](https://api.vietqr.io/v2/android-app-deeplinks) * Danh sách deeplink của app iOS [https://api.vietqr.io/v2/ios-app-deeplinks](https://api.vietqr.io/v2/ios-app-deeplinks) Cấu trúc dữ liệu trả về: ```json { "apps": [{ "appId": "mb", "appLogo": "https://is2-ssl.mzstatic.com/image/thumb/Purple122/v4/f4/0a/b6/f40ab6a2-e67d-e267-9c46-ae03dfa238a9/AppIcon-0-0-1x_U007emarketing-0-0-0-7-0-0-sRGB-0-0-0-GLES2_U002c0-512MB-85-220-0-0.png/1200x630wa.png", "appName": "MB Bank", "bankName": "Ngân hàng TMCP Quân đội", "monthlyInstall": 400000, "deeplink": "https://dl.vietqr.io/pay?app=mb" }, ... } ``` Trong đó: | Trường | Dữ liệu mẫu | Ý nghĩa | | -------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------- | | appId | mb | Mã app | | appLogo | https://... | Đường dẫn logo app | | appName | MB Bank | Tên app trên chợ ứng dụng | | bankName | Ngân hàng TMCP Quân đội | Tên ngân hàng | | monthlyInstall | 400000 |Lượt tải ứng dụng ước tính hàng tháng.
Số liệu từ SensorTower
> xinvoice.vn/mst →
>
---
# Hiện trạng VietQR
Nguồn: https://www.vietqr.io/hien-trang-vietqr
#### Không thể quét được mã QR trên App Techcombank.
App Techcombank Mobile mới đã hỗ trợ quét mã VietQR
Tuy nhiên app cũ, Techcombank F@st i-bank hiện đang trong quá trình chờ đóng cửa khi người dùng chuyển qua app mới, nên sẽ không hỗ trợ VietQR
#### Quét bằng App MBBank không điền nội dung
Khi quét từ nút bấm scan QR ở màn hình chính (trước khi đăng nhập) thì MBBank có điền nội dung. Tuy nhiên, khi bấm nút Scan ở màn hình chuyển tiền thì MBBank chỉ điền STK và ngân hàng, không điền nội dung và số tiền
---
# Bắt đầu
Nguồn: https://www.vietqr.io/intro
### TẠO MÃ VIETQR CỦA BẠN
### 1. Cú pháp Quick Link
`https://img.vietqr.io/image/