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

# Verification

> 지급 계정 자격을 위해 개인 또는 법인의 신원을 확인하는 데 사용되는 신원 인증 세션입니다.

> [!NOTE]
>
> 이 리소스에는 새 통합의 기반이 되어야 하는 버전 관리형 API인 [Whop API](https://docs.whop.com/ko/api-reference/legacy/verifications/verification.md)의 후속 리소스가 있습니다. 이 페이지는 계속 완전히 지원됩니다.

Verification은 계정이 지급을 받는 데 필요한 신원 확인 절차를 개인 또는 비즈니스가 진행하도록 안내합니다. 개인은 고객 확인(KYC) 절차를 완료하고, 비즈니스는 기업 확인(KYB) 절차를 완료합니다. 예를 들어 사용자의 첫 지급 전에 Verification을 생성합니다. 이름과 주소를 미리 채워 두면 사용자 지정 인증 UI 없이도 호스팅된 양식을 완료할 수 있습니다. 이후 동일한 Verification을 사용하여 인증된 신원 데이터를 조회하고 다운스트림 지급 제공업체의 [RFI](https://docs.whop.com/ko/developer/verification/rfis.md)에 응답할 수 있습니다.

계정이 거래 전에 인증을 받아야 할 때, 일반적으로 첫 [지급](https://docs.whop.com/ko/api-reference/payouts/payout) 전에 Verification을 생성합니다. 생성하기 전에 원장 계정이 있는 [계정](https://docs.whop.com/ko/api-reference/accounts/account)이 있는지 확인하세요(원장 계정은 계정을 생성할 때 자동으로 생성됩니다). 같은 계정에 동일한 `kind`의 Verification을 여러 개 생성하지 마세요. 각 계정은 최대 하나의 활성 개인(KYC) 프로필과 하나의 비즈니스(KYB) 프로필을 지원합니다. Verification은 사용자가 절차를 완료하는 동안 여러 상태를 거칩니다: KYC를 진행하는 동안 `pending`, 신원이 확인되면 `approved`, 제공업체가 거절하면 `rejected`, 지급 제공업체가 은행 명세서나 납세자 번호 같은 추가 정보를 요구하면 `action_required`입니다.

Verification이 성공하면 이름, 생년월일, 국가, 주소가 확인된 완전히 인증된 신원이 생성되어 계정의 [지급](https://docs.whop.com/ko/api-reference/legacy/payout-accounts/payout-account.md)이 활성화됩니다. 미리 채우기 필드(`first_name`, `address` 등)와 함께 Verification을 생성하면 인증과 호스팅된 KYC 양식 모두에 자동으로 값이 채워지므로, 사용자가 이미 가지고 있는 정보를 다시 입력할 필요가 없습니다. 상태 변경에 실시간으로 대응하려면 폴링 대신 `identity_profile.approved` 및 `identity_profile.rejected` [웹훅](https://docs.whop.com/ko/api-reference/legacy/webhooks/webhook.md)을 수신하는 것을 권장합니다. Verification을 사용하면 기본 KYC 제공업체와 규정 준수 요구 사항이 시간이 지나며 변경되더라도 단일 API 통합으로 사용자를 지급에 온보딩할 수 있습니다.

## 엔드포인트

| 메서드 | 경로 | 설명 |
| - | - | - |
| `GET` | `/verifications?account_id={biz_ tag}` | 계정의 [인증 목록 조회](https://docs.whop.com/ko/developer/verification/retrieve.md) |
| `GET` | `/verifications/{verification_id}` | `idpf_` 태그로 [단일 인증 조회](https://docs.whop.com/ko/developer/verification/retrieve.md) |
| `POST` | `/verifications` | [인증 생성](https://docs.whop.com/ko/developer/verification/overview.md) 및 KYC/KYB 세션 시작 |
| `PATCH` | `/verifications/{verification_id}` | [신원 필드 업데이트 또는 RFI 응답](https://docs.whop.com/ko/developer/verification/manage.md) |
| `DELETE` | `/verifications/{verification_id}` | [소프트 삭제](https://docs.whop.com/ko/developer/verification/manage.md) 및 계정에서 연결 해제 |

## 상태

| 상태 | 설명 | 다음 단계 |
| - | - | - |
| `not_started` | 인증은 존재하지만 KYC 세션이 시작되지 않음 | `POST /verifications`를 호출하여 시작 |
| `pending` | 사용자가 `session_url`에서 KYC를 완료해야 함 | 사용자를 `session_url`로 리디렉션 |
| `approved` | KYC 통과 — 계정이 거래 가능 | 조치 필요 없음 |
| `rejected` | 제공업체가 KYC를 거절함 | `restart: true`와 함께 `POST /verifications` 호출 |
| `action_required` | 지급 제공업체가 추가 정보를 요구함 | `rfis` 배열을 확인하고 [응답](https://docs.whop.com/ko/developer/verification/rfis.md) |

```json Example theme={null}
{
	"id": "verf_xxxxxxxxxxxxx",
	"last_error_code": "abandoned",
	"last_error_reason": "Document image was too blurry to read.",
	"status": "requires_input"
}
```

**id** `string` *required*

인증 기록의 숫자 ID입니다.

예시: `verf_xxxxxxxxxxxxx`

**last\_error\_code** `VerificationErrorCodes | null` *required*

인증 중 반환된 가장 최근 오류 코드입니다. 오류가 발생하지 않은 경우 Null입니다.

사용 가능한 옵션: `abandoned`, `consent_declined`, `country_not_supported`, `device_not_supported`, `document_expired`, `document_type_not_supported`, `document_unverified_other`, `email_unverified_other`, `email_verification_declined`, `id_number_insufficient_document_data`, `id_number_mismatch`, `id_number_unverified_other`, `phone_unverified_other`, `phone_verification_declined`, `selfie_document_missing_photo`, `selfie_face_mismatch`, `selfie_manipulated`, `selfie_unverified_other`, `under_supported_age`

**last\_error\_reason** `string | null` *required*

가장 최근 인증 오류에 대한 사람이 읽을 수 있는 설명입니다. 오류가 발생하지 않은 경우 Null입니다.

예시: `Document image was too blurry to read.`

**status** `VerificationStatuses` *required*

이 인증 세션의 현재 상태입니다.

사용 가능한 옵션: `requires_input`, `processing`, `verified`, `canceled`, `created`, `started`, `submitted`, `approved`, `declined`, `resubmission_requested`, `expired`, `abandoned`, `review`, `action_required`, `manual_review`


## Related topics

- [Verifications](https://docs.whop.com/ko/elements/latest/verifications/overview.md)
- [Create Verification](https://docs.whop.com/ko/api-reference/verifications/create-verification.md)
- [Verifications API](https://docs.whop.com/ko/api-reference/verifications/verification.md)
