> ## 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 連結](/verify-customers-by-documents)。

<Info>
  **先決條件**

  * Fluz 為你的應用程式啟用 `VERIFY_KYC` 權限範圍。請參閱[必要的權限範圍](/user-kyc-verification#required-scope)。
  * 為待驗證客戶產生的[使用者存取權杖](/recipes/generate-user-access-token)，其範圍需包含 `VERIFY_KYC`。
  * 已註冊的 webhook 端點。請參閱[驗證客戶](/user-kyc-verification#set-up-a-webhook)。
</Info>

## 運作方式

`verifyUserPrefillInformation` mutation 為同步執行。客戶完全由使用者存取權杖識別——無需蒐集或驗證任何輸入。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"
    }
  }
}
```

## 處理回應

| 狀態          | 動作                                                                               |
| :---------- | :------------------------------------------------------------------------------- |
| `APPROVED`  | 客戶已通過驗證。解鎖相關功能。                                                                  |
| `DECLINED`  | 升級為 [SSN 驗證](/verify-customers-by-ssn) 或 [文件驗證](/verify-customers-by-documents)。 |
| `DUPLICATE` | 客戶已通過驗證，但其身份資料與另一位 Fluz 客戶相符。視為已驗證，並在你方檢視是否為重複帳戶。Fluz 不會揭露相符的是哪位客戶。              |
| `ERROR`     | 檢視 `message`。客戶可能已完成驗證，或其嘗試次數已用盡。                                                |

## 測試

一般的測試環境設定請參閱[測試 KYC 流程](/test-kyc-flows)——需要開發者帳戶、已啟用的應用程式，以及待驗證客戶的使用者存取權杖。

<Warning>
  KYC 自動填寫在測試環境中的可重現測試身份目前尚未公開。請在將其納入自動化測試套件前，先與平台團隊確認預期結果。
</Warning>