快速开始
集成 / SDK
用户验证
企业验证
交易监控
更新日志事件目录
activity.created 可以在 subscribed_events 中设置，并且在 Try Webhook 测试工具中可用，但 Didit 目前不会向实际流量投递该事件。
请勿基于它构建时间线同步。- KYB Webhook：企业会话事件
- 交易监控 Webhook：交易事件
- Webhook 参考：签名验证、重试、目标
Payload 结构
实体 Webhook 是扁平结构：没有data 包装层，也没有 event 键。
请读取 webhook_type 来路由事件。
user.status.updated / business.status.updated
每次状态变化都会触发。
payload 包含 status 和 previous_status。
它不会说明状态变化的原因：如果您需要查明原因，请在控制台中打开该实体。
user.data.updated / business.data.updated
资料字段变化时触发。
changed_fields 列出发生变化的字段，changes 包含每个字段的 previous 值和 current 值。
changed_fields 中可能出现的字段如下：
- 用户：
vendor_data、display_name、full_name、date_of_birth、metadata、portrait_image、issuing_states、approved_emails、approved_phones、features、session_count、approved_count、declined_count、in_review_count、first_session_at、last_session_at。 - 企业：
vendor_data、display_name、metadata、legal_name、registration_number、country_code、session_count、approved_count、declined_count、in_review_count、features、first_session_at、last_session_at。
changed_fields 和 changes，只同步发生变化的字段。
投递、重试与签名
所有实体 Webhook 都遵循标准投递约定：- 使用目标的
secret_shared_key，通过X-Signature-V2请求头使用 HMAC-SHA256 进行签名（推荐方式）。同时还会发送X-Signature和已弃用的X-Signature-Simple，以及X-Timestamp。 - 当您的端点返回 5xx 或 404、超时或连接失败时，会重试最多 2 次，分别在约 1 分钟和约 4 分钟后进行。完整策略请参阅 Webhook 参考。
- 幂等性：每个 Webhook 的 payload 中都有唯一的
event_id，请在您的系统中进行去重。
订阅
通过 Management API 或 Business Console，在 Webhook 目标上订阅实体事件：后续步骤
Webhook 参考
目标、签名、重试和验证。
创建目标
注册新的 Webhook 端点。
用户操作
会触发用户 Webhook 的变更。