Chỉ đọc thẻ ID

Luồng ngắn khi bạn chỉ cần dữ liệu từ một thẻ ID (ID card) mà không cần xác minh danh tính — điền sẵn một biểu mẫu, đối chiếu với một hồ sơ đã có, hoặc số hóa giấy tờ.

Khi nào nên dùng

Thông tin	Mô tả
Phù hợp	Tự động điền biểu mẫu, số hóa hồ sơ giấy, đối chiếu với dữ liệu bạn đã có.
Không phù hợp	Mở tài khoản, hoặc bất kỳ thao tác nào phụ thuộc vào việc người cầm thẻ chính là chủ thẻ.

WARNING

Luồng này không xác minh danh tính. Nó chỉ đọc phần văn bản trên thẻ. Bất kỳ ai cầm thẻ của người khác đều vượt qua được. Khi bạn cần xác minh thật sự, dùng Onboard một khách hàng mới.

Luồng xử lý

1. Tải ảnh lên              (mặt trước, cộng mặt sau nếu cần)
2. Kiểm tra chất lượng thẻ  → dừng nếu verdict ≠ good
3. Đọc thông tin thẻ        → kiểm tra độ tin cậy từng trường
4. Chuẩn hóa và lưu trữ

Bước 1 — Tải lên

POST /v1/images

Dùng id_card.vn.national_id.front cho mặt trước. Mặt sau (...back) mang theo ngày cấp, nơi cấp và MRZ.

→ Tải ảnh lên

Bước 2 — Kiểm tra chất lượng

POST /v1/verify_id_card_sanity_sync

Bước này rẻ và ngăn OCR cho ra kết quả rác. Đừng bỏ qua nó ngay cả khi chỉ trích xuất dữ liệu — ánh sáng chói lóa trên số ID vẫn có thể cho ra một số sai nhưng vẫn mang confidence_score cao.

→ Xác minh ID Card Sanity

Bước 3 — Đọc thông tin thẻ

POST /v1/read_id_card_info_sync

Kết quả gộp từ ba nguồn: OCR trên bề mặt in, MRZ, và QR. Khi cùng một trường xuất hiện ở nhiều hơn một nguồn, hãy ưu tiên theo thứ tự sau:

1. QR   — được mã hóa khi cấp thẻ, không qua bất kỳ bước nhận dạng nào
2. MRZ  — đọc được bằng máy và được bảo vệ bằng checksum
3. OCR  — nhận dạng ảnh, dễ sai sót nhất

→ Đọc thông tin thẻ ID

Nếu bạn đã có sẵn chuỗi QR

Khi ứng dụng đã quét QR, gọi thẳng endpoint này — nhanh hơn và chính xác hơn OCR:

POST /v1/parse_qr_info_sync
{ "raw_qr": "001xxxxxxxxx|xxxxxxxxx|Nguyễn Văn A|12121990|Nam|Tổ 1, Phường Bến Nghé, Quận 1, TP. Hồ Chí Minh|01012021" }

Nó cũng phân tách địa chỉ thành bốn cấp hành chính cùng mã của từng cấp.

→ Phân tích thông tin QR

Bước 4 — Chuẩn hóa và lưu trữ

Chuẩn hóa trước khi lưu:

Thông tin	Mô tả
Ngày tháng	Chuyển hết về YYYY-MM-DD.
Tên	Viết hoa chữ cái đầu mỗi từ.
Địa chỉ	Viết hoa chữ cái đầu mỗi từ, tách thành bốn cấp hành chính.
Unicode	Chuẩn hóa NFC, loại bỏ khoảng trắng trùng lặp.

eID ghi lại cùng bộ trường này với một schema bảng được khuyến nghị; hãy hỏi CAKE Support nếu bạn cần lưu toàn bộ bản ghi CCCD thay vì chỉ vài trường.

Bước tiếp theo

• Phân tích thông tin QR — đọc trực tiếp từ chuỗi QR
• Onboard một khách hàng mới — khi bạn cần xác minh danh tính thật sự
• Định nghĩa kết luận — ý nghĩa của từng verdict chất lượng ảnh