| Định vị sản phẩm | Hệ sinh thái API thanh toán Payment Kit (QR động, danh sách ngân hàng, deeplink mở app ngân hàng). | Nền tảng API tài chính – kế toán hợp nhất (IDKit tra cứu MST, PayKit, Deeplink, Transactions, GDT Invoice). |
| API tra cứu mã số thuế (MST) | Endpoint cũ GET api.vietqr.io/v2/business/{taxCode} ĐÃ NGỪNG HỖ TRỢ (DEPRECATED) tích hợp mới (ngắt hoàn toàn 31/12/2026). Mọi dự án hiện tại BẮT BUỘC dùng Casso Open Platform. | IDKit: tra cứu doanh nghiệp, chi nhánh (10-3 số), ngành nghề kinh doanh (VSIC) và hộ kinh doanh (12 số). Miễn phí 1k lượt (cá nhân/HKD) & 5k lượt (doanh nghiệp) — dùng hết không hồi theo tháng. |
| API tra cứu số tài khoản (STK) | Endpoint cũ POST api.vietqr.io/v2/lookup ĐÃ NGỪNG HỖ TRỢ (DEPRECATED) tích hợp mới (ngắt hoàn toàn 31/12/2026). Mọi dự án hiện tại BẮT BUỘC dùng Casso Open Platform. | PayKit: tra cứu tên chủ tài khoản qua NAPAS/VietQR đi kèm bộ API Payout chuyển tiền. |
| Tạo mã QR / Deeplink / Bank List | Thư viện tạo QR offline (npm install vietqr), Quicklink SVG, danh sách ngân hàng công khai GET api.vietqr.io/v2/banks. | API Deeplink mở app ngân hàng điền sẵn thông tin chuyển khoản, theo dõi trạng thái qua Developer Console. |
| Cơ chế xác thực | Không cần key cho API banks công khai; hoặc x-client-id / x-api-key ở các API cũ. | Chuẩn OAuth2 Client Credentials: đổi app_id + app_secret lấy JWT RS256 (sống ~15 phút), dùng chung 1 credential cho mọi API với phân quyền theo scope. |
| Thử nghiệm & AI Agent | Tài liệu Markdown (.md), llms.txt và OpenAPI spec. | Playground gọi thử trực tiếp trên trình duyệt, Public Starter Key chạy ngay dữ liệu thật với curl, code mẫu 18 ngôn ngữ, prompt chuẩn cho AI Agent, llms.txt & OpenAPI spec. |