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

> Bir ödeme tutarını ve kayıtlı ödeme yöntemini toplar, standart ve anında teslimat seçeneklerini canlı ücretler ve varış tahminleriyle gruplar ve gerektiğinde yeni bir ödeme yöntemi toplar. Ana uygulama akışı yönetmediğinde element yöntemleri listeler ve ödemeyi kendisi oluşturur — `accessToken` iletin (veya izleyicinin aynı origin'deki oturumuna güvenin). Ödemeler API'siyle zaten konuşan bir ana uygulama yine de yöntemleri, limitleri ve yükleme bayraklarını sağlayabilir; bu durumda onaylamak, o ana uygulamanın oluşturması için `withdrawalRequested` yayar.

> [!NOTE]
>
> Bu sayfa `@whop/elements@1.10.0` ve `@whop/elements-react@1.10.0` sürümlerini belgeler.

*`v1.0.0` sürümünden beri.*

[`Wallet`](https://docs.whop.com/tr/elements/latest/wallet/overview) içine bağlanır. `accountId` ve `accessToken` oradan gelir. Prop'ları ve geri çağırmaları oluşturma seçenekleri veya React prop'ları aracılığıyla iletin. `refresh()` çağırmak için oluşturulan tanıtıcıyı veya React `ref` değerini saklayın.

> [!NOTE]
>
> Bu elementi **satır içi** (`create`) olarak bağlayabilir veya bir **modal** katman (`createOverlay`) olarak açabilirsiniz.

```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>
```

Örnek veriler. [Playground'u açın](https://docs.whop.com/tr/elements/latest/wallet/overview#playground).

## Prop'lar

**accessToken** `string`

Ödeme yöntemlerini listelemek ve ödemeyi oluşturmak için kapsamlı bir token — `payout:withdraw_funds`, `payout:destination:read` ve banka eklemek için `payout:create_destination` gerektirir. Atlanırsa çağrılar izleyicinin kendi oturumunu taşır; bu da yalnızca aynı origin'de yanıt verir.

**succeeded** `boolean`

Onaylanan ödemenin başarıyla oluşturulup oluşturulmadığı. Varsayılan değer `false`.

**loading** `boolean`

Ödeme yöntemlerinin ve limitlerin yüklenip yüklenmediği. Varsayılan değer `false`.

**methods** `WithdrawalMethod[]`

Geçerli tutar için fiyat teklifleriyle birlikte kayıtlı ödeme yöntemleri. Varsayılan değer `[]`.

**özellikler**

**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`

**özellikler**

**percentage** `number` *required*

**fixedAmount** `number` *required*

**currency** `string` *required*

**standardEstimatedArrival** `string | null`

**instantEstimatedArrival** `string | null`

**quote** `WithdrawalQuote | null`

**özellikler**

**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`

**özellikler**

**estimatedArrival** `string | null`

**fee** `number` *required*

**totalReceived** `number` *required*

**currency** `string`

**destinationCurrency** `string`

**exchangeRate** `number`

**minLimit** `number`

**maxLimit** `number | null`

**instant** `WithdrawalQuoteSpeed | null`

**özellikler**

**estimatedArrival** `string | null`

**fee** `number` *required*

**totalReceived** `number` *required*

**currency** `string`

**destinationCurrency** `string`

**exchangeRate** `number`

**minLimit** `number`

**maxLimit** `number | null`

**error** `string`

Geçerli ekranın içinde gösterilecek ana uygulama tarafı bir hata. Varsayılan değer `""`.

**availableBalance** `number`

Standart ödeme yöntemleri için kullanılabilir mutabakatı tamamlanmış bakiye. Varsayılan değer `0`.

**pendingBalance** `number`

Anında ödeme yöntemleri için kullanılabilir olabilecek bekleyen bakiye. Varsayılan değer `0`.

**payoutCountry** `string`

Ödeme hesabının ISO 3166-1 alpha-2 ülkesi. Varsayılan değer `"US"`.

**supportedMethods** `WithdrawalSupportedMethod[]`

Seçili ülkede eklenebilecek, gerekli alanları da içeren ödeme yöntemleri. Varsayılan değer `[]`.

**özellikler**

**id** `string` *required*

**name** `string | null`

**iconUrl** `string | null`

**deliveryType** `string` *required*

**supportsStandard** `boolean` *required*

**supportsInstant** `boolean` *required*

**supportsPlaid** `boolean`

**feeStructure** `object | null`

**özellikler**

**percentage** `number` *required*

**fixedAmount** `number` *required*

**currency** `string` *required*

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

**özellikler**

**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`

**özellikler**

**estimatedArrival** `string | null`

**fee** `number` *required*

**totalReceived** `number` *required*

**currency** `string`

**destinationCurrency** `string`

**exchangeRate** `number`

**minLimit** `number`

**maxLimit** `number | null`

**instant** `WithdrawalQuoteSpeed | null`

**özellikler**

**estimatedArrival** `string | null`

**fee** `number` *required*

**totalReceived** `number` *required*

**currency** `string`

**destinationCurrency** `string`

**exchangeRate** `number`

**minLimit** `number`

**maxLimit** `number | null`

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

**özellikler**

**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`

Seçili ülke için desteklenen ödeme yöntemlerinin yüklenip yüklenmediği. Varsayılan değer `false`.

**limits** `WithdrawalLimits`

Canlı standart ve anında ödeme limitleri. Varsayılan değer `{"standard":{"maxAmount":0},"instant":{"maxAmount":0}}`.

**özellikler**

**standard** `object` *required*

**özellikler**

**maxAmount** `number` *required*

**errorCode** `string | null`

**errorMessage** `string | null`

**instant** `object` *required*

**özellikler**

**maxAmount** `number` *required*

**dailyAmountRemaining** `number | null`

**resetsAt** `string | null`

**errorCode** `string | null`

**errorMessage** `string | null`

**quoteLoading** `boolean`

Geçerli tutarın yeniden fiyatlandırılıp fiyatlandırılmadığı. Varsayılan değer `false`.

**payoutQuoteRequired** `boolean`

Bu ödemenin onaydan önce sağlayıcı destekli kesin bir fiyat teklifi kullanması gerekip gerekmediği. Varsayılan değer `false`.

**payoutQuote** `WithdrawalPayoutQuote | null`

Onay için kısa ömürlü kesin ödeme fiyat teklifi. Teklifin cihaz saatine göre değil kalan ömrüne göre zamanlanması için serverTime ekleyin. Seçili yöntemi değiştirmeden bağlantı akışı üzerinden daha ucuz bir yöntem sunmak için recommendedMethod ekleyin. Varsayılan değer `null`.

**özellikler**

**requestId** `string` *required*

**payoutMethodId** `string` *required*

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

**id** `string` *required*

**amount** `WithdrawalMoney` *required*

**özellikler**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

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

**fee** `WithdrawalMoney` *required*

**özellikler**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

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

**netAmount** `WithdrawalMoney` *required*

**özellikler**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

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

**destinationAmount** `WithdrawalMoney` *required*

**özellikler**

**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`

**özellikler**

**supportedPayoutMethodId** `string` *required*

**name** `string` *required*

**country** `string` *required*

**destinationCurrency** `string` *required*

**estimatedSavings** `WithdrawalMoney` *required*

**özellikler**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

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

**estimatedFee** `WithdrawalMoney` *required*

**özellikler**

**currency** `string` *required*

**amount** `string` *required*

**decimals** `number` *required*

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

**estimatedArrival** `string | null`

**payoutQuoteLoading** `boolean`

Kesin bir ödeme fiyat teklifinin oluşturulup oluşturulmadığı. Varsayılan değer `false`.

**payoutQuoteError** `string`

Varsa, geçerli kesin ödeme fiyat teklifi isteğinden gelen hata. Varsayılan değer `""`.

**payoutQuoteRetryRequired** `boolean`

Son fiyat teklifi isteğinin sonuçsuz kalıp kalmadığı ve aynı istek kimliğiyle yeniden denenmesi gerekip gerekmediği. Varsayılan değer `false`.

**withdrawalRetryRequired** `boolean`

Son ödeme sonucunun sonuçsuz kalıp kalmadığı ve tam olarak yeniden denenmesi gerekip gerekmediği. Varsayılan değer `false`.

**unresolvedWithdrawalRequest** `WithdrawalRequest | null`

Element yeniden bağlandıktan sonra yeniden denenecek, çözümlenmemiş kesin ödeme isteği. Varsayılan değer `null`.

**özellikler**

**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`

Yeni bir ödeme yönteminin kaydedilip kaydedilmediği. Varsayılan değer `false`.

**submitting** `boolean`

Onaylanan ödemenin oluşturulup oluşturulmadığı. Varsayılan değer `false`.

**bankWarning** `boolean`

Banka hesap sahibinin adını doğrulayamadığı için son ödeme reddedildiğinde true. Düzelt veya onayla seçeneği gösterir; onaylamak, acknowledgeBankWarning ayarlıyken withdrawalRequested olayını yeniden yayar. Her withdrawalRequested olayını işlerken bunu yeniden false yapın — seçenek true'ya geçişte görünür, bu nedenle true bırakılan bir bayrak sonraki her reddi gizler. Varsayılan değer `false`.

**createdMethodId** `string`

En son oluşturulan yöntem; methods içinde göründüğünde seçilir. Varsayılan değer `""`.

**plaidUnavailable** `boolean`

Ödeyici Plaid Link'ten geri çıktığında veya Plaid Link açılamadığında ayarlanır. Aksi hâlde bağlama gerektiren bir kanalda elle girişin kilidini açar. Varsayılan değer `false`.

**linkingBank** `boolean`

Bir banka bağlantısının devam edip etmediği — Plaid oturumu açık veya bağlanan yöntem kaydediliyor. Varsayılan değer `false`.

## Olaylar

Geri çağırmaları oluşturma seçeneklerinde veya React prop'larında iletin.

### `onAmountChanged`

Tutar değişti ve yeniden fiyatlandırılmalı.

**payload** `object`

**özellikler**

**amount** `number` *required*

### `onCountryChanged`

Yöntem ekleme ülkesi değişti ve desteklenen yöntemler yenilenmeli.

**payload** `object`

**özellikler**

**country** `string` *required*

### `onSupportedMethodChanged`

Desteklenen bir ödeme yöntemi seçildi ve kesin gerekli alanları yüklenmeli.

**payload** `object`

**özellikler**

**country** `string` *required*

**supportedPayoutMethodId** `string` *required*

**destinationCurrency** `string` *required*

### `onAddMethodRequested`

Ödeyici dinamik ödeme yöntemi ekleme formunu gönderdi.

**payload** `WithdrawalCreateMethodInput`

**özellikler**

**country** `string` *required*

**supportedPayoutMethodId** `string` *required*

**destinationCurrency** `string` *required*

**nickname** `string` *required*

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

### `onPlaidLinkRequested`

Ödeyici, ayrıntıları yazmak yerine bankasını Plaid aracılığıyla bağlamayı seçti. Bu olay alındığında Plaid Link'i açın.

**payload** `object`

**özellikler**

**country** `string` *required*

**supportedPayoutMethodId** `string` *required*

**destinationCurrency** `string` *required*

### `onMethodVerificationCompleted`

Yeni eklenen ödeme yöntemi doğrulama adımını tamamladı.

### `onRenameMethodRequested`

Ödeyici kayıtlı bir ödeme yöntemini yeniden adlandırmak istedi.

**payload** `object`

**özellikler**

**methodId** `string` *required*

### `onRemoveMethodRequested`

Ödeyici kayıtlı bir ödeme yöntemini kaldırmak istedi.

**payload** `object`

**özellikler**

**methodId** `string` *required*

### `onPayoutQuoteRequested`

Ödeyici bir ödemeyi onaylamadan önce kısa ömürlü kesin bir fiyat teklifi istedi.

**payload** `WithdrawalPayoutQuoteRequest`

**özellikler**

**requestId** `string` *required*

**amount** `number` *required*

**currency** `string` *required*

**payoutMethodId** `string` *required*

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

### `onWithdrawalRequested`

Ödeyici ödemeyi onayladı. Akışı ana uygulama yönetiyorsa, bu olay alındığında ödemeyi oluşturun. Ödemeyi element oluşturduysa bu olay başarıdan sonra tetiklenir; böylece ana uygulama bakiyeleri yenileyebilir — ikinci bir ödeme oluşturmayın.

**payload** `WithdrawalRequest`

**özellikler**

**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`

Ödeyici başarılı bir ödemeyi incelemeyi bitirdi.

### `onLoaderStart`

Yükleme iskeleti ilk kez çizildikten sonra ve `onReady` öncesinde çalışır.

### `onReady`

Elementin ilk eksiksiz çiziminden sonra çalışır.

### `onError`

Element yüklenemediğinde veya çöktüğünde çalışır. Yedek görünüm görünür kalır. Programatik işleme için `code` kullanın. `sourceKey`, başarısız olan host-state kaynağını tanımlar.

**e** `object`

**özellikler**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Metotlar

Bunları `create` tarafından döndürülen tanıtıcı (handle) üzerinde veya bir React `ref` aracılığıyla çağırın.

### `refresh`

Kayıtlı ödeme yöntemlerini ve limitleri yeniden getirir. Kendi tarafınızda hesabın ödeme yapabileceği yerleri değiştiren herhangi bir şeyden sonra çağırın.

**Döndürür** `Promise<void>`

### `mount`

Elementi `target` içine bağlar ve yüklemeyi başlatır. React bileşenleri kendilerini bağlar.

**Parametreler**

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

### `destroy`

Elementi kaldırır ve çerçevesini ile aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz. React elementi otomatik olarak kaldırır.

### `update`

Yeni prop'ları bağlı elementle birleştirir. React'te bunun yerine bileşen prop'larını değiştirin.

**Parametreler**

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

## Stil verme

Bu element stil verme için sınıf adları sunmaz. Yeniden stil vermek için `appearance` (tema, vurgu rengi, değişkenler) kullanın.


## Related topics

- [Wallet](https://docs.whop.com/tr/elements/latest/wallet/overview.md)
- [ActionsElement](https://docs.whop.com/tr/elements/latest/wallet/actions.md)
- [SendElement](https://docs.whop.com/tr/elements/latest/wallet/send.md)
