Thông báo cập nhật VietQR Payment Kit
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.
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)
API Generate sẽ ngừng hỗ trợ từ 1/1/2027. Hãy chuyển sang thư viện vietqr-core để tạo mã QR trực tiếp trên hệ thống của bạn, không phụ thuộc vào API.
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 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-core để 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 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