> ## 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)를 조회하세요. 현재 availability와 eligibility가 요청을 허용할 때만 변형을 선택한 뒤 [`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)를 조회하세요. 이전 응답에서 준비 상태를 가정하는 대신 현재 열린 task 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)로 승인된 조치 표면을 가져오세요.

태스크 세부 정보는 자사 호스팅 세션 URL과 현재 실행 가능한 요건을 노출할 수 있어요. 현재 리비전과 상태를 사용하세요.

### 5. 호스팅된 세션 완료 또는 태스크 답변 제출

태스크 세부 정보가 호스팅된 세션을 제공할 때, 필요한 세션 데이터만 클라이언트로 반환하고 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. 현재 리소스 다시 조회

각 이벤트나 조치 후 현재 고객, 케이퍼빌리티, 애플리케이션, 태스크를 다시 조회하세요. 최신 상태, 사유, 요건, 열린 task 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)                                       | 현재 availability와 eligibility 발견 |
| 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)                                                                                           | 현재 요건과 호스팅된 세션 조회               |
| 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는 정책 티어예요. 현재 케이퍼빌리티, 애플리케이션, 태스크, 제출, 요건 또는 호스팅 세션 상태를 대체하지 않아요.

구현 세부 사항은 [개인 온보딩 가이드](/ko/integration/onboarding/customers#individual-customers), [케이퍼빌리티와 태스크](/ko/integration/onboarding/capabilities-and-requirements#complete-current-tasks), [통합 문서 가이드](/ko/integration/onboarding/capabilities-and-requirements#upload-documents)를 따르세요.


## Related topics

- [KYC 상태와 워크플로](/ko/knowledge-base/individual-onboarding/status-and-workflow.md)
- [개인 온보딩 개요](/ko/knowledge-base/individual-onboarding/overview.md)
- [KYB 워크플로](/ko/knowledge-base/business-onboarding/kyb-workflow.md)
- [개요](/ko/knowledge-base/compliance/overview.md)
- [거버넌스와 역할](/ko/knowledge-base/compliance/governance-retention-and-privacy.md)
