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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# KYC로 사용자 신원 인증하기

> 사용자가 지급을 받기 전에 신원을 인증하세요. API 호출 한 번으로 KYC(Know Your Customer) 인증이 시작되고, 나머지는 Whop이 모두 처리합니다.

## 작동 방식

**1. 인증 시작하기**

인증하려는 계정으로 `POST /api/v1/verifications`를 호출하세요. `session_url`을 돌려받습니다.

**2. 사용자를 보내 KYC 완료하기**

사용자를 `session_url`로 리디렉션하세요. 사용자는 호스팅 페이지에서 신분증을 업로드하고, 셀피를 찍고, 신원을 인증합니다. 이를 위해 UI를 만들 필요가 없습니다.

**3. 결과 수신하기**

`identity_profile.updated` 웹훅을 구독하세요. 이 웹훅은 프로필이 변경될 때마다(승인, 거부, 조치 필요, 검토 시작 또는 해제) 발생합니다. 웹훅은 새 상태가 아니라 *어떤* 프로필이 변경되었는지 알려 주므로, `GET /api/v1/verifications?account_id={biz_ tag}`를 호출해 현재 상태와 인증된 신원 데이터를 읽으세요.

## 빠른 예시

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "individual"}'
```

```json Response theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "pending",
  "session_url": "https://in.sumsub.com/websdk/p/sbx_xxxxxxxxxxxxx",
  "created_at": "2026-06-03T22:15:00Z",
  "updated_at": "2026-06-03T22:15:00Z"
}
```

> [!NOTE]
>
> `identity:write` 스코프가 있는 계정 API 키가 필요합니다. 자격 증명 유형과 스코프 지정 방법은 [인증 및 API 키](https://docs.whop.com/ko/developer/guides/auth-scoping.md)를 참고하세요. 키를 만들려면 [대시보드](https://whop.com/dashboard) → Settings → API Keys로 이동하세요.

## 신원 인증 양식 미리 채우기

신원 필드를 전달하면 사용자가 일부 단계를 건너뛸 수 있습니다. 이 값들이 인증 양식에 미리 입력되므로 사용자가 이름과 주소를 다시 입력할 필요가 없습니다.

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "individual",
    "first_name": "Jane",
    "last_name": "Doe",
    "date_of_birth": "1995-01-15",
    "country": "US",
    "tax_identification_number": "123-45-6789",
    "address": {
      "line1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105"
    }
  }'
```

> [!NOTE]
>
> `tax_identification_number`는 해당 사람의 납세자 식별 번호(미국 개인의 경우 SSN)이며,
> **`country`가 `US`인 경우 필수**입니다. 이 값이 없으면 지급 계정을 만들 수 없습니다.
> 있는 그대로 보내세요. 전송 중에 토큰화되며, 원래 값은 Whop 시스템에 절대 저장되지 않습니다.

> [!WARNING]
>
> Whop은 [제재 대상 국가 또는 지역](https://docs.whop.com/ko/trust-and-safety/trust-safety-overview/sanctioned-countries.md)의 사용자를 지원할 수 없습니다.
> 요청은 `400`과 오류 코드 `address_country_sanctioned`로 실패합니다.

## 이미 보유한 인증 재사용하기

이미 Sumsub으로 이 사람을 인증했다면, KYC를 다시 거치게 하는 대신 공유 토큰을 보내세요.
Whop은 Sumsub 계정이 증명한 신원을 가져와 Whop 자체 요구 사항에 맞는지 확인합니다.

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "individual", "share_token": "_act-sbx-jwt-eyJhbGciOiJub25l"}'
```

```json Response theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "approved",
  "first_name": "Jane",
  "last_name": "Doe",
  "created_at": "2026-06-03T22:15:00Z",
  "updated_at": "2026-06-03T22:15:00Z"
}
```

**1. Whop과 재사용 가능한 KYC 합의하기**

Sumsub은 재사용 가능한 KYC(Reusable KYC) 계약을 맺은 클라이언트 간에만 신청자 데이터를 공개합니다.
계약이 체결되면 Whop이 공유 대상 클라이언트 ID를 제공합니다.

**2. 신청자의 공유 토큰 생성하기**

자체 Sumsub 계정에서 신청자의 ID와 Whop의 클라이언트 ID를 `forClientId`로 지정해
`POST https://api.sumsub.com/resources/accessTokens/shareToken`을 호출하세요.

**3. Whop에 보내기**

토큰을 `share_token`으로 전달하세요. 각 토큰은 한 번만 사용할 수 있습니다.

응답을 보면 결과를 알 수 있습니다. `approved`는 기존 인증이 Whop에 필요한 모든 것을 충족했으며
더 할 일이 없다는 뜻입니다. `session_url`과 함께 `pending`이 반환되면 일부만 충족되었다는 뜻이므로,
사용자를 해당 URL로 보내 아직 누락된 부분만 완료하게 하세요. 데이터가 요구 사항을 전혀 충족하지
못하는 토큰은 Whop이 `400`으로 거부합니다.

> [!NOTE]
>
> `share_token`은 `documents` 또는 `document_type`과 함께 사용할 수 없습니다. 각각이
> 호스팅 흐름을 완전히 대체하는 방법입니다.

## 두 가지 인증 유형

| 유형 | `kind` | 인증 대상 | 사용 시점 |
| - | - | - | - |
| 개인(KYC) | `individual` | 사람의 신원 | 사용자가 자금을 인출하려는 경우 |
| 사업체(KYB) | `business` | 사업체 | 계정이 법인을 인증해야 하는 경우 |

계정은 각 유형을 하나씩, 즉 개인 KYC 하나와 사업체 KYB 하나를 가질 수 있습니다.

## 다음 단계

> [card] [상태 확인](https://docs.whop.com/ko/developer/verification/retrieve.md)
>
> 인증 상태를 확인하고 인증된 신원 데이터를 읽으세요.

> [card] [RFI 처리](https://docs.whop.com/ko/developer/verification/rfis.md)
>
> Whop이 은행 거래 내역서 같은 추가 정보를 요청할 때 응답하세요.

> [card] [업데이트 및 삭제](https://docs.whop.com/ko/developer/verification/manage.md)
>
> 신원 필드를 업데이트하거나 인증을 제거하세요.

> [card] [API 레퍼런스](https://docs.whop.com/ko/api-reference/verifications/verification)
>
> 인증 객체의 전체 필드 레퍼런스.


## Related topics

- [Whop 앱에서 사용자 인증하기](https://docs.whop.com/ko/developer/guides/authentication.md)
- [인증 상태 확인](https://docs.whop.com/ko/developer/verification/retrieve.md)
- [하위 계정 지급 활성화](https://docs.whop.com/ko/developer/platforms/render-payout-portal.md)
