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

# WithdrawElement

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

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

*Since `v1.0.0`.*

[`Wallet`](https://docs.whop.com/ko/elements/latest/wallet/overview) 안에 마운트됩니다. `accountId`와 `accessToken`은 Wallet에서 가져옵니다. props와 콜백은 생성 옵션 또는 React props로 전달합니다. `refresh()`를 호출하려면 생성된 핸들 또는 React `ref`를 보관하세요.

> [!NOTE]
>
> 이 엘리먼트는 **인라인**으로 마운트(`create`)하거나 **모달** 오버레이로 열 수(`createOverlay`) 있습니다.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <WithdrawElement onAmountChanged={(e) => console.log(e)} onCountryChanged={(e) => console.log(e)} onSupportedMethodChanged={(e) => console.log(e)} onAddMethodRequested={(e) => console.log(e)} onPlaidLinkRequested={(e) => console.log(e)} onMethodVerificationCompleted={(e) => console.log(e)} onRenameMethodRequested={(e) => console.log(e)} onRemoveMethodRequested={(e) => console.log(e)} onPayoutQuoteRequested={(e) => console.log(e)} onWithdrawalRequested={(e) => console.log(e)} onDone={(e) => console.log(e)} />
      </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 */ });
  wallet.create('withdraw', {
    onAmountChanged: (e) => console.log(e),
    onCountryChanged: (e) => console.log(e),
    onSupportedMethodChanged: (e) => console.log(e),
    onAddMethodRequested: (e) => console.log(e),
    onPlaidLinkRequested: (e) => console.log(e),
    onMethodVerificationCompleted: (e) => console.log(e),
    onRenameMethodRequested: (e) => console.log(e),
    onRemoveMethodRequested: (e) => console.log(e),
    onPayoutQuoteRequested: (e) => console.log(e),
    onWithdrawalRequested: (e) => console.log(e),
    onDone: (e) => console.log(e)
  }).mount('#wallet-withdraw');
</script>
```

예시 데이터입니다. [Playground 열기](https://docs.whop.com/ko/elements/latest/wallet/overview#playground).

## Props

**accessToken** `string`

출금 수단 나열과 출금 생성에 사용되는 범위 지정 토큰으로, `payout:withdraw_funds`, `payout:destination:read`가 필요하며 은행을 추가하려면 `payout:create_destination`도 필요합니다. 생략하면 호출에 뷰어 자신의 세션이 사용되며, 이는 동일 출처에서만 응답합니다.

**succeeded** `boolean`

확정된 출금이 성공적으로 생성되었는지 여부입니다. 기본값은 `false`입니다.

**loading** `boolean`

출금 수단과 한도를 불러오는 중인지 여부입니다. 기본값은 `false`입니다.

**methods** `WithdrawalMethod[]`

현재 금액에 대한 견적이 포함된 저장된 출금 수단입니다. 기본값은 `[]`입니다.

**속성**

**id** `string` *required*

**createdAt** `string | null`

**nickname** `string | null`

**accountReference** `string | null`

**payerName** `string | null`

**destinationCurrency** `string` *required*

**isDefault** `boolean` *required*

**iconUrl** `string | null`

**name** `string | null`

**deliveryType** `string` *required*

**supportsStandard** `boolean` *required*

**supportsInstant** `boolean` *required*

**bankVerificationState** `string | null`

**unavailableReason** `string | null`

**feeStructure** `object | null`

**속성**

**percentage** `number` *required*

**fixedAmount** `number` *required*

**currency** `string` *required*

**standardEstimatedArrival** `string | null`

**instantEstimatedArrival** `string | null`

**quote** `WithdrawalQuote | null`

**속성**

**amount** `number` *required*

**currency** `string` *required*

**destinationCurrency** `string` *required*

**exchangeRate** `number` *required*

**minLimit** `number` *required*

**maxLimit** `number | null`

**instantUnavailableReason** `"minimum_crypto_sales_not_met" | null`

**standard** `WithdrawalQuoteSpeed | null`

**속성**

**estimatedArrival** `string | null`

**fee** `number` *required*

**totalReceived** `number` *required*

**currency** `string`

**destinationCurrency** `string`

**exchangeRate** `number`

**minLimit** `number`

**maxLimit** `number | null`

**instant** `WithdrawalQuoteSpeed | null`

**속성**

**estimatedArrival** `string | null`

**fee** `number` *required*

**totalReceived** `number` *required*

**currency** `string`

**destinationCurrency** `string`

**exchangeRate** `number`

**minLimit** `number`

**maxLimit** `number | null`

**error** `string`

현재 화면 안에 표시할 호스트 측 오류입니다. 기본값은 `""`입니다.

**availableBalance** `number`

표준 출금 수단에 사용할 수 있는 정산된 잔액입니다. 기본값은 `0`입니다.

**pendingBalance** `number`

즉시 출금 수단에 사용할 수 있는 대기 중인 잔액입니다. 기본값은 `0`입니다.

**payoutCountry** `string`

출금 계정의 ISO 3166-1 alpha-2 국가 코드입니다. 기본값은 `"US"`입니다.

**supportedMethods** `WithdrawalSupportedMethod[]`

선택한 국가에서 추가할 수 있는 출금 수단으로, 필수 입력란을 포함합니다. 기본값은 `[]`입니다.

**속성**

**id** `string` *required*

**name** `string | null`

**iconUrl** `string | null`

**deliveryType** `string` *required*

**supportsStandard** `boolean` *required*

**supportsInstant** `boolean` *required*

**supportsPlaid** `boolean`

**feeStructure** `object | null`

**속성**

**percentage** `number` *required*

**fixedAmount** `number` *required*

**currency** `string` *required*

**quotes** `WithdrawalQuote[]` *required*

**속성**

**amount** `number` *required*

**currency** `string` *required*

**destinationCurrency** `string` *required*

**exchangeRate** `number` *required*

**minLimit** `number` *required*

**maxLimit** `number | null`

**instantUnavailableReason** `"minimum_crypto_sales_not_met" | null`

**standard** `WithdrawalQuoteSpeed | null`

**속성**

**estimatedArrival** `string | null`

**fee** `number` *required*

**totalReceived** `number` *required*

**currency** `string`

**destinationCurrency** `string`

**exchangeRate** `number`

**minLimit** `number`

**maxLimit** `number | null`

**instant** `WithdrawalQuoteSpeed | null`

**속성**

**estimatedArrival** `string | null`

**fee** `number` *required*

**totalReceived** `number` *required*

**currency** `string`

**destinationCurrency** `string`

**exchangeRate** `number`

**minLimit** `number`

**maxLimit** `number | null`

**requiredFields** `WithdrawalRequiredField[]` *required*

**속성**

**id** `string` *required*

**label** `string` *required*

**inputType** `string` *required*

**required** `boolean` *required*

**sensitive** `boolean` *required*

**placeholder** `string | null`

**validation** `string | null`

**options** `string[] | null`

**supportedMethodsLoading** `boolean`

선택한 국가에서 지원되는 출금 수단을 불러오는 중인지 여부입니다. 기본값은 `false`입니다.

**limits** `WithdrawalLimits`

실시간 표준 및 즉시 출금 한도입니다. 기본값은 `{"standard":{"maxAmount":0},"instant":{"maxAmount":0}}`입니다.

**속성**

**standard** `object` *required*

**속성**

**maxAmount** `number` *required*

**errorCode** `string | null`

**errorMessage** `string | null`

**instant** `object` *required*

**속성**

**maxAmount** `number` *required*

**dailyAmountRemaining** `number | null`

**resetsAt** `string | null`

**errorCode** `string | null`

**errorMessage** `string | null`

**quoteLoading** `boolean`

현재 금액의 가격을 다시 산정하는 중인지 여부입니다. 기본값은 `false`입니다.

**payoutQuoteRequired** `boolean`

이 출금이 확정 전에 제공업체가 보증하는 정확한 견적을 사용해야 하는지 여부입니다. 기본값은 `false`입니다.

**payoutQuote** `WithdrawalPayoutQuote | null`

확정에 사용할 정확한 단기 출금 견적입니다. 견적이 기기 시계가 아닌 남은 유효 시간을 기준으로 계산되도록 serverTime을 포함하세요. 선택한 수단을 바꾸지 않고 연결 흐름을 통해 더 저렴한 수단을 제안하려면 recommendedMethod를 포함하세요. 기본값은 `null`입니다.

**속성**

**requestId** `string` *required*

**payoutMethodId** `string` *required*

**speed** `"standard" | "instant"` *required*

**id** `string` *required*

**amount** `WithdrawalMoney` *required*

**속성**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

**display\_decimals** `number` *required*

**fee** `WithdrawalMoney` *required*

**속성**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

**display\_decimals** `number` *required*

**netAmount** `WithdrawalMoney` *required*

**속성**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

**display\_decimals** `number` *required*

**destinationAmount** `WithdrawalMoney` *required*

**속성**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

**display\_decimals** `number` *required*

**exchangeRate** `number` *required*

**serverTime** `string`

**expiresAt** `string` *required*

**quoteToken** `string` *required*

**recommendedMethod** `object | null`

**속성**

**supportedPayoutMethodId** `string` *required*

**name** `string` *required*

**country** `string` *required*

**destinationCurrency** `string` *required*

**estimatedSavings** `WithdrawalMoney` *required*

**속성**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

**display\_decimals** `number` *required*

**estimatedFee** `WithdrawalMoney` *required*

**속성**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

**display\_decimals** `number` *required*

**estimatedArrival** `string | null`

**payoutQuoteLoading** `boolean`

정확한 출금 견적을 생성하는 중인지 여부입니다. 기본값은 `false`입니다.

**payoutQuoteError** `string`

현재 정확한 출금 견적 요청에서 발생한 오류입니다(있는 경우). 기본값은 `""`입니다.

**payoutQuoteRetryRequired** `boolean`

마지막 견적 요청의 결과가 불확실하여 같은 요청 ID로 재시도해야 하는지 여부입니다. 기본값은 `false`입니다.

**withdrawalRetryRequired** `boolean`

마지막 출금 결과가 불확실하여 정확히 동일하게 재시도해야 하는지 여부입니다. 기본값은 `false`입니다.

**unresolvedWithdrawalRequest** `WithdrawalRequest | null`

엘리먼트가 다시 마운트된 후 재시도할, 해결되지 않은 정확한 출금 요청입니다. 기본값은 `null`입니다.

**속성**

**amount** `number` *required*

**currency** `string` *required*

**payoutMethodId** `string` *required*

**presentedFee** `number` *required*

**quoteId** `string`

**quoteToken** `string`

**speed** `"standard" | "instant"` *required*

**notes** `string`

**acknowledgeBankWarning** `boolean`

**savingMethod** `boolean`

새 출금 수단을 저장하는 중인지 여부입니다. 기본값은 `false`입니다.

**submitting** `boolean`

확정된 출금을 생성하는 중인지 여부입니다. 기본값은 `false`입니다.

**bankWarning** `boolean`

은행이 예금주 이름을 확인할 수 없어 마지막 출금이 거부된 경우 true입니다. 수정 또는 확인 선택지를 표시하며, 확인하면 acknowledgeBankWarning이 설정된 상태로 withdrawalRequested가 다시 발생합니다. 각 withdrawalRequested를 처리할 때 이 값을 다시 false로 설정하세요. 선택지는 값이 true로 바뀔 때 표시되므로, 플래그를 true로 남겨 두면 이후의 모든 거부가 표시되지 않습니다. 기본값은 `false`입니다.

**createdMethodId** `string`

가장 최근에 생성된 수단으로, methods에 나타나면 선택됩니다. 기본값은 `""`입니다.

**plaidUnavailable** `boolean`

결제자가 Plaid Link에서 나갔거나 Plaid Link를 여는 데 실패했을 때 설정합니다. 원래 연결이 필요한 수단에서 수동 입력을 허용합니다. 기본값은 `false`입니다.

**linkingBank** `boolean`

은행 연결이 진행 중인지 여부입니다. Plaid 세션이 열려 있거나 연결된 수단을 저장하는 중인 경우입니다. 기본값은 `false`입니다.

## 이벤트

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

### `onAmountChanged`

금액이 변경되어 가격을 다시 산정해야 합니다.

**payload** `object`

**속성**

**amount** `number` *required*

### `onCountryChanged`

수단 추가 국가가 변경되어 지원되는 수단을 새로 고쳐야 합니다.

**payload** `object`

**속성**

**country** `string` *required*

### `onSupportedMethodChanged`

지원되는 출금 수단이 선택되어 정확한 필수 입력란을 불러와야 합니다.

**payload** `object`

**속성**

**country** `string` *required*

**supportedPayoutMethodId** `string` *required*

**destinationCurrency** `string` *required*

### `onAddMethodRequested`

결제자가 동적 출금 수단 추가 양식을 제출했습니다.

**payload** `WithdrawalCreateMethodInput`

**속성**

**country** `string` *required*

**supportedPayoutMethodId** `string` *required*

**destinationCurrency** `string` *required*

**nickname** `string` *required*

**fields** `Record\<string, string\>` *required*

### `onPlaidLinkRequested`

결제자가 세부 정보를 입력하는 대신 Plaid를 통해 은행을 연결하기로 선택했습니다. 이벤트를 받으면 Plaid Link를 여세요.

**payload** `object`

**속성**

**country** `string` *required*

**supportedPayoutMethodId** `string` *required*

**destinationCurrency** `string` *required*

### `onMethodVerificationCompleted`

새로 추가된 출금 수단의 인증 단계가 완료되었습니다.

### `onRenameMethodRequested`

결제자가 저장된 출금 수단의 이름 변경을 요청했습니다.

**payload** `object`

**속성**

**methodId** `string` *required*

### `onRemoveMethodRequested`

결제자가 저장된 출금 수단의 삭제를 요청했습니다.

**payload** `object`

**속성**

**methodId** `string` *required*

### `onPayoutQuoteRequested`

결제자가 출금을 확정하기 전에 정확한 단기 견적을 요청했습니다.

**payload** `WithdrawalPayoutQuoteRequest`

**속성**

**requestId** `string` *required*

**amount** `number` *required*

**currency** `string` *required*

**payoutMethodId** `string` *required*

**speed** `"standard" | "instant"` *required*

### `onWithdrawalRequested`

결제자가 출금을 확정했습니다. 호스트가 흐름을 제어하는 경우 이벤트를 받으면 출금을 생성하세요. 엘리먼트가 출금을 생성한 경우에는 성공 후 발생하므로 호스트가 잔액을 새로 고칠 수 있습니다. 두 번째 출금을 생성하지 마세요.

**payload** `WithdrawalRequest`

**속성**

**amount** `number` *required*

**currency** `string` *required*

**payoutMethodId** `string` *required*

**presentedFee** `number` *required*

**quoteId** `string`

**quoteToken** `string`

**speed** `"standard" | "instant"` *required*

**notes** `string`

**acknowledgeBankWarning** `boolean`

### `onDone`

결제자가 성공한 출금의 확인을 마쳤습니다.

### `onLoaderStart`

로딩 스켈레톤이 처음 그려진 후, `onReady` 전에 실행됩니다.

### `onReady`

엘리먼트가 처음으로 완전히 그려진 후 실행됩니다.

### `onError`

엘리먼트가 로드에 실패하거나 충돌할 때 실행됩니다. 대체 화면은 계속 표시됩니다. 프로그래밍 방식으로 처리하려면 `code`를 사용하세요. `sourceKey`는 실패한 호스트 상태 소스를 식별합니다.

**e** `object`

**속성**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## 메서드

`create`가 반환한 핸들에서, 또는 React `ref`를 통해 호출합니다.

### `refresh`

저장된 출금 수단과 한도를 다시 가져옵니다. 계정이 출금할 수 있는 대상을 바꾸는 변경이 있은 후 호출하세요.

**반환값** `Promise<void>`

### `mount`

`target`에 엘리먼트를 마운트하고 로딩을 시작합니다. React 컴포넌트는 자동으로 마운트됩니다.

**매개변수**

**target** `string | HTMLElement` *required*

### `destroy`

엘리먼트를 제거하고 프레임과 구독을 해제합니다. 여러 번 호출해도 됩니다. React는 엘리먼트를 자동으로 제거합니다.

### `update`

마운트된 엘리먼트에 새 props를 병합합니다. React에서는 대신 컴포넌트 props를 변경하세요.

**매개변수**

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

## 스타일링

이 엘리먼트는 스타일링용 클래스 이름을 노출하지 않습니다. 스타일을 변경하려면 `appearance`(테마, 강조 색상, 변수)를 사용하세요.


## Related topics

- [ActionsElement](https://docs.whop.com/ko/elements/latest/wallet/actions.md)
- [SendElement](https://docs.whop.com/ko/elements/latest/wallet/send.md)
- [Withdraw a Case](https://docs.whop.com/ko/api-reference/resolution-center-cases/withdraw-a-case.md)
