Xác minh danh tính qua luồng được lưu trữ, quyền quyết định thuộc về bạn

Các bước kiểm tra và tín hiệu

Quy trình lưu trữ tạo ra kết quả kiểm tra để người đánh giá xem xét. Đây là các tín hiệu hỗ trợ việc đánh giá. Chúng không quyết định kết quả và không đảm bảo chặn gian lận.

Dành cho nhà phát triển

Mọi thao tác dưới đây đều là HTTPS thông thường từ máy chủ của bạn. Tài liệu có phần tham khảo đầy đủ.

3 cách bắt đầu xác minh

• Phiên lưu trữ do máy chủ của bạn tạo. Máy chủ của bạn tạo liên kết qua API và Noxtica lưu trữ trang.
• Lời mời từ Backoffice. Một người trong tổ chức của bạn tạo liên kết trong Backoffice mà không cần viết mã.
• API trực tiếp từ máy chủ của bạn. Các luồng máy chủ với máy chủ không dùng liên kết lưu trữ. Hiện tại, luồng này không cho phép màn hình riêng của bạn ghi nhận giấy tờ để kiểm tra; hãy dùng phiên lưu trữ khi khách hàng cần ghi nhận giấy tờ.

Tạo phiên

Xác thực bằng khóa máy chủ có quyền nhận dạng. Giữ khóa trên máy chủ của bạn. Gửi Idempotency-Key để thao tác thử lại không tạo phiên thứ hai.

curl -sS https://collect.noxtica.com/v1/kyc/sessions \
  -H "Authorization: Bearer $NOXTICA_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"subjectRef":"cust_example","returnUrl":"https://merchant.example.com/verification/return"}'

Phản hồi

Liên kết chỉ được trả về một lần trong phản hồi này. Hãy xem đây là thông tin bí mật và không ghi vào nhật ký. Thời hạn hết hiệu lực được tính bằng mili giây epoch.

{
  "ok": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "url": "https://verify.noxtica.com/s/EXAMPLE_TOKEN",
  "expiresAt": 1790848845000,
  "domainId": null,
  "requestId": "req_example"
}

Đọc trạng thái

Phiên do bạn tạo luôn trả về 200, kể cả khi đã hết hạn. Hãy thăm dò với khoảng chờ tăng dần và dừng khi có trạng thái cuối cùng.

GET https://collect.noxtica.com/v1/kyc/sessions/00000000-0000-4000-8000-000000000001
Authorization: Bearer $NOXTICA_SERVER_KEY

Sự kiện webhook

Các sự kiện được gửi qua HTTPS có chữ ký đến điểm cuối bạn đăng ký trong Backoffice. Sự kiện là thông báo, không phải quyết định.

Sự kiện mẫu

Chỉ gồm giá trị tổng hợp. Sự kiện không bao giờ chứa mã tham chiếu khách hàng của bạn: hãy đối chiếu sự kiện với khách hàng bằng ID phiên.

{
  "id": "00000000-0000-4000-8000-000000000001:endpoint_example",
  "type": "kyc.session.completed",
  "created_at": 1790762445000,
  "tenant_id": "tenant_example",
  "data": {
    "schemaVersion": "1",
    "sessionId": "00000000-0000-4000-8000-000000000001",
    "status": "completed",
    "verificationId": "verification_example",
    "reasonCodes": ["provider_manual_review"],
    "occurredAt": 1790762445000,
    "deliveryId": "00000000-0000-4000-8000-000000000001:endpoint_example"
  }
}

Xác minh mọi lần gửi

• Mỗi lần gửi đều có các header X-Noxtica-Signature, X-Noxtica-Timestamp, X-Noxtica-Event và X-Noxtica-Delivery.
• Chữ ký là HMAC-SHA256 được tạo từ dấu thời gian, dấu chấm và nội dung yêu cầu thô. Hãy xác minh chữ ký trước khi phân tích nội dung và tự đặt khoảng dung sai cho dấu thời gian.
• Sự kiện được gửi ít nhất một lần và thứ tự gửi không cố định. Hãy loại trùng lặp bằng X-Noxtica-Delivery, sau đó đọc trạng thái phiên trước khi thực hiện hành động.

Không cần SDK. Tài liệu có ví dụ dùng curl, Node.js và Python.

Đọc thêm trong tài liệu

• Tích hợp xác minh danh tính
• Sự kiện và webhook
• Tài liệu tham khảo Server API: KYC
• Lời mời và cài đặt trang lưu trữ
• API trực tiếp
• Chính sách tính sống và PAD
• Câu hỏi thường gặp và khắc phục sự cố
• Thao tác trong Backoffice

Câu hỏi thường gặp

Các trang liên quan

• Xem trải nghiệm xác minh được lưu trữ
• Bảng giá
• Xác minh doanh nghiệp và đơn vị bán hàng (KYB và KYM)
• Dữ liệu xác minh: lưu trữ, truy cập và xóa
• Chính sách quyền riêng tư
• Bảo mật