Cấu hình SDK

Tài liệu này mô tả và hướng dẫn các cấu hình cho một số tùy chọn của eKYC SDK từ eKYC Portal. Các tùy chọn này bao gồm việc thay đổi luồng hoạt động và chỉnh sửa một số thành phần trên giao diện của SDK.

Để truy cập trang này, bạn cần đăng nhập vào hệ thống eKYC Portal, chọn ngôn ngữ VI và chọn tab Cấu hình eKYC ở menu bên trái. Sau đó, chọn SDK ở menu phụ.

Dưới đây là hướng dẫn chi tiết:

1. Luồng eKYC

• Mô tả:

  • Luồng eKYC là một quy trình được thiết kế để xác thực danh tính của người dùng thông qua việc sử dụng các phương pháp nhận dạng và xác thực.
  • Luồng eKYC bao gồm hai bước chính không thể thay đổi như sau:
    • Lấy thông tin từ ID (OCR thông tin bề mặt hoặc đọc NFC hoặc cả hai)
    • Xác thực danh tính (so khớp ảnh trên ID với ảnh chân dung của người dùng)
  • Ngoài ra, các bước khác có thể được thay đổi phù hợp với nhu cầu sử dụng của khách hàng như: quét mã QR, kiểm tra tính sống, ...
  • Hiện tại, eKYC Portal hỗ trợ 2 lựa chọn luồng eKYC bao gồm:
    • Luồng Document-Liveness: OCR thông tin bề mặt của ID, kiểm tra tính sống của người dùng và xác thực danh tính.
    • Luồng Document-NFC-Liveness: OCR thông tin bề mặt, đọc thông tin từ NFC chip, kiểm tra tính sống của người dùng và xác thực danh tính.

• Cách cấu hình:

  • Chọn luồng eKYC phù hợp với nhu cầu sử dụng của khách hàng.
  • Nếu khách hàng muốn sử dụng các luồng eKYC khác ngoài các luồng đang có trên eKYC Portal, vui lòng liên hệ với bộ phận tư vấn sản phẩm hoặc hỗ trợ kỹ thuật để được hỗ trợ.

2. Phương án kiểm tra tính sống

• Mô tả:

  • Phần này cho phép khách hàng lựa chọn một trong số các phương thức kiểm tra tính sống (liveness) được hỗ trợ. Một số phương thức không yêu cầu người dùng phải thực hiện hành động đặc thù nào, tuy nhiên một số phương thức khác sẽ yêu cầu người dùng phải thực hiện một chuỗi các hành động theo hướng dẫn của SDK. Các mô hình AI được tích hợp sẵn trong SDK sẽ hỗ trợ người dùng trong quá trình thực hiện các hành động.

  • Hiện tại, eKYC Portal hỗ trợ 4 lựa chọn phương thức kiểm tra tính sống bao gồm:

    • Hình ảnh bị động: Kiểm tra tính sống bằng cách yêu cầu người dùng quay một đoạn video selfie từ 3 - 5 giây. Một số frame ngẫu nhiên sẽ được thuật toán trích xuất ra gửi về eKYC server cho bước kiểm tra sâu hơn.
    • Hình ảnh chủ động: Kiểm tra tính sống bằng cách yêu cầu người dùng quay một đoạn video selfie 3 giây ở khoảng cách gần và chụp một ảnh selfie ở khoảng cách xa. Một số frame ngẫu nhiên sẽ được thuật toán trích xuất ra gửi về eKYC server cho bước kiểm tra sâu hơn.
    • 3 ảnh trái/phải/thẳng: Kiểm tra tính sống bằng cách yêu cầu người dùng chụp 3 ảnh selfie với 3 góc mặt khác nhau: trái, phải và thẳng. Sau đó ba ảnh này sẽ được gửi về eKYC server cho bước kiểm tra sâu hơn.
    • Liveness flash: Kiểm tra tính sống bằng cách yêu cầu người dùng quay một đoạn video selfie từ 3 - 5 giây. Trong khi quay, màn hình thiết bị sẽ nháy ánh sáng màu. Một số frame ngẫu nhiên sẽ được thuật toán trích xuất ra gửi về eKYC server cho bước kiểm tra sâu hơn.

  • Khách hàng có thể tham khảo tài liệu So sánh các phương thức kiểm tra tính sống để biết thêm chi tiết về các phương thức kiểm tra tính sống này.

  • Minh họa các phương thức kiểm tra tính sống:

    • Hình ảnh bị động:
    • Hình ảnh chủ động:
    • 3 ảnh trái/phải/thẳng:
    • Liveness flash:

• Cách cấu hình:

  • Chọn phương thức kiểm tra tính sống phù hợp với nhu cầu sử dụng của khách hàng.
  • Nếu khách hàng muốn sử dụng các phương án kiểm tra tính sống khác ngoài các phương án đang có trên eKYC Portal, vui lòng liên hệ với bộ phận tư vấn sản phẩm hoặc hỗ trợ kỹ thuật để được hỗ trợ.

ghi chú

Trong quá trình sử dụng hệ thống FPT AI eKYC, khách hàng có thể thay đổi phương án kiểm tra tính sống tại bất kỳ thời điểm nào bằng cách thay đổi lựa chọn trên eKYC Portal. Tuy nhiên để việc chuyển đổi diễn ra thuận lợi, khách hàng nên tham khảo tư vấn từ đội ngũ hỗ trợ kỹ thuật của FPT AI eKYC về các phương án kiểm tra tính sống dự định sử dụng ngay từ khi bắt đầu tích hợp hệ thống.

3. Cấu hình giới hạn số lần quét NFC

• Mô tả:

  • Phần này cho phép khách hàng cấu hình số lần quét NFC mà người dùng có thể thực hiện lại trong một phiên làm việc sau khi thất bại lần đầu tiên.

• Cách cấu hình:

  • Nhập số lần quét NFC mà người dùng có thể thực hiện lại trong một phiên làm việc.

ghi chú

Cấu hình này chỉ áp dụng cho luồng eKYC có yêu cầu quét NFC.

4. Cấu hình thời gian chờ khi chụp giấy tờ

• Mô tả:
  • Phần này cho phép khách hàng cấu hình thời gian chờ khi chụp giấy tờ tự động. Thời gian này tính từ khi SDK kiểm tra hợp lệ giấy tờ đến khi SDK hoàn thành việc chụp giấy tờ.
  • Đơn vị của thời gian chờ là ms. Giá trị mặc định là 500.
  • Thời gian chờ này sẽ được hiển thị trên giao diện SDK dưới dạng hiệu ứng động của vòng tròn xanh xung quanh nút chụp hình như hình bên dưới.

• Cách cấu hình:
  • Nhập thời gian chờ khi chụp giấy tờ.

5. Cấu hình hiện trang hướng dẫn

• Mô tả:
  • Phần này cho phép khách hàng cấu hình bật/tắt việc hiện trang hướng dẫn cho các bước chính của quá trình eKYC trên SDK.
  • Có 4 lựa chọn để khách hàng cấu hình:
    • Tắt: Không hiện trang hướng dẫn ở bước nào.
    • Hiện ở OCR: Hiện trang hướng dẫn ở bước OCR.
    • Hiện ở tính sống: Hiện trang hướng dẫn ở bước kiểm tra tính sống.
    • Hiện ở cả 2: Hiện ở cả 2 bước OCR và tính sống.
  • Khách hàng có thể xem minh họa trang hướng dẫn như hình bên dưới:
    • Trang hướng dẫn của bước OCR:

• Trang hướng dẫn của bước kiểm tra tính sống:

6. Cấu hình hiện các bước thực hiện

• Mô tả:
  • Phần này cho phép khách hàng cấu hình bật/tắt việc hiện các bước thực hiện trên SDK.
  • Sơ đồ các bước thực hiện sẽ giúp người dùng có cái nhìn tổng quan về luồng eKYC đang thực hiện, các bước đã hoàn thành và các bước cần thực hiện tiếp theo.
  • Khách hàng có thể xem minh họa sơ đồ các bước thực hiện như hình bên dưới:

• Cách cấu hình: Sử dụng nút gạt để bật hoặc tắt việc hiện các bước thực hiện.

7. Cấu hình hiện kết quả eKYC

• Mô tả:
  • Phần này cho phép khách hàng cấu hình bật/tắt việc hiện trang kết quả eKYC sau khi hoàn thành quá trình xác thực trên SDK.
  • Khách hàng có thể xem minh họa trang kết quả eKYC như hình bên dưới:

• Cách cấu hình: Sử dụng nút gạt để bật hoặc tắt việc hiện trang kết quả.

8. Cấu hình hiệu ứng động hướng dẫn chụp giấy tờ

• Mô tả:
  • Phần này cho phép khách hàng cấu hình bật/tắt việc hiện hiệu ứng động hướng dẫn chụp giấy tờ.
  • Hiệu ứng động này sẽ được hiển thị khi người dùng chụp xong mặt trước của giấy tờ và dùng để hướng dẫn người dùng tiếp tục chụp mặt sau của giấy tờ.
  • Khách hàng có thể xem minh họa hiệu ứng động này như hình bên dưới:

Loading animation...

Loading animation...

• Cách cấu hình:
  • Chọn Tắt hoặc Kích hoạt trong menu thả.

ghi chú

Khách hàng có thể chủ động thay đổi màu sắc của hiệu ứng động theo màu sắc chủ đề của ứng dụng.

9. Cấu hình quét QRcode

• Mô tả:
  • Phần này cho phép khách hàng cấu hình bật/tắt bước quét QRcode trong luồng eKYC.
  • Nếu tùy chọn này được bật, trong trường hợp bước OCR không có kết quả QRcode, SDK sẽ tự động chuyển sang bước quét QRcode. Người dùng sẽ buộc phải thực hiện quét QRcode để tiếp tục quá trình xác thực, kết quả QRcode sau đó sẽ được so khớp với kết quả OCR. Trong trường hợp bước OCR có kết quả QRcode, SDK sẽ tự động bỏ qua bước quét QRcode.
  • Khách hàng có thể xem minh họa quét QRcode như hình bên dưới:

• Cách cấu hình:
  • Chọn Tắt hoặc Kích hoạt trong menu thả.

10. Cấu hình xác nhận thoát luồng eKYC

• Mô tả:
  • Phần này cho phép khách hàng cấu hình bật/tắt việc hiện hộp thoại xác nhận khi bấm thoát luồng eKYC giữa chừng.
  • Khách hàng có thể xem minh họa hộp thoại xác nhận thoát luồng eKYC như hình bên dưới:

• Cách cấu hình:
  • Chọn Tắt hoặc Kích hoạt trong menu thả.

11. Cấu hình bật/tắt nhãn các bước thực hiện

• Mô tả:

  • Phần này cho phép khách hàng cấu hình bật/tắt việc hiện nhãn các bước trên sơ đồ các bước thực hiện.

  • Khách hàng có thể xem minh họa sơ đồ các bước thực hiện như hình bên dưới:

    • Có nhãn:

    

    • Không có nhãn:

    

12. Cấu hình font chữ mobile SDKs

• Mô tả:

  • Phần này cho phép khách hàng cấu hình font chữ mobile SDKs.
  • Các kiểu font chữ được hỗ trợ bao gồm:
    • Regular
    • Medium
    • Bold

• Cách cấu hình: Điền đường dẫn tới font chữ cần sử dụng. Ví dụ như sau:

ghi chú

• Đảm bảo nhấn nút Cập nhật thông tin sau khi thực hiện các thay đổi để áp dụng cấu hình mới.

• Nếu có bất kỳ vấn đề nào, vui lòng liên hệ với bộ phận hỗ trợ kỹ thuật.