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

# 지갑

> 계정의 자금 화면을 구동합니다. `actions`는 Deposit, Accept, Send, Convert 컨트롤을 렌더링합니다. Deposit, Send, Convert는 각각의 Wallet 오버레이를 열고, Accept는 비즈니스 계정에서는 Whop의 결제 링크 생성기를, 개인 계정에서는 회사 생성 화면을 엽니다. `deposit`은 실시간 입금 수단을 반환하고, `convert`는 USD를 Gold, Bitcoin 또는 주식 토큰과 교환하며 호스트가 `fxEnabled`를 활성화하면 외화 통화를 제공합니다. `send`는 수신자에게 자금을 보내거나 공개 수령 링크를 만들고, `withdraw`는 출금 수단을 나열하며 호스트가 해당 API를 직접 다루지 않는 경우 출금을 생성합니다. `balances`는 보유 자산 목록과 기간별 가치를 그리는 잔액 블록이라는 두 가지 화면을 제공합니다. `cards`는 간결한 발급 카드 목록, `cardsTable`은 정렬 가능한 전체 카드 목록, `cardsChart`는 카드 지출 차트, `whopCard`는 정보를 공개할 수 있는 단일 카드를 렌더링합니다. `activity`는 원장 이동 내역을 나열하고, `activityDetail`은 미리 가져온 이동 내역을 렌더링하거나 활동 ID 또는 카드 거래 ID로 내역을 조회해 독립된 드로어에 표시합니다. 미해결 작업 바와 신원 인증 안내는 `dashboard` 컨트롤러에 있습니다. 데이터를 사용하는 모든 화면은 토큰이 제공되지 않으면 뷰어의 세션을 사용할 수 있습니다.

> [!NOTE]
>
> 이 페이지는 `@whop/elements@1.10.0` 및 `@whop/elements-react@1.10.0`을 다룹니다.

*Since `v1.0.0`.*

## Playground

예시 데이터로 엘리먼트를 조합해 보세요. 컨트롤을 조작하고, 엘리먼트를 추가 및 배치하고, 이벤트가 실시간으로 발생하는 것을 확인하세요.

```tsx React theme={null}
import { WhopElements, Wallet } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        {/* mount elements here */}
      </Wallet>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const wallet = window.WhopElements().wallet.create({ /* options */ });
</script>
```

## 옵션

`whop.wallet.create({ … })`에 전달하거나, React에서는 `<Wallet>`의 props로 전달하세요.

**currency** `string`

금액 입력란에 사용할 세 글자 ISO 4217 통화 코드입니다. 알 수 없는 코드는 `usd`로 대체됩니다. 기본값은 `"usd"`입니다.

**accessToken** `string`

데이터를 사용하는 하위 지갑 엘리먼트에 전달되는 선택적 범위 지정 토큰입니다. 토큰이 없으면 뷰어 세션으로 읽습니다.

**openHoldingOnSelect** `boolean`

행이 클릭되면 잔액 차트와 목록 대신 보유 자산의 잔액 페이지를 표시합니다. `balanceSelected`로 라우팅하는 호스트가 두 번째 화면에 가려지지 않도록 기본적으로 꺼져 있습니다. 기본값은 `false`입니다.

**accountId** `string` *required*

이 화면들이 자금을 읽을 계정 또는 사용자 ID입니다. 계정 ID에는 `biz_` 접두사가 붙고, 사용자 ID에는 `user_` 접두사가 붙으며 뷰어 자신의 잔액만 읽을 수 있습니다.

**appearance** `Appearance`

이 그룹 엘리먼트의 시각적 사용자 지정입니다. 전역 `WhopElements({ appearance })`를 재정의합니다. `update({ appearance })`로 실시간 변경할 수 있습니다.

**locale** `WhopElementsLocale`

이 그룹 엘리먼트 UI 텍스트의 로케일입니다. 앱에 빌드된 로케일 중 하나로 설정하면 전역 구성을 재정의합니다. 그 외의 값은 기본 로케일로 대체됩니다.

## 이벤트

생성 옵션 또는 React props로 콜백을 전달합니다.

### `onIdentityVerificationRequested`

입금에 신원 인증이 필요합니다. 이 콜백을 처리하여 설정 또는 인증 흐름을 여세요. Wallet은 직접 페이지를 이동하지 않습니다.

**payload** `object`

**속성**

**accountId** `string` *required*

### `onLoadingChange`

그룹 로딩 상태가 바뀔 때 실행됩니다. 마운트된 엘리먼트 중 하나라도 로딩 중이면 값은 `true`입니다.

**loading** `boolean`

## 메서드

`whop.wallet.create({ … })` 또는 `useWallet()`으로 얻은 Wallet 핸들에서 호출하세요.

### `update`

마운트된 모든 엘리먼트에 새 핸들 옵션을 병합합니다. React에서는 대신 네임스페이스 props를 변경하세요.

**매개변수**

**options** `Partial\<WalletOptions\>` *required*

### `destroy`

이 핸들이 만든 모든 엘리먼트와 하위 컨트롤러를 파괴하고, 컨트롤러 프레임을 제거하고, 구독을 해제합니다. 여러 번 호출할 수 있지만, 파괴된 핸들은 다른 모든 호출을 거부합니다. 다시 시작하려면 새 핸들을 만드세요. React는 프로바이더가 언마운트될 때 그룹을 자동으로 제거합니다.

## 엘리먼트

이 그룹이 마운트하는 엘리먼트입니다. 각 엘리먼트에는 자체 페이지가 있습니다.

> [card] [ActionsElement](https://docs.whop.com/ko/elements/latest/wallet/actions.md)
>
> Whop 잔액 대시보드의 계정 작업 행입니다. Deposit, Send, Withdraw, Convert는 Wallet 컨트롤러의 내장 오버레이를 엽니다. Accept는 비즈니스 계정에서는 Whop의 결제 링크 생성기를, 개인 계정에서는 회사 생성 화면을 엽니다. 각 버튼은 해당 요청 이벤트도 발생시키므로 임베드한 페이지가 작업을 관찰할 수 있습니다.

> [card] [잔액](https://docs.whop.com/ko/elements/latest/wallet/balances)
>
> 계정 자금을 보여 주는 세 가지 뷰입니다. 잔액 뷰는 총액, 그 변화를 보여 주는 차트, 기간 선택기를 표시합니다. 목록 뷰는 총액을 구성하는 보유 자산을 달러 가치로 표시합니다. 내역 뷰는 자금 이동 컨트롤 없이 한 통화를 사용 가능, 대기 중, 리저브, 마이너스 금액으로 나눕니다. `openHoldingOnSelect`가 켜져 있으면 목록 행이 클릭을 보고하는 데 그치지 않고, 이 유닛의 캔버스(차트와 목록)를 해당 보유 자산의 잔액 페이지로 대체합니다. *(하위 컨트롤러, 엘리먼트 4개)*

> [card] [보고서](https://docs.whop.com/ko/elements/latest/wallet/reports)
>
> 잔액 내역과 그 뒤에 있는 금융 활동을 CSV 내보내기와 함께 제공합니다. 계정 명세서는 Whop 대시보드에서 확인할 수 있습니다. *(하위 컨트롤러, 엘리먼트 2개)*

> [card] [ActivityElement](https://docs.whop.com/ko/elements/latest/wallet/activity.md)
>
> 계정의 원장 활동입니다. 들어오고 나간 모든 자금 이동을 최신순으로 보여 줍니다. 뷰어가 스크롤하면 목록이 페이지 단위로 로드되며, 행은 페이지를 이동하는 대신 어느 행이 탭되었는지 보고하므로 자체 세부 정보 화면을 열 수 있습니다.

> [card] [ActivityDetailElement](https://docs.whop.com/ko/elements/latest/wallet/activityDetail.md)
>
> 자금 이동 하나에 대한 독립된 세부 정보 드로어입니다. 미리 가져온 금융 활동 행, 원장 활동 ID 또는 카드 거래 ID를 지정하세요. 미리 가져온 행이 우선하며, 그렇지 않으면 엘리먼트가 직접 기록을 조회합니다. 카드 거래는 카드 영수증을 엽니다. 가맹점, 금액, 상태, 청구된 카드, 회사 계정의 카드 소지자, 정산일, 카테고리, 환전, 캐시백이 표시됩니다.

> [card] [DepositElement](https://docs.whop.com/ko/elements/latest/wallet/deposit.md)
>
> Whop 계정에 자금을 입금합니다. 금액 입력란과 계정에서 현재 사용 가능한 입금 수단을 렌더링합니다. 암호화폐(네트워크별 입금 주소와 QR 코드)와 은행 송금(정산 통화별 송금 정보)을 지원합니다. 비즈니스 계정의 입금 수단은 자격 증명 없이 확인되므로 어떤 페이지에서도 작동합니다. 개인(`user_`) 계정은 입금 수단을 본인에게만 공개하므로 `accessToken`을 전달하세요. 생략하면 뷰어 자신의 동일 출처 세션이 사용됩니다. 카드와 플랫폼 잔액은 선택 사항입니다. `savedCards`, `allowNewCard` 또는 `showPlatformBalance`를 전달하면 엘리먼트가 금액과 선택 항목을 수집한 다음 `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected`를 발생시키고, 자체 화면이 완료되면 `showStep({ step: 'amount' })`을 호출할 때까지 기다립니다.

> [card] [ConvertElement](https://docs.whop.com/ko/elements/latest/wallet/convert.md)
>
> Whop의 공개 스왑 API를 통해 계정의 USD 잔액을 Gold, Coinbase Wrapped Bitcoin 또는 주식 토큰으로 전환하거나 다시 USD로 전환합니다. 교차 출처 마운트에는 `company:balance:read`와 함께 `crypto_wallet:swap` 또는 `crypto_wallet:manage` 스코프가 지정된 `accessToken`이 필요합니다.

> [card] [WithdrawElement](https://docs.whop.com/ko/elements/latest/wallet/withdraw.md)
>
> 출금 금액과 저장된 출금 수단을 수집하고, 표준 및 즉시 지급 옵션을 실시간 수수료와 도착 예상 시간과 함께 묶어 보여 주며, 필요한 경우 새 출금 수단을 수집합니다. 호스트가 흐름을 제어하지 않으면 엘리먼트가 직접 출금 수단을 나열하고 출금을 생성하므로 `accessToken`을 전달하세요(또는 뷰어의 동일 출처 세션을 사용하세요). 이미 출금 API와 통신하는 호스트는 여전히 출금 수단, 한도, 로딩 플래그를 제공할 수 있으며, 이 경우 확정하면 호스트가 출금을 생성하도록 `withdrawalRequested`가 발생합니다.

> [card] [SendElement](https://docs.whop.com/ko/elements/latest/wallet/send.md)
>
> 계정에서 수신자에게 자금을 보냅니다. 수신자는 사용자, 다른 계정 또는 누구나 받을 수 있는 공개 수령 링크일 수 있습니다. 직접 이체는 출금 계정에 구성된 법정 화폐 또는 암호화폐 수단을 사용합니다. 계정 자체 토큰 외의 자격 증명 없이 계정 ID로 확인되는 자체 수신자 검색을 렌더링합니다. 직접 이체에는 `payout:transfer_funds`, 수신자 목록에는 `payout:withdraw_funds` 스코프가 지정된 `accessToken`이 필요합니다. 계정 수신자 검색에는 추가로 `company:authorized_user:read`와 `member:basic:read`가, 계정 수령 링크에는 `airdrop_link:manage`가 필요합니다. 이 스코프 중 하나가 없는 호스트는 403 오류를 낼 행을 남겨 두지 말고 해당 prop을 끄세요.

> [card] [CardDetailsElement](https://docs.whop.com/ko/elements/latest/wallet/cardDetails)
>
> 카드 한 장과 그 카드의 지출 내역입니다. 카드 자체, 한도 대비 지출액, 최근 거래를 보여 줍니다. 드로어로 열립니다. 카드 앞면, 정보 공개, 잠금은 내부에 구성된 `whopCard` 엘리먼트에서 제공되므로, 호스트는 세 가지를 조립하는 대신 하나의 화면을 얻습니다. 거래를 누르거나 전체 목록을 요청하면 요청이 보고될 뿐이며, 드로어가 직접 페이지를 이동하지는 않습니다.

> [card] [카드](https://docs.whop.com/ko/elements/latest/wallet/cards)
>
> 한 곳에서 마운트하는 계정의 카드 화면들입니다. 간결한 발급 카드 목록, 정렬 가능한 전체 목록, 지출 차트, 정보를 공개할 수 있는 단일 카드를 제공합니다. 페이지에 필요한 화면을 마운트하세요. 모두 이 유닛이 발급받은 계정과 자격 증명을 공유하므로, 목록 위에 차트를 표시하는 페이지도 한 번만 연결하면 됩니다. *(하위 컨트롤러, 엘리먼트 5개)*
