> ## 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.

# 고객

> 케이퍼빌리티, 계좌, 전송을 소유할 개인 또는 기업을 생성하세요.

페이인, 페이아웃 또는 발급 은행 계좌를 구축하기 전에 고객을 생성하세요. 케이퍼빌리티, 계좌, 전송은 그 고객으로 범위가 지정돼요. `externalId`를 시스템 내 해당 레코드로의 안정적인 매핑으로 사용하세요.

```bash theme={null}
export API_BASE='https://platform.swipelux.com'
export SWIPELUX_API_KEY='replace-with-your-api-key'
```

<h2 id="individual-customers">
  개인 고객
</h2>

개인은 `type`만 필요해요. 이미 알고 있는 프로필 필드를 포함하고, 현재 케이퍼빌리티나 태스크가 필요로 할 때만 추가하세요.

[`POST /v3/customers`](/api-reference/customers/post-v3-customers)로 고객을 생성하세요:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-user-123" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "type": "individual",
  "externalId": "user_123",
  "individual": {
    "firstName": "Amina",
    "lastName": "Diallo",
    "residenceCountry": "FR"
  }
}
JSON
```

반환된 `data.id`를 `CUSTOMER_ID`로 저장하세요. 정책 컨텍스트는 [개인 온보딩](/ko/knowledge-base/individual-onboarding/overview)을 참고하세요.

<h2 id="business-customers">
  기업 고객
</h2>

기업은 `business.legalName`이 필요해요. 동일한 동작으로 기업을 생성하세요:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-company-456" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "type": "business",
  "externalId": "company_456",
  "business": {
    "legalName": "Acme Payments SAS"
  }
}
JSON
```

반환된 `data.id`를 `CUSTOMER_ID`로 저장하세요. 정책과 문서 컨텍스트는 [기업 온보딩](/ko/knowledge-base/business-onboarding/overview)을 참고하세요.

## 기업 관계자 추가

이사, 소유자, 기타 기업 참여자가 알려지거나 요청되면 추가하세요. 이 예시는 [`POST /v3/customers/{customerId}/related-parties`](/api-reference/customers/post-v3-customers-by-customer-id-related-parties)로 이사를 생성해요:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/related-parties" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: related-party-director-001" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "partyType": "person",
  "roles": ["director"],
  "title": "Chief executive officer",
  "person": {
    "firstName": "Amina",
    "lastName": "Diallo",
    "residenceCountry": "FR"
  }
}
JSON
```

반환된 `data.id`를 `RELATED_PARTY_ID`로 저장하세요.

## 케이퍼빌리티에서 준비 상태 확인

고객은 API 내에서 검증이나 준비 상태를 별도로 갖지 않아요. 현재 프로필 데이터를 위해 [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id)로 고객을 조회한 뒤, 케이퍼빌리티와 그 `openTaskIds`를 사용해 고객이 다음에 무엇을 할 수 있는지 결정하세요.

```bash theme={null}
curl --request GET \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}"
```

다음으로, [케이퍼빌리티와 태스크](/ko/integration/onboarding/capabilities-and-requirements)로 넘어가 필요한 제품 결과를 발견하고 활성화하세요.


## Related topics

- [KYB 워크플로](/ko/knowledge-base/business-onboarding/kyb-workflow.md)
- [퀵스타트](/ko/integration/quickstart.md)
- [v3로 마이그레이션](/ko/api-reference/versioning/migrate-to-v3.md)
- [개인 온보딩 API 워크플로](/ko/knowledge-base/individual-onboarding/api-workflow.md)
- [거래 한도](/ko/knowledge-base/compliance/transaction-limits.md)