Tài liệu này cung cấp chi tiết kỹ thuật chuyên sâu về cấu trúc chuỗi Mã QR chuẩn EMVCo Merchant-Presented áp dụng cho mạng lưới Chuyển Nhanh NAPAS 247 (VietQR) của các ngân hàng Việt Nam.
Chuỗi mã thanh toán VietQR tuân thủ nghiêm ngặt chuẩn quốc tế EMVCo QR Code Specification for Payment Systems (Merchant-Presented Mode). Dữ liệu được mã hóa liên tục dưới dạng các trường Tag-Length-Value (TLV):
[Tag: 2 chữ số][Length: 2 chữ số][Value: chuỗi nội dung]
00 đến 99.01 đến 99) biểu thị số lượng byte/ký tự của Value.63 có độ dài 04, chứa mã CRC16-CCITT tính toán trên toàn bộ chuỗi đứng trước nó (bao gồm cả chuỗi tiền tố 6304).| Tag | Tên Trường | Kiểu Dữ Liệu | Bắt Buộc / Tuỳ Chọn | Ý Nghĩa Kỹ Thuật |
|---|---|---|---|---|
| 00 | Payload Format Indicator | Chuỗi (2) | Bắt buộc | Luôn cố định là 01 (phiên bản EMVCo QR 1.0). |
| 01 | Point of Initiation Method | Chuỗi (2) | Bắt buộc | 11 = QR Tĩnh (dùng nhiều lần, không gắn số tiền cố định), 12 = QR Động (giao dịch một lần, gắn số tiền). |
| 38 | Merchant Account Information | Sub-TLV | Bắt buộc | Định danh ngân hàng thụ hưởng và số tài khoản/thẻ theo chuẩn NAPAS 247. |
| 53 | Transaction Currency Code | Chuỗi (3) | Bắt buộc | Mã tiền tệ ISO 4217: 704 (Đồng Việt Nam - VND). |
| 54 | Transaction Amount | Chuỗi số | Tuỳ chọn | Số tiền giao dịch (ví dụ: 50000, 1500000). Bỏ qua nếu là mã QR tĩnh mở. |
| 58 | Country Code | Chuỗi (2) | Bắt buộc | Mã quốc gia ISO 3166-1 alpha-2: VN. |
| 59 | Merchant Name | Chuỗi | Tuỳ chọn | Tên người thụ hưởng (viết hoa không dấu, ví dụ: NGUYEN VAN A). |
| 60 | Merchant City | Chuỗi | Tuỳ chọn | Thành phố của điểm chấp nhận thanh toán (ví dụ: HANOI, HCM). |
| 62 | Additional Data Field Template | Sub-TLV | Tuỳ chọn | Chứa nội dung chuyển tiền, số hóa đơn, số điện thoại, mã tham chiếu. |
| 63 | CRC16 Checksum | Hex (4) | Bắt buộc | Mã kiểm tra toàn vẹn 4 ký tự thập lục phân viết hoa. |
Tag 38 là một cụm Sub-TLV lồng nhau chứa thông tin định tuyến liên ngân hàng NAPAS 247:
38 [Len]
00 10 A000000727 (NAPAS AID - Globally Unique Identifier)
01 [Len]
00 06 [Mã BIN Ngân Hàng] (Mã BIN 6 số của ngân hàng thụ hưởng)
01 [Len] [Số Tài Khoản/Thẻ] (Số tài khoản hoặc số thẻ thụ hưởng)
02 08 [Mã Dịch Vụ] (QRIBFTTA hoặc QRIBFTTC)
| Sub-Tag | Tên Trường | Định Dạng | Mô Tả |
|---|---|---|---|
| 00 | GUID | A000000727 (Độ dài 10) |
Mã định danh toàn cầu duy nhất của cổng NAPAS. |
| 01 | Payment Network Specific | Sub-TLV lồng: | Thông tin chi tiết điểm nhận tiền: |
| ↳ 00 | Mã BIN Ngân Hàng | 6 chữ số (ví dụ: 970422 MB, 970436 VCB) |
Mã ngân hàng thụ hưởng định danh theo chuẩn NAPAS. |
| ↳ 01 | Số Tài Khoản / Thẻ | Chuỗi ký tự số (tối đa 19 ký tự) | Số tài khoản ngân hàng hoặc số thẻ thanh toán. |
| 02 | Mã Dịch Vụ (Service Code) | 8 ký tự | • QRIBFTTA: Chuyển nhanh đến Tài khoản ngân hàng.• QRIBFTTC: Chuyển nhanh đến Số thẻ (Card Number). |
Tag 62 chứa các thông tin phụ trợ phục vụ đối soát và gạch nợ tự động:
| Sub-Tag | Tên Trường | Ý Nghĩa | Ví Dụ |
|---|---|---|---|
| 01 | Bill Number | Số hóa đơn / Mã phiếu thu | INV-2025-001 |
| 02 | Mobile Number | Số điện thoại khách hàng | 0901234567 |
| 03 | Store Label | Mã cửa hàng / Điểm bán | STORE01 |
| 05 | Reference Label | Mã tham chiếu đối soát tự động | REF889911 |
| 07 | Terminal Label | Mã máy POS / Thiết bị thanh toán | POS-01 |
| 08 | Purpose / Memo | Nội dung chuyển khoản hiển thị trên app ngân hàng | HB1042 thanh toan hosting |
Chuẩn EMVCo quy định bắt buộc sử dụng thuật toán CRC16-CCITT-FALSE:
0x1021 ($x^{16} + x^{12} + x^5 + 1$)0xFFFFfalsefalse0x00000002010102123854...62180814DON HANG 1042
6304 vào cuối chuỗi:
0002010102123854...62180814DON HANG 10426304
0 ở đầu nếu nhỏ hơn 4 chữ số, ví dụ: 7B9F).0002010102123854...62180814DON HANG 104263047B9F
Các bước kiểm tra và bóc tách dữ liệu từ một chuỗi VietQR bất kỳ:
000201 + 6304xxxx).expected_crc.expected_crc. Nếu không khớp, trả về lỗi mã QR bị sai lệch.L.Value có độ dài L.38, tiếp tục phân tích đệ quy Sub-Tag 00, 01 (và tiếp tục tách 00, 01 bên trong), 02.62, tiếp tục phân tích các Sub-Tag từ 01 đến 08.54, tên người thụ hưởng tại Tag 59.