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

# KYC 自动填充

> 使用 Fluz 已为该客户存档的数据请求身份决策——无需收集或提交任何身份字段。

KYC 自动填充是成本最低的 API 验证方法。你无需收集或提交任何身份字段——Fluz 会使用已存档的数据（例如其注册手机号）解析并验证客户身份，并在同一响应中返回决策。

每当你完全不想从客户处收集身份数据时，将其作为首选的 API 尝试。如果被拒，回退到 [SSN 验证](/verify-customers-by-ssn) 或 [请求 IDV URL](/verify-customers-by-documents)。

<Info>
  **先决条件**

  * 由 Fluz 在你的应用上启用 `VERIFY_KYC` scope。参见 [所需 scope](/user-kyc-verification#required-scope)。
  * 为待验证客户生成的 [用户访问令牌](/recipes/generate-user-access-token)，其 scopes 中包含 `VERIFY_KYC`。
  * 已注册的 webhook 端点。参见 [验证客户](/user-kyc-verification#set-up-a-webhook)。
</Info>

## 工作原理

`verifyUserPrefillInformation` 变更是同步的。客户完全由用户访问令牌识别——无需收集或校验任何输入。Fluz 将筛查客户的存档数据，并在响应体中返回 `APPROVED`、`DECLINED`、`DUPLICATE` 或 `ERROR`。

Fluz 还会向你的 webhook 端点发送一条验证事件，因此一个处理程序即可一致地处理每种验证方法的结果。

<Note>
  KYC 自动填充针对每位客户仅运行一次，无论通过或拒绝——重复调用将直接返回，不会重新尝试验证。
</Note>

## 请求

被验证的客户通过 `Authorization` 头中的用户访问令牌进行识别。无需提供任何输入。

## 示例

```javascript theme={null}
import { GraphQLClient, gql } from 'graphql-request';

const API_URL = 'https://transactional-graph.fluzapp.com/api/v1/graphql';

const VERIFY_USER_PREFILL_INFORMATION = gql`
  mutation verifyUserPrefillInformation {
    verifyUserPrefillInformation {
      status
      message
    }
  }
`;

const client = new GraphQLClient(API_URL, {
  headers: {
    Authorization: `Bearer <<USER_ACCESS_TOKEN>>`,
    'Content-Type': 'application/json',
  },
});

const response = await client.request(VERIFY_USER_PREFILL_INFORMATION);

console.log(response);
```

```json Response theme={null}
{
  "data": {
    "verifyUserPrefillInformation": {
      "status": "APPROVED",
      "message": "User verification successful"
    }
  }
}
```

## 处理响应

| Status      | 处理方式                                                                             |
| :---------- | :------------------------------------------------------------------------------- |
| `APPROVED`  | 客户已通过验证。解锁相应功能。                                                                  |
| `DECLINED`  | 升级到 [SSN 验证](/verify-customers-by-ssn) 或 [证件验证](/verify-customers-by-documents)。 |
| `DUPLICATE` | 客户已通过验证，但其身份数据与另一位 Fluz 客户匹配。按已验证处理，并在你方审查是否存在重复账户。Fluz 不会披露匹配的是哪位客户。            |
| `ERROR`     | 检查 `message`。客户要么已验证，要么其尝试次数已用尽。                                                 |

## 测试

通用的预发配置请参见 [测试 KYC 流程](/test-kyc-flows)——开发者账号、已激活的应用，以及为被验证客户准备的用户访问令牌。

<Warning>
  KYC 自动填充在预发环境中的确定性测试身份尚未发布。在将其用于自动化测试套件之前，请与平台团队确认预期结果。
</Warning>