Chọn phương thức tích hợp
eKYC có ba hướng tích hợp. Hãy chọn một trước khi viết code — chuyển đổi sau này sẽ tốn kém.
So sánh nhanh
| Thông tin | Mô tả |
|---|---|
| API | Bạn tự xây giao diện chụp ảnh. Backend của bạn gọi API trực tiếp. Kiểm soát nhiều nhất, khối lượng công việc nhiều nhất. |
| Mobile SDK | SDK xử lý việc chụp ảnh, kiểm tra chất lượng ngay trên thiết bị và các lệnh gọi API. Android, iOS, Flutter. |
| Web SDK | Tương tự, chạy trên trình duyệt. Cũng hoạt động trong WebView. |
Chọn cái nào
| Thông tin | Mô tả |
|---|---|
| Ứng dụng Android hoặc iOS native | Mobile SDK. Tự động chụp ảnh và kiểm tra chất lượng ngay trên thiết bị giúp giảm số lần chụp lại. |
| Ứng dụng Flutter | Mobile SDK (Flutter). Đây cũng là nền tảng duy nhất có đầy đủ khả năng tùy biến giao diện trên cả năm màn hình. |
| Web hoặc WebView | Web SDK. Yêu cầu HTTPS và quyền camera. |
| Server-to-server | API. Phù hợp khi ảnh đến từ nơi khác — một quầy giao dịch chi nhánh, file đã quét sẵn, hoặc một hệ thống cũ. |
| Bạn đã có sẵn màn hình chụp ảnh | API. Một SDK sẽ xung đột với giao diện hiện có của bạn. |
Những khác biệt quan trọng
Kiểm tra chất lượng ngay trên thiết bị. Mobile SDK và Web SDK chạy các model kiểm tra chất lượng ngay trên thiết bị trước khi tải lên, nên người dùng thấy thông báo "quá mờ" ngay khi vẫn đang cầm thẻ. Với API, mỗi phản hồi đều tốn một vòng round trip mạng.
An toàn cho khóa. Access Key chỉ nên nằm trên backend của bạn, không ở đâu khác. Các SDK xác thực bằng một JWT riêng cho từng giao dịch, được cấp bởi Tạo giao dịch. Dù chọn hướng nào, backend của bạn vẫn nằm trong luồng xử lý.
Tùy biến giao diện. Flutter cung cấp nhiều nhất — năm màn hình, theme sáng và tối, font tùy chỉnh. Android và iOS chỉ cho phép thay thế giao diện loading. Web SDK cho phép bạn chèn view riêng ở cấp độ kiến trúc.
INFO
Các hướng này không loại trừ lẫn nhau. Một mẫu hình phổ biến: Mobile SDK xử lý việc chụp ảnh và kiểm tra chất lượng, trong khi backend của bạn gọi trực tiếp Tìm kiếm khuôn mặt để phát hiện trùng lặp — điều mà không SDK nào tự làm cho bạn.
Bước tiếp theo
- Bắt đầu nhanh — thử với cURL trước khi quyết định
- Tổng quan Mobile SDK — các khái niệm dùng chung giữa ba nền tảng
- Tổng quan Web SDK — yêu cầu môi trường và cách đóng gói