Kiến trúc hệ sinh thái Casso

So sánh Casso Open Platform và VietQR.io

VietQR.io và Casso Open Platform phục vụ hai bài toán bổ trợ cho nhau trong cùng hệ sinh thái Casso. Bảng dưới đây giúp bạn chọn đúng API cho nhu cầu thanh toán QR hoặc tích hợp dữ liệu doanh nghiệp / tài chính.

Bảng so sánh chi tiết

Tiêu chíVietQR.io (Payment Kit)Casso Open Platform (open.casso.vn)
Định vị sản phẩmHệ 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 ListThư 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ựcKhô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 AgentTà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.

Khi nào dùng VietQR.io?

  • Cần tạo mã QR chuyển khoản VietQR offline bằng thư viện vietqr hoặc Quicklink SVG.
  • Lấy danh sách mã BIN và thông tin ngân hàng Việt Nam công khai qua api.vietqr.io/v2/banks.
  • Đang bảo trì hệ thống cũ đã tích hợp /v2/business hoặc /v2/lookup trước thời điểm chuyển đổi.

Khi nào dùng Casso Open Platform?

  • Xây dựng tính năng mới tra cứu MST doanh nghiệp, ngành nghề VSIC, hộ kinh doanh (IDKit).
  • Tra cứu tên chủ tài khoản ngân hàng kết hợp chuyển tiền Payout (PayKit) hoặc Deeplink ngân hàng.
  • Muốn quản lý tập trung qua OAuth2 JWT, phân quyền scope cho từng App và sử dụng AI Agent / MCP.

Câu hỏi thường gặp

VietQR.io và Casso Open Platform có phải cùng một đơn vị phát triển không?

Có. Cả VietQR.io và Casso Open Platform (open.casso.vn) đều được phát triển và vận hành bởi Casso. VietQR.io tập trung vào chuẩn QR thanh toán và Payment Kit, còn Casso Open Platform là lớp hạ tầng API hợp nhất cho kế toán, doanh nghiệp và AI Agent.

Tôi đang dùng API tạo mã QR hoặc danh sách ngân hàng của VietQR.io có cần chuyển không?

Danh sách ngân hàng công khai (GET api.vietqr.io/v2/banks) và thư viện tạo mã QR offline (vietqr) vẫn hoạt động bình thường trên VietQR.io. Chỉ các API tra cứu MST (/v2/business) và tra cứu số tài khoản (/v2/lookup) có lộ trình chuyển sang Casso Open Platform để đồng bộ bảo mật OAuth2 và mở rộng dữ liệu.

Tích hợp mới tra cứu mã số thuế thì nên chọn VietQR.io hay Casso Open Platform?

Với tích hợp mới, nên dùng trực tiếp Casso Open Platform (IDKit: /idkit/v1/business/{taxCode}) để nhận đầy đủ dữ liệu ngành nghề VSIC, hộ kinh doanh 12 số, chuẩn bảo mật JWT và được hưởng hạn mức miễn phí (1k lượt cho cá nhân/HKD, 5k lượt cho doanh nghiệp đã xác thực — dùng hết không hồi theo tháng).

Bắt đầu với Casso Open Platform

Chạy ngay API tra cứu MST bằng Public Starter Key không cần đăng ký, hoặc tạo Private App Key miễn phí trên Developer Console.