scanNFC

Cập nhật lần cuối: 25/10/2024

Bắt đầu hỗ trợ ở phiên bản:

• SDK: 2.41.0

Lưu ý

Cần xin cấp quyền tại trang Quản lý ứng dụng

Thực hiện quét NFC trên android và ios. Hiện sdk hỗ trợ quét thông tin từ thẻ căn cước công dân.

Parameters

Object object

Property	Type	Default	Required	Description	Minimum Version
type	string		true	Nhận các giá trị sau: 'cccd': Căn cước công dân
data	object		true	thông tin cần để xác thực với thẻ
success	function			Callback function khi gọi api thành công
fail	function			Callback function khi gọi api thất bại

Object data

Căn cước công dân (type='cccd')

Property	Type	Default	Required	Description	Minimum Version
mrz	string		true	chuỗi thông tin 90 ký tự phía sau thẻ CCCD

Return Values

Promise <Object data>

Property	Type	Readable	Description	Minimum Version
dg1	string	x	Chứa thông tin MRZ
dg2	string	x	Chứa thông tin sinh trắc học (Biometric Data) bao gồm ảnh chân dung
dg3	string		Chứa thông tin dấu vân tay, file được bảo mật, không đọc được, cần có key của bộ công an mới đọc được
dg4	string		Chứa thông tin mống mắt, file được bảo mật, không đọc được, cần có key của bộ công an mới đọc được
dg5	string		Vùng nhớ chưa sử dụng
dg6	string		Vùng nhớ chưa sử dụng
dg7	string		Vùng nhớ chưa sử dụng
dg8	string		Vùng nhớ chưa sử dụng
dg9	string		Vùng nhớ chưa sử dụng
dg10	string		Vùng nhớ chưa sử dụng
dg11	string		Vùng nhớ chưa sử dụng
dg12	string		Vùng nhớ chưa sử dụng
dg13	string	x	Chứa thông tin cá nhân bao gồm Họ tên, số thẻ CCCD, ngày sinh, quê quán,....
dg14	string	x	Thông tin mã khoá dùng để xác thực trong quá trình đọc thẻ
dg15	string	x	Thông tin mã khoá dùng để xác thực trong quá trình đọc thẻ
dg16	string		Vùng nhớ chưa sử dụng
sod	string	x	Raw data chứa toàn bộ data trong thẻ dưới dạng hash value
challenge	string	x	Chuỗi bytes thu được khi thực hiện Active Authentication trong quá trình đọc
aAResult	string	x	Chuỗi bytes thu được khi thực hiện Active Authentication trong quá trình đọc
eACCAResult	string	x	Chuỗi bytes thu được khi thực hiện Chip Authentication trong quá trình đọc

Sample Code

import { scanNFC } from "zmp-sdk/apis";

scanNFC({
  data: {
    mrz: mrz,
  },
  type: "cccd",
  success: (data) => {
    // xử lý khi gọi api thành công
  },
  fail: (err) => {
    // xử lý khi gọi api thất bại
    console.log(error);
  },
});

Hoặc

import { scanNFC } from "zmp-sdk/apis";

const scanDeviceNFC = async () => {
  try {
    const data = await scanNFC({
      data: {
        mrz: mrz,
      },
      type: "cccd",
    });
    // xử lý khi gọi api thành công
  } catch (error) {
    // xử lý khi gọi api thất bại
    console.log(error);
  }
};

Error code

Code	Error
-600	Thiết bị không hỗ trợ NFC
-601	Quá thời gian chờ đọc NFC (mặc định 60s)
-602	Thiết bị có hỗ trợ NFC nhưng không thể kết nối đến chức năng NFC của hệ thống
-603	Không đọc được thông tin thẻ
-604	Thông tin MRZ không hợp lệ
-605	Đang xử lý, có session chưa kết thúc
-606	User cancel