> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 客户审核 Webhooks

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

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

## 投递与签名

在企业主 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` | 审核已过期。 |

## 载荷

```json theme={null}
{
  "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。并非所有中间状态都有事件。批准不会转移资金，也不保证企业集成资格。

## 另请参阅

[客户法币流程](https://docs.blockradar.co/zh/guides/customer-fiat-flows.md) · [投递与签名](https://docs.blockradar.co/zh/utilities/webhooks.md)

[刷新客户审核](https://docs.blockradar.co/zh/api-reference/customer-onboarding/refresh-request.md) — 重新请求提现汇率或充值报价以创建新的法币会话。不要复用批准前创建的会话。状态变化也可能发出 customer.onboarding.\* webhooks；案例未变化时不保证产生新事件。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.