Hỏi đáp (FAQ)

Có, @viet-qr là một thư viện mã nguồn mở theo giấy phép MIT. Bạn có thể sử dụng miễn phí cho cả dự án cá nhân lẫn thương mại theo các điều khoản của giấy phép MIT.

Hoàn toàn không. Toàn bộ quá trình tạo mã QR diễn ra cục bộ ngay trên trình duyệt của người dùng. Chúng tôi không theo dõi, lưu trữ hay truyền bất kỳ thông tin thanh toán nào về máy chủ — vì chúng tôi không có máy chủ nào để làm việc đó.

Không. Thuật toán tạo mã QR và tra cứu mã ngân hàng (Bank BINs) được thực thi hoàn toàn offline (độ phức tạp O(1)) ngay trên trình duyệt (client-side). Không có bất kỳ API call nào được gọi ra ngoài.

Zero dependencies áp dụng cho @viet-qr/core: phần tạo chuỗi EMVCo, kiểm tra CRC16 và tra cứu ngân hàng được xây dựng bằng TypeScript. Các gói hiển thị QR có dependency riêng; bạn có thể chỉ dùng core nếu không cần UI.

Thư viện tích hợp sẵn danh mục BIN ngân hàng đi kèm, cho phép bạn truyền vào tên viết tắt (VD: VCB, TCB) và tự động ánh xạ ra mã BIN chính xác với thời gian truy xuất O(1). Dữ liệu này được cập nhật theo mỗi bản phát hành mới; nếu cần danh sách mới nhất theo thời gian thực, bạn có thể dùng hàm fetchBankList() để tải về từ bất kỳ API hoặc CDN nào.

Mã QR được tạo theo tiêu chuẩn EMVCo và NAPAS 247, được thiết kế để quét bằng ứng dụng ngân hàng hỗ trợ VietQR. Bạn nên kiểm tra với ứng dụng ngân hàng mục tiêu trước khi triển khai.

Hiện tại, hệ sinh thái được tối ưu cho nền tảng Web (React, Vue, Svelte, Vanilla JS). Tuy nhiên, vì core là thuần TypeScript, bạn hoàn toàn có thể dùng @viet-qr/core để tạo chuỗi dữ liệu (payload string) và truyền vào một component QR Code bất kỳ của React Native.

Payload chấp nhận số tiền nguyên không âm, tối đa 13 chữ số. Hạn mức chuyển khoản thực tế do ứng dụng ngân hàng và chính sách của ngân hàng quyết định.

Với @viet-qr, bạn có thể sinh mã QR Động (Dynamic QR) theo từng đơn hàng. Mã QR sinh ra đã đính kèm sẵn Số tiền (Amount) và Nội dung chuyển khoản (Message). Khách hàng chỉ việc quét và xác nhận, giảm thao tác nhập lại. Người chuyển vẫn cần kiểm tra thông tin trước khi xác nhận.

Hoàn toàn có. Các framework wrappers (React, Vue, Svelte, Vanilla) đi kèm sẵn các template dựng sẵn như CompactCard và PayStandee, giúp bạn dễ dàng tuỳ chỉnh màu sắc, kích thước và chèn logo để phù hợp với Brand Guideline của doanh nghiệp.

Không. @viet-qr chỉ chịu trách nhiệm sinh mã QR chuẩn xác ở phía Frontend. Để kiểm tra biến động số dư và trạng thái thanh toán, bạn cần tích hợp Webhook hoặc API từ Ngân hàng (hoặc các bên thứ ba như PayOS, SePay) ở phía Backend.