Skip to main content

개인 온보딩 API 워크플로

이 맵을 사용해 개인 KYC 정책을 현재 생성된 API 레퍼런스에 연결하세요. 정책 관점 라벨을 API 상태 머신으로 구현하는 대신 매 단계에서 현재 리소스를 따라주세요.

워크플로 맵

1. 개인 고객 생성

POST /v3/customers로 고객을 생성하세요. 반환된 customer id를 저장하고 GET /v3/customers/{customerId}로 현재 리소스를 조회하세요.

2. 자격 있는 케이퍼빌리티 발견 및 요청

GET /v3/customers/{customerId}/capabilities/supported를 조회하세요. 현재 availability와 eligibility가 요청을 허용할 때만 변형을 선택한 뒤 POST /v3/customers/{customerId}/capabilities/{capabilityId}를 사용하세요.

3. 현재 케이퍼빌리티와 애플리케이션 조회

GET /v3/customers/{customerId}/capabilities/{capabilityId}GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications를 조회하세요. 이전 응답에서 준비 상태를 가정하는 대신 현재 열린 task id를 따라주세요.

4. 현재 태스크 세부 정보 가져오기

GET /v3/customers/{customerId}/tasks로 고객 태스크를 나열하세요. GET /v3/customers/{customerId}/tasks/{taskId}로 승인된 조치 표면을 가져오세요. 태스크 세부 정보는 자사 호스팅 세션 URL과 현재 실행 가능한 요건을 노출할 수 있어요. 현재 리비전과 상태를 사용하세요.

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

태스크 세부 정보가 호스팅된 세션을 제공할 때, 필요한 세션 데이터만 클라이언트로 반환하고 API 키는 백엔드에 보관하세요. 태스크가 답변을 요구할 때는 POST /v3/customers/{customerId}/tasks/{taskId}/submissions로 완전한 불변 시도 하나를 생성하세요. GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}로 현재 제출과 그 공개 결과 하나를 조회하세요.

6. 요청될 때만 문서 업로드

현재 태스크가 요청할 때만 문서를 업로드하세요. POST /v3/customers/{customerId}/documents를 사용한 뒤, 반환된 document id를 해당 문서 답변에 넣으세요.

7. 현재 리소스 다시 조회

각 이벤트나 조치 후 현재 고객, 케이퍼빌리티, 애플리케이션, 태스크를 다시 조회하세요. 최신 상태, 사유, 요건, 열린 task id를 사용해 다음 단계를 선택하세요.

생성된 동작 맵

정책과 구현 가이드

Simplified, Standard, Enhanced KYC는 정책 티어예요. 현재 케이퍼빌리티, 애플리케이션, 태스크, 제출, 요건 또는 호스팅 세션 상태를 대체하지 않아요. 구현 세부 사항은 개인 온보딩 가이드, 케이퍼빌리티와 태스크, 통합 문서 가이드를 따르세요.