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

# 앱 권한 요청하기

> 앱에 필요한 권한을 구성하고 앱을 설치하는 크리에이터에게 승인을 요청하세요.

앱은 권한을 사용하여 계정 데이터에 접근하고 사용자를 대신해 작업을 수행합니다. 모든 API 호출에는 해당하는 권한이 필요합니다. 앱 설정에서 필요한 권한을 선언하면 크리에이터가 설치 시 이를 승인하며, 크리에이터가 해당 권한을 부여한 후에만 SDK 호출이 성공합니다.

> [!TIP]
>
> 모든 엔드포인트에 필요한 권한은 API 레퍼런스에서 확인할 수 있습니다. 각 작업 페이지의 "Required permissions" 아래에 나열되어 있습니다.

## 필수 및 선택 권한

각 권한을 필수 또는 선택으로 표시할 수 있습니다. 이 선택에 따라 크리에이터의 설치 경험이 달라집니다.

| 유형 | 크리에이터가 설치 시 비활성화 가능 | 사용 시점 |
| - | - | - |
| **필수** | 아니요 | 이 범위 없이는 앱이 작동할 수 없는 경우 |
| **선택** | 예 | 범위가 핵심 흐름이 아닌 부가 기능을 지원하는 경우(예: 분석 옵트인) |

선택 권한은 옵트인 기능에 적합합니다. 크리에이터가 선택 권한을 거부하더라도 앱은 해당 기능 없이 계속 작동해야 합니다.

## 권한 설정하기

> [!WARNING]
>
> 자신의 계정에서 테스트할 때도 권한 흐름이 필요합니다. 설치와 자체 테스트에서 동일한 흐름을 거치므로 누락된 범위를 일찍 발견할 수 있습니다.

**1. 앱의 권한 탭 열기**

1. [개발자 대시보드](https://whop.com/dashboard/developer)로 이동하세요.
2. 앱을 선택하거나 새로 만드세요.
3. **Permissions** 탭을 선택하세요.

![권한 설정](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=514a98987e714d5a2542b3d7665020f7)

**2. 필요한 권한 추가하기**

**Add permissions**를 선택하고, 앱에 필요한 항목을 선택한 다음 확인하세요.

호출할 API 엔드포인트를 상호 확인하고 해당 엔드포인트에 필요한 모든 권한을 추가하세요.

**3. 각 권한 구성하기**

각 권한마다 다음을 수행하세요:

1. 앱에 해당 권한이 필요한 이유를 설명하는 짧은 사유를 작성하세요. 크리에이터는 설치 시 이를 보게 되며, [App Store 등록 요구 사항](https://docs.whop.com/ko/developer/apps/listing-requirements.md)을 충족하려면 각 권한마다 별도의 사유가 필요합니다.
2. **필수** 또는 **선택**으로 표시하세요.

![권한 사유](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings-justification.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=93ec46a13be088ad236a7fe69f6f6ad2)

**4. 저장하기**

![권한 설정 저장](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-settings-save.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=683b42f4dcfed0eeee535d82dcce3e5f)

**5. 테스트 계정에 설치하기**

직접 설치 링크를 방문하세요: `https://whop.com/apps/app_xxxxxxxxx/install`.

계정을 선택하고, 권한 프롬프트를 검토한 다음 승인하세요.

![권한 프롬프트](https://mintcdn.com/whop/CTin6M1qeROeLXJs/images/app-permissions-oauth.png?fit=max\&auto=format\&n=CTin6M1qeROeLXJs\&q=85\&s=4b427b52f269ee6b92fcf7434069ad43)

## 나중에 권한 업데이트하기

앱이 발전함에 따라 권한이 변경될 수 있습니다. 새 권한을 추가하면:

* 기존 설치에서는 앱 옆에 **Re-approve** 버튼이 표시됩니다.
* 새 권한이 필요한 API 호출은 각 크리에이터가 다시 승인할 때까지 실패합니다.

> [!NOTE]
>
> 권한을 추가하면 자신의 테스트 계정에서도 다시 승인하세요. 새 범위는 [Authorized apps](https://whop.com/dashboard/settings/authorized-apps)에서 수락하기 전까지 적용되지 않습니다.

크리에이터는 `Dashboard → Settings → Authorized apps`에서 언제든지 부여된 권한을 관리할 수 있습니다.

<video controls src="https://mintcdn.com/whop/_aQsA39rzB5Zq8ZK/how-to-videos/configure-app-permissions.mp4?fit=max&auto=format&n=_aQsA39rzB5Zq8ZK&q=85&s=dff99f10fb43e8914fdcd1b0eb4bd044" />

## 자주 묻는 질문

> [accordion] 앱은 몇 개의 권한을 요청할 수 있나요?
>
> 앱당 최대 100개입니다.

> [accordion] 엔드포인트에 필요한 권한은 어디에 나열되어 있나요?
>
> [API 레퍼런스](https://docs.whop.com/ko/api-reference/payments/list-payments.md)의 각 엔드포인트에 필요한 권한이 인라인으로 나열되어 있습니다.
>
> ![SDK 레퍼런스 권한](https://mintcdn.com/whop/purcney6SuEUQzS5/images/sdk-reference-required-permissions.png?fit=max\&auto=format\&n=purcney6SuEUQzS5\&q=85\&s=141d5a09a00942f216c98d233824dcf9)

> [accordion] 앱이 나중에 추가 권한을 요청할 수 있나요?
>
> 예. 추가 권한을 요청할 수 있으며 크리에이터에게 이를 다시 승인하도록 요청합니다.
>
> > [!NOTE]
> >
> > 권한이 다시 승인될 때까지 **새로 요청된** 권한이 필요한 API 요청은 실패합니다. 코드에서 이러한 오류를 처리하고 유용한 대체 동작을 제공하도록 하세요.
>
> > [!WARNING]
> >
> > 앱을 개발할 때는 [Authorized apps](https://whop.com/dashboard/settings/authorized-apps) 설정에서 직접 권한을 다시 승인하세요.
> >
> > 자세한 내용은 [권한 구성하기](https://docs.whop.com/ko/developer/guides/permissions.md#update-permissions-later)를 참조하세요.

## 다음 단계

> [card] [인증](https://docs.whop.com/ko/developer/guides/authentication.md)
>
> 요청을 보낸 사용자를 확인하고 액세스 수준을 점검하세요.

> [card] [웹훅 수신하기](https://docs.whop.com/ko/developer/guides/webhooks.md)
>
> 결제, 멤버십, 입장 이벤트를 수신하세요. 웹훅에는 별도의 `webhook_receive:*` 범위가 필요합니다.

> [card] [설치 추적하기](https://docs.whop.com/ko/developer/guides/app-installations.md)
>
> 계정이 앱을 설치하거나 제거하는 시점을 파악하고 자체 기록과 연결하세요.

> [card] [앱 뷰 구축하기](https://docs.whop.com/ko/developer/guides/app-views.md)
>
> 대시보드 뷰, 경험, 디스커버 목록을 설정하세요.

> [card] [로컬 개발 프록시 실행하기](https://docs.whop.com/ko/developer/guides/dev-proxy.md)
>
> localhost에서 프로덕션 iframe + 쿠키 설정을 재현하세요.


## Related topics

- [Whop 앱 빌드하기](https://docs.whop.com/ko/developer/apps/overview.md)
- [앱 스토어 등록 요구 사항](https://docs.whop.com/ko/developer/apps/listing-requirements.md)
- [Whop 앱에서 사용자 인증하기](https://docs.whop.com/ko/developer/guides/authentication.md)
