...
Một lập trình viên đang tích hợp API xác minh danh tính

API xác minh danh tính: phiên KYC trong một lệnh gọi REST

Tạo phiên xác minh bằng một lệnh POST, đưa khách hàng đến widget Web SDK của chúng tôi và đọc kết quả từ chính phiên đó. Kiểm tra giấy tờ, đối sánh khuôn mặt và Liveness chạy bên trong, và mỗi lượt kiểm tra trả về có tên và kết quả riêng.

Đọc tài liệu APITài liệu API
  • REST API và Web SDK REST + SDK
  • JWT và token truy cập vĩnh viễn JWT · Token
  • Kết quả kiểm tra có tên trong phản hồi Kết quả kiểm tra có tên
  • Tài liệu tham chiếu lỗi công khai Tài liệu tham chiếu lỗi

12.000 lượt xác minh miễn phí khi bạn kết nối lần đầu

Mỗi công ty kết nối với NeuroVision lần đầu tiên đều nhận 12.000 lượt xác minh miễn phí trong 12 tháng. Có từ ngày 1 tháng 12 năm 2026.

Tìm hiểu thêm

Được kiểm định và chứng nhận độc lập

Dấu chứng nhận ISO Register GlobalDấu chứng nhận ASIBDấu chứng nhận QA Compliance Assessment
  • ISO/IEC 27001:2022
  • GDPR
  • iBeta ready
Phạm vi toàn cầu

16.000+ loại giấy tờ
từ 195+ quốc gia và vùng lãnh thổ

Khách hàng xác minh bằng chính giấy tờ họ đang mang theo: hơn 90 ngôn ngữ, kể cả trường viết tay và MRZ.

16.000+

loại giấy tờ


Hộ chiếu Thẻ căn cước Giấy phép lái xe Giấy phép cư trú Thị thực Giấy phép lao động Thẻ cử tri Mã số thuế eID Hộ chiếu sinh trắc học Thẻ quân nhân Thẻ bảo hiểm y tế Căn cước quốc gia Giấy thông hành Thẻ người tị nạn Thẻ bảo hiểm xã hội
195+

quốc gia và vùng lãnh thổ


Kazakhstan UAE Đức Vương quốc Anh Singapore Ấn Độ Brazil Nigeria Philippines Việt Nam Thổ Nhĩ Kỳ Mexico Uzbekistan Ai Cập Indonesia Pháp Tây Ban Nha Ý Ba Lan Kenya Ả Rập Xê Út Nhật Bản Hàn Quốc Úc Hoa Kỳ Canada Thái Lan Malaysia Nam Phi
Bắt đầu nhanh

Lần xác minh đầu tiên của bạn trong năm bước

  1. 01Lấy tokenPOST /user/login trả về JWT tạm thời cho tài khoản của bạn.
  2. 02Tạo phiênPOST /kyc/session/create với kịch bản bạn đã cấu hình.
  3. 03Mở widgetĐưa người dùng đến widget Web SDK bằng liên kết hoặc mã QR.
  4. 04Đọc kết quảHỏi trạng thái phiên định kỳ, hoặc nhận callback do bạn đặt.
  5. 05Vận hành chính thứcThử quy trình trong Sandbox, rồi kết nối người dùng thật.
Mọi thứ ở đây đều có tài liệuMỗi bước khớp với một phương thức trong tài liệu tham chiếu API công khai, dưới cùng một tên.
Cách hoạt động
Endpoint

API xác minh danh tính bao gồm những gì

Năm nhóm phương thức, và một widget sử dụng chúng.

Các tên dưới đây là tên trong tài liệu tham chiếu công khai của chúng tôi, nên bạn có thể tìm từng phương thức mà không phải đoán chúng tôi đã đặt tên gì trên trang giới thiệu.

Phiên KYC

Tạo phiên, kiểm tra trạng thái, liệt kê phiên, lọc phiên và tải về kho lưu nhật ký.

8 phương thức

Token truy cập

Tạo token vĩnh viễn, liệt kê các token người dùng đang giữ, cập nhật hoặc xóa một token.

4 phương thức

Người dùng và số dư

Cấp quyền cho người dùng và nhận JWT tạm thời, đọc số dư nhóm hoặc cập nhật số dư.

3 phương thức

Hồ sơ người

Tạo danh sách người và hồ sơ người, cập nhật, xóa và thêm ảnh vào khuôn mặt đã lưu.

8 phương thức

Nguồn dữ liệu

Tạo nguồn và nhóm nguồn, liệt kê, cập nhật và xóa.

8 phương thức

Web SDK

Cài đặt widget, truyền tham số và làm việc với khóa client gắn widget với một phiên.

4 trang
Lập trình viên

Gọi API trong một yêu cầu

Một phiên được tạo bằng một lệnh POST. Widget đảm nhận phần tiếp theo, và backend của bạn đọc kết quả khi sẵn sàng.

terminalREST API
curl -X POST $NV_API_URL/kyc/session/create \  -H "Content-Type: application/json" \  -H "Authorization: Bearer $JWT" \  -d '{"token":"$JWT","schemaId":"schema-001"}'Chỉ là ví dụ — xem tài liệu để biết đầy đủ nội dung yêu cầu.
lỗi{ "status": …, "message": "…", "details": … }
Tin cậy và dữ liệu

Dữ liệu của bạn ở đâu, ở lại ra sao

Chạy các lượt kiểm tra trên đám mây của chúng tôi, hoặc trong hạ tầng của bạn.

ISO/IEC 27001:2022Hệ thống an ninh được chứng nhận
  • JWT cho mọi lệnh gọi
  • Token truy cập vĩnh viễn
  • Triển khai tại chỗ
  • Bạn đặt thời gian lưu giữ ảnh
Web SDK

Widget Web SDK mà người dùng của bạn thực sự thấy

Widget chạy trên trang của bạn và dẫn khách hàng qua bước chụp giấy tờ, selfie và các bước kiểm tra, rồi gửi kết quả cho bạn.

Chạy trên trình duyệt họ đang dùng

Mọi trình duyệt hiện đại trên máy tính và di động, gồm cả iOS và Android. Quyền duy nhất widget yêu cầu là truy cập camera.

Không cần tải ứng dụng

Gắn với phiên bằng khóa

Khóa client kết nối widget trên trang của bạn với phiên bạn đã tạo, đó là cách kết quả tìm đường về với bạn.

Bắt đầu bằng liên kết hoặc mã QR

Người dùng mở màn hình bắt đầu và quét mã QR hoặc bấm liên kết, và có thể đổi ngôn ngữ giao diện trước khi bắt đầu.

Bạn quyết định bước nào chạy

Các bước giấy tờ, selfie kèm giấy tờ, Liveness và chống gian lận được bật tắt trong kịch bản của bạn, không phải trong mã widget.

Widget Web SDK: màn hình bắt đầu, chụp giấy tờ và kết quả

Widget được mô tả trong bốn trang tài liệu, từ cài đặt đến khóa client.

Kết quả

Đọc kết quả của một phiên

Hai cách để nhận, và một định dạng để đọc.

Mỗi lượt kiểm tra trả về dưới dạng một mục có tên, kèm trạng thái và giá trị độ tin cậy riêng, để quy tắc của bạn đọc được các phần bạn quan tâm thay vì một phán quyết duy nhất.

Hỏi trạng thái phiên định kỳ

Yêu cầu phiên theo mã hoặc theo khóa client và đọc trạng thái cùng kết quả hiện tại.

Pull

Nhận callback

Callback gửi kết quả cuối cùng khi phiên kết thúc, nên bạn không phải hỏi trạng thái định kỳ.

Push

Các lượt kiểm tra có tên kèm độ tin cậy

Kết quả kiểm tra giấy tờ và khuôn mặt trả về dưới dạng các mục có tên, mỗi mục có trạng thái và giá trị độ tin cậy.

JSON

Mỗi lỗi đều có mã

Lượt kiểm tra không đạt trả về mã và mô tả từ tài liệu tham chiếu công khai của chúng tôi, để bộ phận hỗ trợ nói được với khách hàng cần làm gì.

40 mã
Truy cập

Token, quyền truy cập và lỗi

Token tạm thời và token vĩnh viễn

Đăng nhập trả về JWT tạm thời với thời hạn do bạn chọn. Cho công việc giữa máy chủ với máy chủ, bạn tạo token truy cập vĩnh viễn và thu hồi khi không cần nữa.

Lỗi bạn có thể xử lý được

Bốn mươi mã được ghi tài liệu, mỗi mã có mô tả, bao gồm chất lượng ảnh, vấn đề về giấy tờ, tín hiệu gian lận và kiểm tra khuôn mặt, để một lần từ chối có thể giải thích được cho khách hàng.

Xem tài liệu tham chiếu lỗi

Nhật ký phiên có thể tải về

Một phiên có thể được xuất thành kho lưu nhật ký qua API, nên cuộc kiểm toán hay tranh chấp được trả lời từ bản sao của chính bạn thay vì từ ảnh chụp màn hình.

Đọc tài liệu API

Mọi phương thức ở đây đều có trong tài liệu tham chiếu

Mỗi endpoint, trường dữ liệu và mã lỗi trên trang này đều xuất hiện trong tài liệu công khai của chúng tôi dưới cùng một tên, nên bạn có thể đi thẳng từ ví dụ đến trang tham chiếu mô tả nó.

Vì sao chọn chúng tôi

Vì sao các đội ngũ chọn NeuroVision Global Systems

Độ chính xác có thể kiểm chứng

Đối sánh khuôn mặt được kiểm định độc lập, mỗi kết quả đều có điểm tin cậy.

Độ chính xác có thể kiểm chứng

Thuật toán khuôn mặt đã được NIST kiểm định và đạt TOP-24, NIST FRVT 1:1 Verification. Mỗi kết quả kiểm tra giấy tờ và khuôn mặt đều kèm điểm tin cậy.

TOP-24NIST FRVT 1:1 Verification
0,1 giâymỗi lần đối sánh khuôn mặt

Vận hành trong chưa đầy một giờ

REST API, Web SDK, SDK iOS và Android, WebView; Sandbox trước.

Vận hành trong chưa đầy một giờ

Dưới một giờ với REST API hoặc Web SDK bằng khóa Sandbox; đưa vào vận hành thật trong một ngày làm việc. Gói dùng thử 14 ngày trên lưu lượng thực của bạn đi kèm hỗ trợ đầy đủ.

< 1 giờđể tích hợp bằng khóa Sandbox
14 ngàydùng thử với toàn quyền truy cập API

Phạm vi toàn cầu

195+ quốc gia và vùng lãnh thổ, 16.000+ loại giấy tờ, 90+ ngôn ngữ.

Phạm vi toàn cầu

Khách hàng xác minh bằng chính giấy tờ họ đang mang theo: hơn 16.000 loại giấy tờ từ 195+ quốc gia và vùng lãnh thổ, kể cả trường viết tay và MRZ.

16.000+loại giấy tờ
90+ngôn ngữ

Chống gian lận xây dựng từ các cuộc tấn công thực tế

40+ bước kiểm tra giấy tờ, tìm kiếm khuôn mặt 1:N, sàng lọc danh sách đen và 30 lớp bảo vệ khác.

Chống gian lận xây dựng từ các cuộc tấn công thực tế

Liveness chống deepfake, loại trùng 1:N và sàng lọc danh sách đen bên trên các bước kiểm tra giấy tờ: một người, một tài khoản.

40+bước kiểm tra giấy tờ
0,01%rủi ro gian lận còn lại

Quyền riêng tư ngay từ thiết kế

ISO/IEC 27001:2022, sẵn sàng cho GDPR; tại chỗ, đám mây hoặc kết hợp.

Quyền riêng tư ngay từ thiết kế

Vận hành trên đám mây của chúng tôi, trong trung tâm dữ liệu của bạn hoặc kết hợp cả hai: mẫu sinh trắc học và dữ liệu cá nhân không bao giờ rời khỏi phạm vi pháp lý của bạn.

27001:2022được chứng nhận ISO/IEC
GDPRsẵn sàng

Chỉ dùng engine tự phát triển

OCR, khuôn mặt, Liveness và chống gian lận đều là của chúng tôi.

Chỉ dùng engine tự phát triển

Một nhà cung cấp bao trọn KYC, KYB, AML và KYT trên một API: một SLA, không giấy phép của bên thứ ba.

20 nămkỹ thuật thị giác máy tính
1 SLAcho mọi lượt kiểm tra
Bảng giá

Giá API xác minh danh tính

API không phải sản phẩm riêng có giấy phép riêng. Bạn trả theo từng lượt kiểm tra hoàn tất.

Gói giấy tờ

Từ 0,25 USD mỗi lượt kiểm tra

Nhận dạng giấy tờ và kiểm tra chống gian lận. Thêm selfie và Liveness với gói Basic. Tự chọn bộ của bạn trong bảng tính giá.

Tính giá

Trả theo mức dùng

Không thuê bao và không phí giấy phép cho API — bạn trả theo từng lượt kiểm tra hoàn tất.

Xem bảng giá

Dùng thử miễn phí

Dùng thử 14 ngày trên lưu lượng thật của bạn, với toàn quyền truy cập API và Sandbox ngay từ ngày đầu.

Khối lượng lớn và doanh nghiệp

Điều khoản riêng cho khối lượng lớn, triển khai tại chỗ và SLA.

Sản phẩm

Giải pháp định danh bằng AI của chúng tôi

Mọi thứ bạn cần để xác minh, xác thực và bảo vệ khách hàng, gói trong một nền tảng mạnh mẽ.

Người thật với giấy tờ thật, được xác minh trong vài giây. Chụp giấy tờ, đối sánh khuôn mặt, Liveness, chống gian lận và AML.

Tìm hiểu thêm

Sàng lọc mọi khách hàng với danh sách trừng phạt, PEP và danh sách cảnh báo, kể cả danh sách tự loại trừ, ngay trong cùng luồng xác minh.

Tìm hiểu thêm

Xác minh doanh nghiệp đứng sau tài khoản: dữ liệu đăng ký doanh nghiệp và chủ sở hữu hưởng lợi cuối cùng (UBO), được kiểm tra trước khi tiếp nhận.

Tìm hiểu thêm

Giám sát giao dịch theo thời gian thực: các lượt chuyển đáng ngờ được gắn cờ để rà soát, trên cùng API với KYC và AML.

Tìm hiểu thêm

Người thật đang hiện diện, chống deepfake. Xác thực khách hàng quay lại bằng khuôn mặt thay cho mật khẩu.

Tìm hiểu thêm

Thanh toán được xác nhận bằng khuôn mặt hoặc giấy tờ tùy thân: danh tính khách hàng đã xác minh, ngay tại bước thanh toán.

Tìm hiểu thêm
Liên hệ

Lấy khóa API của bạn

Hãy cho chúng tôi biết bạn đang xây dựng gì và cần những bước kiểm tra nào. Chúng tôi sẽ gửi thông tin truy cập Sandbox và kết nối bạn với kỹ sư sẽ giúp bạn vận hành thật.

Muốn liên hệ trực tiếp?
Gửi e-mail cho chúng tôi:
hello@nv.global
Họ và tên *
Vui lòng nhập họ tên hợp lệ
Công ty
E-mail *
Vui lòng nhập e-mail hợp lệ
Số điện thoại
Vui lòng nhập số điện thoại hợp lệ
Tin nhắn của bạn (không bắt buộc)
Vui lòng đồng ý với chính sách quyền riêng tư
FAQ

FAQ về API xác minh danh tính

Những điều lập trình viên hỏi trước khi bắt đầu. Tài liệu tham chiếu đầy đủ nằm trong phần tài liệu, và chúng tôi có liên kết đến đó.

Chưa tìm được câu trả lời?

Đăng nhập trả về JWT tạm thời, và bạn cũng có thể tạo token truy cập vĩnh viễn cho các lệnh gọi giữa máy chủ với máy chủ. Cả hai đều được mô tả trong tài liệu tham chiếu API.

Có, cho kết quả cuối cùng của phiên. Bạn cũng có thể hỏi trạng thái phiên định kỳ theo mã hoặc theo khóa client.

Kiểm tra độ tuổi chạy trong cùng phiên; xem API xác minh độ tuổi.

Chúng tôi không công bố giới hạn tần suất gọi. Hãy cho chúng tôi biết khối lượng bạn dự kiến và chúng tôi sẽ xác nhận cho trường hợp của bạn.

Một lượt kiểm tra có tên kèm trạng thái, cùng mã lỗi và mô tả từ tài liệu tham chiếu lỗi công khai của chúng tôi — đủ để bộ phận hỗ trợ của bạn nói với khách hàng cần làm gì tiếp theo.

Sàng lọc AML trả về theo cùng cách — như một bước kiểm tra có tên; xem API AML.

Có. Bạn thử tích hợp trong Sandbox trước khi kết nối dữ liệu thật, và đội tích hợp của chúng tôi đồng hành cùng bạn trong phiên đầu tiên.

Không có giấy phép API riêng. Bạn trả theo từng lượt kiểm tra hoàn tất, từ 0,25 USD cho nhận dạng giấy tờ kèm chống gian lận. Hãy tự chọn bộ của bạn trên trang bảng giá.

Nền tảng nhận diện khuôn mặt hợp nhất
cho xác minh KYC tức thì

Tinh gọn việc tiếp nhận khách hàng, ngăn chặn gian lận và bảo đảm tuân thủ KYC/AML