客户审核 Webhooks - Blockradar

接收法币提现、充值和虚拟账户的客户审核更新。这些事件代表审核案例，不代表付款或资金结算。

投递与签名

在企业主 API 密钥下配置与客户网络 mainnet 或 testnet 对应的 webhook URL。使用活跃 URL；没有活跃 URL 时回退到旧版单一 URL。这些是企业级事件，无需钱包。请使用该主 API 密钥验证 HMAC-SHA512，而不是钱包密钥。默认签名头为 x-blockradar-signature；自定义签名头配置仍然生效。

事件

事件	含义
`customer.onboarding.submitted`	已提交至服务商。
`customer.onboarding.in_review`	审核中。
`customer.onboarding.action_required`	客户需要补充操作。请查询最新案例及当前要求。
`customer.onboarding.approved`	已批准；使用新会话重试原操作。
`customer.onboarding.rejected`	已拒绝。
`customer.onboarding.failed`	审核处理失败。
`customer.onboarding.expired`	审核已过期。

载荷

{
  "event": "customer.onboarding.approved",
  "data": {
    "id": "8392013d-2481-47c9-b5e3-b61b22b8ff82",
    "customerId": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a",
    "provider": {
      "id": "1128dd40-2c94-4c16-a6bf-fbbc6afee52c",
      "slug": "noah",
      "name": "Noah"
    },
    "status": "approved",
    "previousStatus": "in_review",
    "reason": null,
    "availableActions": [],
    "createdAt": "2026-10-31T10:00:00.000Z",
    "updatedAt": "2026-10-31T10:15:00.000Z"
  }
}

字段

字段	含义
`data.id`	审核案例 ID，不是客户或交易 ID。
`data.customerId`	客户 ID。
`data.provider`	服务商 ID、slug 和显示名称。
`data.status`	当前审核状态。
`data.previousStatus`	上一个状态，未知时为 null。
`data.reason`	原因，或 null。
`data.availableActions`	可用操作为 edit_and_resubmit 和/或 refresh_provider_steps，或空数组。操作前请查询案例。
`data.createdAt`	案例创建时间。
`data.updatedAt`	案例更新时间，不是投递时间。

处理更新

请快速返回 HTTP 200，并以幂等方式处理事件。重试可能重复投递；使用案例 ID、event 和 updatedAt 识别重复，并在修改状态前查询最新案例。相同状态和原因的更新会被抑制；操作或托管会话变化时可再次发出 action_required。并非所有中间状态都有事件。批准不会转移资金，也不保证企业集成资格。

另请参阅

客户法币流程 · 投递与签名刷新客户审核 — 重新请求提现汇率或充值报价以创建新的法币会话。不要复用批准前创建的会话。状态变化也可能发出 customer.onboarding.* webhooks；案例未变化时不保证产生新事件。