# Thông báo cập nhật VietQR Payment Kit

Nguồn HTML: https://www.vietqr.io/thong-bao-cap-nhat
Bản Markdown này: https://www.vietqr.io/thong-bao-cap-nhat.md

Nhóm phát triển **VietQR Payment Kit** thông báo một số thay đổi trong phiên bản cập nhật được tung vào **12:00 trưa ngày 14/10/2026**. Các thay đổi này nhằm tối ưu hiệu năng và giữ dịch vụ ổn định, bền vững trong dài hạn.

**VietQR vẫn hoạt động bình thường**

Chỉ riêng endpoint **`/v2/generate`** ngừng hỗ trợ từ **01/01/2027**. Quicklink, Portal và các API khác của VietQR vẫn hoạt động bình thường.

## Các thay đổi chính

### Quicklink (`img.vietqr.io`)

Quicklink chuyển sang engine render mã QR theo hướng SVG-first và kiến trúc serverless.

SVG là tuỳ chọn được khuyến khích. PNG và JPEG sẽ có kế hoạch ngừng hỗ trợ trong năm sau.

### API Generate (`api.vietqr.io/v2/generate`)

Chỉ riêng endpoint `/v2/generate` ngừng hỗ trợ từ 01/01/2027. Các dịch vụ khác của VietQR không bị ảnh hưởng. Để tạo mã QR, hãy chuyển sang thư viện [`vietqr`](https://www.npmjs.com/package/vietqr) (bản 1.2.0 trở lên) để tạo mã trực tiếp trên hệ thống của bạn, không phụ thuộc vào API.

```bash
npm install vietqr
```

Dự án đang dùng `vietqr` bản cũ chỉ cần nâng cấp lên bản mới, không phải sửa code: `genQRCodeBase64()` tạo mã QR offline và trả về đúng định dạng như trước. Xem hướng dẫn tại [API tạo mã QR](/generate).

### Custom Theme/ Template trên Portal (`my.vietqr.io`)

Portal ngừng tiếp nhận yêu cầu tạo Custom Theme / Template mới. Các mẫu QR tùy chỉnh đã tạo trước đó vẫn được giữ và tiếp tục render.

## Chính sách tương thích ngược

Các tích hợp đang chạy vẫn được duy trì trong giai đoạn chuyển đổi:

| Hạng mục | Cách xử lý |
| --- | --- |
| API `/v2/generate` | Tiếp tục hoạt động đến hết ngày 31/12/2026. Sau thời hạn này, chuyển sang thư viện `vietqr` (`npm install vietqr`) để tạo mã QR offline. |
| Quicklink PNG/JPEG | SVG là tuỳ chọn được khuyến khích. PNG và JPEG vẫn được phục vụ, và sẽ có kế hoạch ngừng hỗ trợ trong năm sau. |
| Custom Theme / Template hiện có | Template đã tạo vẫn được hỗ trợ. Custom theme sẽ fallback về theme gốc|

## Lợi ích của bản cập nhật

Tốc độ tạo mã QR cải thiện lên đến **5 lần**, từ khoảng 500 ms xuống còn 100 ms.

Engine render SVG-first trên kiến trúc serverless giúp nâng hiệu suất và giữ chất lượng dịch vụ ổn định trong nhiều năm tới.

Nên rà soát các tích hợp hiện tại và lên kế hoạch chuyển đổi khỏi `/v2/generate` trước ngày 31/12/2026 để hệ thống tiếp tục chạy ổn định.

Nếu cần hỗ trợ trong quá trình chuyển đổi, hãy liên hệ nhóm phát triển VietQR Payment Kit.

**Nhóm phát triển VietQR Payment Kit**
