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

# 個人入駐 API 工作流程

> 將個人 KYC 政策對應至當前的 Customers、Capabilities、Tasks、Task Submissions 與 Documents 操作。

## 個人入駐 API 工作流程

使用此對照將個人 KYC 政策連接至當前所生成的 API 參考。請在每一步都跟隨當前資源,而不要以面向政策的標籤實作 API 狀態機。

## 工作流程對照

### 1. 建立個人客戶

使用 [`POST /v3/customers`](/api-reference/customers/post-v3-customers) 建立客戶。儲存回傳的 customer id,並使用 [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id) 讀取當前資源。

### 2. 探索並申請符合資格的能力

讀取 [`GET /v3/customers/{customerId}/capabilities/supported`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-supported)。僅在其當前可用性與資格允許申請時才選擇變體,然後使用 [`POST /v3/customers/{customerId}/capabilities/{capabilityId}`](/api-reference/capabilities/post-v3-customers-by-customer-id-capabilities-by-capability-id)。

### 3. 讀取當前的能力與申請

讀取 [`GET /v3/customers/{customerId}/capabilities/{capabilityId}`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id) 與 [`GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id-applications)。請依當前的待辦任務 ID 執行,而不是從先前的回應推論就緒狀態。

### 4. 取得當前任務細節

使用 [`GET /v3/customers/{customerId}/tasks`](/api-reference/tasks/list-customer-tasks) 列出客戶任務。使用 [`GET /v3/customers/{customerId}/tasks/{taskId}`](/api-reference/tasks/get-customer-task) 讀取經授權的動作面。

任務細節可能會暴露第一方託管的 session URL 與當前可執行的要求。請使用其當前的版本與狀態。

### 5. 完成託管 session 或提交任務答覆

當任務細節提供託管 session 時,僅將必要的 session 資料回傳給您的用戶端,並將 API 金鑰保留於後端。

當任務要求答覆時,使用 [`POST /v3/customers/{customerId}/tasks/{taskId}/submissions`](/api-reference/task-submissions/create-customer-task-submission) 建立一次完整不可變的嘗試。使用 [`GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}`](/api-reference/task-submissions/get-customer-task-submission) 讀取當前提交與其公開結果。

### 6. 僅在被要求時上傳文件

僅在當前任務要求時上傳文件。使用 [`POST /v3/customers/{customerId}/documents`](/api-reference/documents/post-v3-customers-by-customer-id-documents),然後將回傳的 document id 放入對應的文件答覆中。

### 7. 重新讀取當前資源

每次事件或動作後,重新讀取當前的客戶、能力、申請與任務。以其最新的狀態、原因、要求與待辦任務 ID 決定下一步。

## 生成操作對照

| 資源               | 生成操作                                                                                                                                                                                | 用途                 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| Customers        | [`POST /v3/customers`](/api-reference/customers/post-v3-customers)                                                                                                                  | 建立個人客戶             |
| Customers        | [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id)                                                                                        | 讀取當前客戶資料           |
| Capabilities     | [`GET /v3/customers/{customerId}/capabilities/supported`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-supported)                                       | 探索當前可用性與資格         |
| Capabilities     | [`POST /v3/customers/{customerId}/capabilities/{capabilityId}`](/api-reference/capabilities/post-v3-customers-by-customer-id-capabilities-by-capability-id)                         | 申請所選的能力            |
| Capabilities     | [`GET /v3/customers/{customerId}/capabilities/{capabilityId}`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id)                           | 讀取當前的能力狀態與待辦任務     |
| Capabilities     | [`GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id-applications) | 讀取機構申請與其待辦任務       |
| Tasks            | [`GET /v3/customers/{customerId}/tasks`](/api-reference/tasks/list-customer-tasks)                                                                                                  | 列出客戶所擁有的任務         |
| Tasks            | [`GET /v3/customers/{customerId}/tasks/{taskId}`](/api-reference/tasks/get-customer-task)                                                                                           | 讀取當前的要求與託管 session |
| Task Submissions | [`POST /v3/customers/{customerId}/tasks/{taskId}/submissions`](/api-reference/task-submissions/create-customer-task-submission)                                                     | 提交完整答覆             |
| Task Submissions | [`GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}`](/api-reference/task-submissions/get-customer-task-submission)                                          | 讀取經授權的答覆快照與結果      |
| Documents        | [`POST /v3/customers/{customerId}/documents`](/api-reference/documents/post-v3-customers-by-customer-id-documents)                                                                  | 上傳當前任務所要求的檔案       |

## 政策與實作指引

Simplified、Standard 與 Enhanced KYC 為政策層級。它們不會取代當前的能力、申請、任務、提交、要求或託管 session 狀態。

實作細節請依照[個人入駐指南](/zh-Hant/integration/onboarding/customers#individual-customers)、[能力與任務](/zh-Hant/integration/onboarding/capabilities-and-requirements#complete-current-tasks) 與[整合文件指南](/zh-Hant/integration/onboarding/capabilities-and-requirements#upload-documents)。


## Related topics

- [個人入駐總覽](/zh-Hant/knowledge-base/individual-onboarding/overview.md)
- [總覽](/zh-Hant/knowledge-base/compliance/overview.md)
- [KYC 狀態與工作流程](/zh-Hant/knowledge-base/individual-onboarding/status-and-workflow.md)
- [KYB 工作流程](/zh-Hant/knowledge-base/business-onboarding/kyb-workflow.md)
- [治理與角色](/zh-Hant/knowledge-base/compliance/governance-retention-and-privacy.md)