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

# 인증 RFI 처리하기

> Whop이 문서, 세금 ID, 사업체 정보 같은 추가 정보를 요청할 때 응답하세요.

Whop은 사용자에게 문서, 세금 ID, 사업체 정보 같은 추가 정보가 필요할 때 \*\*정보 요청(RFI, Request for Information)\*\*을 생성합니다. 열려 있는 각 RFI는 인증의 `requested_information` 배열에 표시됩니다. 사용자가 모든 항목에 답할 때까지 인증의 `status`는 `action_required`로 유지됩니다.

각 항목은 수집할 하나의 정보를 나타내며, 한 번의 쓰기로 답합니다. `requirement`는 필요한 것을, 입력 `type`은 수집 방법을, `label`은 사용자에게 보여 줄 텍스트를 제공합니다. 응답에서는 항목에 해당하지 않는 키가 생략됩니다. 전체 목록은 [모든 요구 사항](#every-requirement)을 참고하세요.

## RFI 작동 방식

**1. 정보가 요청됨**

Whop이 무언가가 필요하다고 표시합니다. 인증 상태가 `action_required`로 바뀌고 `identity_profile.updated` 웹훅이 발생합니다. (이 전환에는 `identity_profile.needs_action`도 발생하지만, `identity_profile.updated`는 모든 상태 변경을 포괄하는 웹훅입니다. 이를 구독하고 인증을 다시 가져와 남은 항목을 확인하세요.)

**2. 항목 읽기**

`GET /api/v1/verifications?account_id={biz_ tag}`를 호출하세요. 각 인증의 `requested_information` 배열에 필요한 것과 수집할 답변 유형이 나열됩니다.

**3. 수집 및 제출**

사용자에게서 정보를 받아 `requested_information` 배열과 함께 `PATCH /api/v1/verifications/{id}`로 다시 보내세요. Whop이 각 답변을 올바른 곳으로 전달합니다.

**4. 검토 계속**

답변한 항목은 배열에서 사라집니다. 배열이 비면 답변을 검토하는 동안 인증이 `processing`으로 이동하며, 이 상태에서는 제출할 것이 없습니다. 최종적으로 `approved`가 되거나, 컴플라이언스 검토가 시작되면 `manual_review`가 됩니다. 답변이 거부되면 해당 항목은 이유를 설명하는 `errors`와 함께 `action_required`로 돌아갑니다. 다시 제출하세요.

## RFI 읽기

```bash cURL theme={null}
curl "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

RFI가 남아 있을 때 인증은 다음과 같습니다.

```json theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "action_required",
  "requested_information": [
    {
      "id": "inrqi_xxxxxxxxxxxxx",
      "requirement": "date_of_birth",
      "type": "date",
      "label": "Date of Birth"
    },
    {
      "id": "inrqi_yyyyyyyyyyyyy",
      "requirement": "business_structure",
      "type": "select",
      "label": "Business Structure",
      "options": ["single_member_llc", "multi_member_llc", "sole_proprietorship", "private_corporation"]
    },
    {
      "id": "inrqi_zzzzzzzzzzzzz",
      "requirement": "bank_statement",
      "type": "files",
      "label": "Bank Statement for account ending in 4242"
    }
  ]
}
```

### 항목 필드

| 필드 | 설명 |
| - | - |
| `id` | `inrqi_` 접두사가 붙은 항목 식별자. 답변을 제출할 때 포함하세요 |
| `requirement` | `ssn`이나 `bank_statement`처럼 Whop에 필요한 것. [모든 요구 사항](#every-requirement)을 참고하세요 |
| `type` | 다시 보낼 내용: `files`, `id_document`, `text`, `date`, `phone`, `select` 또는 `address` |
| `label` | 사용자에게 보여 줄 내용. 검토자의 메모가 있으면 이를 포함합니다 |
| `options` | `select` 항목에 허용되는 값 또는 `id_document` 항목에서 허용되는 ID 유형 |
| `optional` | 사용자가 항목을 건너뛸 수 있을 때 `true`로 표시됩니다 |
| `errors` | 답변이 거부된 후 표시되며, 각각 안정적인 `code`와 사람이 읽을 수 있는 `reason`을 포함합니다 |

응답은 항목에 해당하는 키만 반환하므로, 항목에 확인해야 할 빈 배열이나 `null`이 포함되는 일은 없습니다.

응답은 열려 있는 항목만 반환합니다. 답변한 항목은 배열에서 사라지므로, 배열에 있는 항목은 모두 사용자가 아직 제출해야 하는 것입니다. 배열이 빌 때까지 인증은 `action_required`로 유지됩니다.

## RFI에 답하기

`requested_information` 배열과 함께 인증의 `idpf_` 태그로 `PATCH`를 보내세요. 각 항목에는 항목 `id`와 항목의 `type`에 맞는 정확히 하나의 답변 페이로드가 필요합니다.

| 항목 `type` | 답변 페이로드 |
| - | - |
| `files` | `files`: 하나의 문서를 페이지 목록으로 |
| `id_document` | `documents`: 업로드하는 ID의 슬롯 키 |
| `text`, `date`, `phone`, `select` | `value` |
| `address` | `address` 객체 |

항목의 다른 정보(카테고리나 문서 유형 등)는 다시 보낼 필요가 없습니다. 항목 `id`로 Whop이 답변이 속한 곳을 알 수 있습니다.

한 번의 요청으로 여러 항목에 답할 수 있습니다.

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_xxxxxxxxxxxxx", "value": "1990-01-15" },
      { "id": "inrqi_yyyyyyyyyyyyy", "value": "single_member_llc" }
    ]
  }'
```

### 텍스트, 날짜, 전화번호, 선택 값

답변을 `value`로 전달하세요. 날짜는 `YYYY-MM-DD`, 전화번호는 E.164 형식(`+12125550123`)을 사용하며, 선택 값은 항목의 `options` 중 하나여야 합니다.

### 주소

`address` 객체를 전달하세요.

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      {
        "id": "inrqi_xxxxxxxxxxxxx",
        "address": {
          "line1": "123 Spring Street",
          "city": "New York",
          "state": "NY",
          "postal_code": "10012",
          "country": "US"
        }
      }
    ]
  }'
```

개인 또는 사업체 주소에는 사서함(PO box)을 사용할 수 없습니다.

### 문서

[먼저 파일을 업로드](https://docs.whop.com/ko/developer/guides/upload-files.md)한 다음 `files`에 해당 ID를 전달하세요.

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_zzzzzzzzzzzzz", "files": ["file_xxxxxxxxxxxxx"] }
    ]
  }'
```

각 항목에는 [업로드 흐름](https://docs.whop.com/ko/developer/guides/upload-files.md)에서 받은 `file_` ID 또는 직접 업로드에서 받은 `direct_upload_id`를 사용합니다. 문서는 최대 32MB의 JPEG(Joint Photographic Experts Group), PNG(Portable Network Graphics) 또는 PDF 파일이어야 합니다. 한 페이지 문서는 항목이 하나인 목록이며, 별도의 단일 파일 필드는 없습니다.

`requirement`가 Whop에 필요한 문서를 지정하고 나머지는 Whop이 처리하므로, 업로드한 문서의 종류를 명시할 필요가 없습니다.

#### 여러 페이지로 된 문서

여러 페이지로 된 문서는 같은 `files` 목록에 페이지 순서대로 넣습니다.

```json theme={null}
{ "id": "inrqi_aaa", "requirement": "business_verification_document", "type": "files",
  "label": "Company Verification Document" }
```

```json theme={null}
{ "id": "inrqi_aaa", "files": ["file_page1xxxxxx", "file_page2xxxxxx"] }
```

#### 신원 확인 문서

`id_document` 항목은 어떤 ID인지 묻습니다. 검토에서 허용하는 ID 유형을 나열한 `options`를 포함하며, 답변에서는 [인증 만들기](https://docs.whop.com/ko/api-reference/verifications/create-verification.md)가 받는 것과 같은 키로 각 슬롯을 지정합니다.

```json theme={null}
{
  "id": "inrqi_bbb",
  "requirement": "identity_document",
  "type": "id_document",
  "label": "Identity Document",
  "options": ["ID_CARD", "DRIVERS", "RESIDENCE_PERMIT", "PASSPORT"]
}
```

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      {
        "id": "inrqi_bbb",
        "documents": {
          "drivers_front": "file_frontxxxxxxx",
          "drivers_back": "file_backxxxxxxxx"
        }
      }
    ]
  }'
```

키가 문서와 면을 동시에 지정하므로, 문서가 어떤 ID인지 나타내는 별도의 필드는 없습니다. Whop이 키로부터 이를 파악합니다. 업로드하는 문서의 모든 슬롯을 보내세요.

| ID 유형 | 슬롯 |
| - | - |
| `PASSPORT` | `passport_front` |
| `ID_CARD` | `id_card_front`, `id_card_back` |
| `DRIVERS` | `drivers_front`, `drivers_back` |
| `RESIDENCE_PERMIT` | `residence_permit_front`, `residence_permit_back` |

Whop은 두 문서의 슬롯이 섞여 있거나 불완전한 문서는 아무것도 저장하기 전에 거부합니다. 항목의 `options`에 해당 검토에서 허용하는 ID 유형이 나와 있습니다.

파일 항목에 `options`가 없으면 `value`가 필요하지 않습니다.

### 민감한 값

세금 및 정부 ID 번호(`ssn`, `ein`, `company_tax_id`, `personal_id_number`)는 다른 값과 똑같이 제출하세요. Whop은 전송 중에 이를 보안 토큰으로 대체하고 보안 참조만 저장합니다.

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_xxxxxxxxxxxxx", "value": "123-45-6789" }
    ]
  }'
```

이미 직접 값을 토큰화하고 있다면(Basis Theory), 대신 `value_type: "vault_token"`과 함께 토큰 ID를 전달하세요.

## 거부된 답변

Whop이 제출된 답변을 거부하면, 해당 항목은 `errors`가 설정된 상태로 `requested_information`에 돌아옵니다.

```json theme={null}
{
  "id": "inrqi_xxxxxxxxxxxxx",
  "requirement": "business_website",
  "type": "text",
  "label": "Business website or social profile",
  "errors": [
    {
      "code": "invalid_url_website_inaccessible",
      "reason": "The website provided could not be reached."
    }
  ]
}
```

사용자에게 `reason`을 보여 주고, 필요하면 `code`에 따라 분기하세요. 인식할 수 없는 코드는 일반적인 거부로 처리하세요.

근본적인 문제를 해결하고 같은 항목 `id`로 다시 제출하세요. Whop이 수정된 답변을 수락할 때까지 인증은 `action_required`로 유지됩니다.

### 문서 거부 코드

Whop이 업로드된 문서를 거부하면 `code`가 무엇이 잘못되었는지 알려 줍니다. 받을 수 있는 코드는 다음과 같습니다.

| 코드 | 의미 |
| - | - |
| `bad_proof_of_identity` | Whop이 해당 신원 증명을 허용하지 않음. 정부 발급 사진 신분증을 제공하세요 |
| `expiration_date` | 문서가 만료됨 |
| `unsatisfactory_photos` | 너무 불분명해 읽을 수 없음 |
| `problematic_applicant_data` | 제출된 정보가 문서와 일치하지 않음 |
| `screenshots` | 사용자가 문서 사진 대신 스크린샷을 업로드함 |
| `graphic_editor` | 문서가 편집된 것으로 보임 |
| `digital_document` | 사용자가 디지털 사본을 업로드함. 실물 문서의 사진을 제공하세요 |
| `document_damaged` | 손상되었거나 일부를 읽을 수 없음 |
| `document_page_missing` | 페이지가 누락됨 |
| `document_missing` | 문서를 받지 못함 |
| `not_document` | 파일이 문서가 아님 |
| `id_invalid` | 신원 확인 문서가 유효하지 않음 |
| `incompatible_language` | 지원되지 않는 언어. 공인 번역본을 제공하세요 |
| `bad_selfie` | 셀피가 불분명함 |
| `bad_face_matching` | 셀피가 문서의 사진과 일치하지 않음 |
| `bad_proof_of_address` | 허용되는 주소 증명이 아님 |
| `wrong_address` | 주소가 문서와 일치하지 않음 |
| `incorrect_social_number` | 납세자 식별 번호가 문서와 일치하지 않음 |
| `company_incorrect_data` | 계정 정보가 등록 문서와 일치하지 않음 |
| `company_data_mismatch` | 계정 정보가 Whop의 기록과 일치하지 않음 |
| `company_inactive_entity` | 등기부에 계정이 활성 상태로 등재되어 있지 않음 |
| `additional_document_required` | Whop에 다른 문서가 필요함 |
| `more_documents_required` | Whop에 더 많은 문서가 필요함 |
| `db_data_mismatch` | 제출된 정보가 공식 기록과 일치하지 않음 |
| `spam` | Whop이 제출물을 처리할 수 없음 |

여기의 모든 코드는 업로드에서 수정 가능한 문제를 설명합니다. Whop이 이 중 하나로 분류할 수 없는 거부는 사용할 수 없는 코드 대신 `errors` 없이 반환됩니다. `errors`가 없는 항목도 항상 처리하고, 사용자에게 보여 줄 텍스트로는 `reason`을 우선 사용하세요.

## 모든 요구 사항

각 항목의 `requirement`는 아래 값 중 하나입니다.

### 개인 정보

| 요구 사항 | 유형 | 제출할 내용 |
| - | - | - |
| `first_name` | `text` | 첫 글자를 대문자로 쓴 법적 이름(`Jane`) |
| `last_name` | `text` | 첫 글자를 대문자로 쓴 법적 성(`Doe`) |
| `creator_legal_name` | `text` | 공식 문서에 표시된 전체 법적 이름 |
| `date_of_birth` | `date` | `YYYY-MM-DD` |
| `email` | `text` | 이메일 주소 |
| `creator_email_address` | `text` | Whop이 사용자에게 연락할 수 있는 이메일 주소 |
| `phone_number` | `phone` | 국가 코드를 포함한 E.164 형식(`+12125550123`) |
| `personal_address` | `address` | 현재 거주지 주소. 사서함은 불가 |
| `occupation` | `text` | 표준 직업 분류 코드(`15-1132`) 또는 `SELFEMP`, `STUDENT`, `RETIRED`, `UNEMPLO`, `OTHERXX` |
| `annual_salary` | `text` | 미국 달러 기준 대략적인 연 소득(숫자만) |

### 세금 및 정부 식별 번호

Whop은 전송 중에 이 값들을 보안 토큰으로 대체합니다. [민감한 값](#sensitive-values)을 참고하세요.

| 요구 사항 | 유형 | 제출할 내용 |
| - | - | - |
| `ssn` | `text` | 미국 사회보장번호, `XXX-XX-XXXX` |
| `ein` | `text` | 미국 고용주 식별 번호, `XX-XXXXXXX` |
| `company_tax_id` | `text` | 발급 국가 형식의 계정 세금 ID |
| `personal_id_number` | `text` | 정부 발급 개인 ID 번호(여권, 운전면허증, 국가 신분증) |
| `personal_id_number_country` | `select` | ID 번호를 발급한 국가. `options`에서 선택하세요 |
| `country_of_issue` | `text` | 발급 국가의 두 글자 국가 코드(`US`) |

### 신원 확인 문서

| 요구 사항 | 유형 | 제출할 내용 |
| - | - | - |
| `identity_document` | `id_document` | 정부 발급 사진 신분증. 사용자가 업로드하는 ID의 슬롯 키와 함께 `documents`를 보내세요 |
| `selfie` | `files` | 신분증을 들고 있는 사용자의 사진 |

### 사업체 정보

| 요구 사항 | 유형 | 제출할 내용 |
| - | - | - |
| `business_name` | `text` | 사업체의 등록된 법적 이름 |
| `trade_name` | `text` | 법적 이름과 다른 경우 대외적으로 사용하는 이름(DBA, doing business as) |
| `company_title` | `text` | 계정 이름 |
| `business_structure` | `select` | 법적 구조. `options` 중 하나(예: `single_member_llc`, `sole_proprietorship`, `private_corporation`) |
| `account_type` | `select` | `individual`, `company` 또는 `non_profit` |
| `business_representative_title` | `select` | 대표자의 직함. `options` 중 하나(예: `CEO`, `Owner`, `Manager`) |
| `industry_type` | `text` | 사업체가 운영되는 업종 |
| `business_description` | `text` | 100\~1000자: 판매하는 것, 고객이 결제 후 받는 것, 고객이 접근하는 곳 |
| `product_description` | `text` | 판매하는 상품 또는 서비스 |
| `business_phone_number` | `phone` | 국가 코드를 포함한 E.164 형식 |
| `business_address` | `address` | 등록된 사업체 주소. 사서함은 불가 |
| `business_website` | `text` | 사업체 웹사이트 URL |
| `social_media_or_website` | `text` | 판매하는 것을 보여 주는 웹사이트 또는 공개 소셜 프로필 |
| `store_page_url` | `text` | 스토어 또는 상품 페이지 링크 |
| `expected_monthly_volume` | `text` | 미국 달러 기준 예상 월 처리량(숫자만) |
| `account_purpose` | `text` | 계정의 주요 용도 |

### 사업체 문서

| 요구 사항 | 유형 | 제출할 내용 |
| - | - | - |
| `business_verification_document` | `files` | 계정의 법적 신원을 확인하는 문서: 미국 국세청(IRS) Letter 147C, SS-4 또는 고용주 식별 번호(EIN) Assistance Letter |
| `business_incorporation_papers` | `files` | 공식 법인 설립 문서 |
| `ownership_structure` | `files` | 사업체 소유자를 보여 주는 문서 |
| `processing_statements` | `files` | 처리 내역을 보여 주는 이전 결제 처리업체의 명세서. 은행 거래 내역서는 아님 |
| `proof_of_fulfillment` | `files` | 고객이 구매 후 받는 것을 보여 주는 스크린샷, 녹화본 또는 파일 |
| `proof_of_funnel` | `text` 또는 `files` | 고객의 유입 경로: 소셜 계정, 웹사이트 또는 랜딩 페이지 |

### 지급 계정 문서

지급 대상을 인증하기 위해 요청되는 문서는 문서 자체를 지정합니다. 파일 하나를 업로드하세요. `label`이 사용자에게 어떤 계정에 대한 것인지 알려 줍니다.

| 요구 사항 | 유형 | 제출할 내용 |
| - | - | - |
| `bank_statement` | `files` | 지급 계정의 최근 은행 거래 내역서 |
| `paper_check` | `files` | 무효 처리된 종이 수표 |
| `wallet_screenshot` | `files` | 지갑 또는 계정 잔액 스크린샷 |
| `government_id` | `files` | 정부 발급 신분증 |
| `proof_of_address` | `files` | 최근 3개월 이내에 발급된 주소 증명 |
| `utility_bill` | `files` | 최근 3개월 이내에 발급된 공과금 청구서 |
| `insurance_card` | `files` | 최근 3개월 이내에 발급된 보험 카드 |
| `company_documents` | `files` | 계정 또는 법인 문서 |

### 검토 질문

| 요구 사항 | 유형 | 제출할 내용 |
| - | - | - |
| `anything_else` | `text` 또는 `files` | 검토팀이 알아야 할 기타 사항 |
| `accept_tos` | `text` | 사용자가 서비스 약관에 동의한다는 확인 |
| `signature` | `files` | 계약서 서명 이미지 |


## Related topics

- [앱 설치](https://docs.whop.com/ko/developer/guides/app-installations.md)
- [푸시 알림](https://docs.whop.com/ko/developer/guides/notifications.md)
- [일회성 결제 받기](https://docs.whop.com/ko/developer/guides/ios/accept-one-time-payments.md)
