托管身份验证，决策权由您掌握

检查项与信号

托管流程会生成供审核人员查看的检查结果。这些是用于审核的信号，不会决定结果，也不保证能拦截欺诈。

开发者指南

以下操作均通过您的服务器使用标准 HTTPS 完成。完整参考文档请见文档中心。

启动验证的 3 种方式

• 从您的服务器创建托管会话. 您的服务器通过 API 创建链接，页面由 Noxtica 托管。
• 从 Backoffice 发送邀请. 您组织中的人员可在 Backoffice 中创建链接，无需编写代码。
• 从您的服务器直接调用 API. 服务器到服务器的路由，无需托管链接。目前无法通过您自己的界面采集证件以供检查；客户需要采集证件时，请使用托管会话。

创建会话

使用具备身份验证权限的服务器密钥进行身份验证。请将密钥保存在您的服务器上。发送 Idempotency-Key，确保重试不会创建第二个会话。

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"}'

响应内容

此链接仅在此响应中返回一次。请将其视为机密信息，切勿写入日志。过期时间采用 epoch 毫秒。

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

读取状态

您创建的会话始终返回 200，包括已过期的会话。请逐渐延长轮询间隔，并在状态最终确定后停止。

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

Webhook 事件

事件会以签名 HTTPS 请求的形式发送到您在 Backoffice 注册的端点。事件是通知，不是决定。

事件示例

仅为合成示例值。事件不会包含您的客户引用：请通过会话 ID 将事件与客户匹配。

{
  "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-Noxtica-Signature、X-Noxtica-Timestamp、X-Noxtica-Event 和 X-Noxtica-Delivery。
• 签名是对时间戳、一个点号和原始请求正文计算出的 HMAC-SHA256。请先验证签名，再解析正文，并自行设定时间戳容差。
• 消息至少发送一次，顺序不固定。请根据 X-Noxtica-Delivery 去重，然后读取会话状态再采取行动。

无需 SDK。文档提供 curl、Node.js 和 Python 示例。

阅读文档了解更多

• 身份验证集成
• 事件与 Webhook
• 服务器 API 参考：KYC
• 邀请与托管页面设置
• 直接 API
• 活体检测与 PAD 政策
• 常见问题与故障排查
• 在 Backoffice 中进行操作

常见问题

相关页面

• 查看托管验证体验
• 定价
• 企业与商户验证（KYB 和 KYM）
• 验证数据：存储、访问与删除
• 隐私政策
• 安全