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

# Wallet

> Bir hesabın para yüzeylerini yönetir. `actions`, Deposit, Accept, Send ve Convert denetimlerini gösterir: Deposit, Send ve Convert kendi Wallet katmanlarını açarken Accept, bir işletme hesabı için Whop'un ödeme bağlantısı oluşturucusunu, kişisel bir hesap için ise şirket oluşturmayı açar. `deposit` canlı fonlama kanallarını döndürür; `convert` USD'yi Gold, Bitcoin veya bir hisse senedi token'ıyla takas eder ve ana uygulama `fxEnabled` seçeneğini etkinleştirdiğinde FX para birimlerini sunar; `send` parayı bir alıcıya taşır veya herkese açık bir talep bağlantısı oluşturur; `withdraw` ödeme yöntemlerini listeler ve ana uygulama o API'yi zaten yönetmiyorsa ödemeyi oluşturur; `balances` iki yüz barındırır — varlıklar listesi ve değeri bir pencere boyunca çizen bakiye bloğu; `cards` kompakt verilmiş kart listesidir; `cardsTable` tam sıralanabilir kart listesini gösterir; `cardsChart` kart harcamasını çizer; `whopCard` gösterilebilir tek bir kartı gösterir; `activity` defter hareketlerini listeler; `activityDetail` önceden getirilmiş bir hareketi gösterir veya bir etkinlik kimliği ya da kart işlemi kimliğiyle birini alarak bağımsız bir çekmecede gösterir. Bekleyen eylem çubuğu ve kimlik hatırlatması `dashboard` denetleyicisinde yer alır. Veriye dayalı her yüzey, token sağlanmadığında izleyicinin oturumunu kullanabilir.

> [!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.*

## Playground

Elementleri örnek verilerle bir araya getirin. Kontrolleri kullanın, elementler ekleyip düzenleyin ve olayların canlı olarak tetiklenmesini izleyin:

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

## Seçenekler

Bunları `whop.wallet.create({ … })` çağrısına veya React'te `<Wallet>` üzerinde prop olarak iletin.

**currency** `string`

Tutar alanları için üç harfli ISO 4217 para birimi kodu. Bilinmeyen bir kod `usd` değerine geri döner. Varsayılan değer `"usd"`.

**accessToken** `string`

Veriye dayalı wallet alt öğelerine aktarılan isteğe bağlı kapsamlı token. Bu olmadan okumalar izleyici oturumunu kullanır.

**openHoldingOnSelect** `boolean`

Bir satıra tıklandığında bakiyeler grafiği ve listesi yerine bir varlığın bakiye sayfasını gösterir. `balanceSelected` üzerinden yönlendirme yapan bir ana uygulamanın ikinci bir ekranla örtülmemesi için varsayılan olarak kapalıdır. Varsayılan değer `false`.

**accountId** `string` *required*

Bu yüzeylerin parasını okuduğu hesap veya kullanıcı kimliği. Hesap kimlikleri `biz_` öneklidir; kullanıcı kimlikleri `user_` öneklidir ve yalnızca izleyicinin kendi bakiyesini okuyabilir.

**appearance** `Appearance`

Bu grubun elementleri için görsel özelleştirme. Genel `WhopElements({ appearance })` ayarını geçersiz kılar. `update({ appearance })` ile canlı olarak değiştirin.

**locale** `WhopElementsLocale`

Bu grubun element arayüz metni için yerel ayar. Genel yapılandırmayı geçersiz kılmak için uygulamanın derlenmiş yerel ayarlarından birine ayarlayın. Diğer her değer varsayılan yerel ayara geri döner.

## Olaylar

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

### `onIdentityVerificationRequested`

Bir para yatırma işlemi kimlik doğrulaması gerektiriyor. Ayarlarınızı veya doğrulama akışınızı açmak için bu geri çağırmayı işleyin; Wallet gezinme yapmaz.

**payload** `object`

**özellikler**

**accountId** `string` *required*

### `onLoadingChange`

Gruplanmış yükleme durumu değiştiğinde çalışır. Bağlı herhangi bir element hâlâ yükleniyorken değer `true` olur.

**loading** `boolean`

## Metotlar

Bunları `whop.wallet.create({ … })` veya `useWallet()` tarafından döndürülen Wallet tanıtıcısı üzerinde çağırın.

### `update`

Yeni tanıtıcı seçeneklerini bağlı her elementle birleştirir. React'te bunun yerine namespace prop'larını değiştirin.

**Parametreler**

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

### `destroy`

Bu tanıtıcının oluşturduğu her elementi ve alt denetleyiciyi yok eder, denetleyici çerçevesini kaldırır ve aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz, ancak yok edilmiş bir tanıtıcı diğer her çağrıyı reddeder — baştan başlamak için yeni bir tanıtıcı oluşturun. Sağlayıcı kaldırıldığında React grubu otomatik olarak kaldırır.

## Elementler

Bu grubun bağladığı elementler. Her birinin kendi sayfası vardır:

> [card] [ActionsElement](https://docs.whop.com/tr/elements/latest/wallet/actions.md)
>
> Whop'un bakiye kontrol panelindeki hesap eylem satırı. Deposit, Send, Withdraw ve Convert, Wallet denetleyicisinin yerleşik katmanlarını açar. Accept, bir işletme hesabı için Whop'un ödeme bağlantısı oluşturucusunu, kişisel bir hesap için ise şirket oluşturmayı açar. Her düğme ayrıca istenen olayını yayar; böylece gömülü sayfa eylemi gözlemleyebilir.

> [card] [Balances](https://docs.whop.com/tr/elements/latest/wallet/balances)
>
> Bir hesabın parasının üç görünümü. Bakiye görünümü toplamı, nasıl değiştiğini gösteren bir grafiği ve bir zaman aralığı seçicisini gösterir. Liste görünümü bu toplamı oluşturan varlıkları dolar cinsinden değerleriyle gösterir. Döküm görünümü tek bir para birimini para hareketi denetimleri olmadan kullanılabilir, bekleyen, rezerv ve negatif tutarlara ayırır. `openHoldingOnSelect` açıkken bir liste satırı, tıklamayı yalnızca bildirmek yerine bu birimin tuvalini — grafiği ve listeyi — o varlığın bakiye sayfasıyla değiştirir. *(alt denetleyici, 4 element)*

> [card] [Reports](https://docs.whop.com/tr/elements/latest/wallet/reports)
>
> Bakiye geçmişi ve arkasındaki finansal etkinlik, CSV dışa aktarmaları dahil. Hesap ekstreleri Whop kontrol panelinde mevcuttur. *(alt denetleyici, 2 element)*

> [card] [ActivityElement](https://docs.whop.com/tr/elements/latest/wallet/activity.md)
>
> Bir hesabın defter etkinliği: içeri veya dışarı her para hareketi, en yeniden başlayarak. Liste izleyici kaydırdıkça sayfalanır ve satırlar gezinme yapmak yerine hangisine dokunulduğunu bildirir; böylece kendi ayrıntı ekranınızı açabilirsiniz.

> [card] [ActivityDetailElement](https://docs.whop.com/tr/elements/latest/wallet/activityDetail.md)
>
> Tek bir hareket için bağımsız bir ayrıntı çekmecesi. Onu önceden getirilmiş bir finansal etkinlik satırına, bir defter etkinliği kimliğine veya bir kart işlemi kimliğine yönlendirin — önceden getirilmiş satır önceliklidir, aksi hâlde element kaydı kendisi alır. Bir kart işlemi kart makbuzunu açar: satıcı, tutar, durum, tahsil edildiği kart, bir şirket hesabında kart sahibi, mutabakat tarihi, kategori, döviz dönüşümü ve nakit iade.

> [card] [DepositElement](https://docs.whop.com/tr/elements/latest/wallet/deposit.md)
>
> Bir Whop hesabına para yatırır. Bir tutar alanı ve hesabın canlı fonlama kanallarını gösterir — kripto (QR koduyla birlikte ağ başına bir para yatırma adresi) ve banka havalesi (her mutabakat para birimi için havale alanları). Bir işletme hesabının kanalları hiçbir kimlik bilgisi olmadan çözümlenir, bu nedenle herhangi bir sayfada çalışırlar; kişisel (`user_`) bir hesap ise kanallarını yalnızca kendisine gösterir, bu nedenle onun için `accessToken` iletin — atlanırsa izleyicinin aynı origin'deki kendi oturumu bunu karşılar. Kartlar ve platform bakiyesi isteğe bağlıdır: `savedCards`, `allowNewCard` veya `showPlatformBalance` iletin; element tutarı ve seçimi toplar, ardından `cardDepositRequested` / `addCardRequested` / `platformBalanceSelected` yayar ve kendi ekranınız bittiğinde `showStep({ step: 'amount' })` çağırmanızı bekler.

> [card] [ConvertElement](https://docs.whop.com/tr/elements/latest/wallet/convert.md)
>
> Whop'un herkese açık swaps API'si aracılığıyla bir hesabın USD bakiyesini Gold, Coinbase Wrapped Bitcoin veya bir hisse senedi token'ına ve geri dönüştürür. Cross-origin bir bağlama, `company:balance:read` ile birlikte `crypto_wallet:swap` veya `crypto_wallet:manage` kapsamlı bir `accessToken` gerektirir.

> [card] [WithdrawElement](https://docs.whop.com/tr/elements/latest/wallet/withdraw.md)
>
> 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.

> [card] [SendElement](https://docs.whop.com/tr/elements/latest/wallet/send.md)
>
> Bir hesaptan bir alıcıya para gönderir — bir kullanıcıya, başka bir hesaba veya herkesin kullanabileceği herkese açık bir talep bağlantısına. Doğrudan transferler kaynak hesabın yapılandırılmış fiat veya kripto kanalını kullanır. Hesabın kendi token'ı dışında hiçbir kimlik bilgisi olmadan hesap kimliğinden çözümlenen kendi alıcı aramasını gösterir. Doğrudan transferler için `payout:transfer_funds`, alıcı listeleri için `payout:withdraw_funds` kapsamlı bir `accessToken` gerektirir; hesap alıcı araması ayrıca `company:authorized_user:read` ve `member:basic:read`, hesap talep bağlantıları ise `airdrop_link:manage` gerektirir — bu kapsamlardan birine sahip olmayan bir ana uygulama, 403 döndürecek bir satır bırakmak yerine ilgili prop'u kapatmalıdır.

> [card] [CardDetailsElement](https://docs.whop.com/tr/elements/latest/wallet/cardDetails)
>
> Tek bir kart ve üzerinde harcananlar: kartın kendisi, limitine karşı ne kadar harcadığı ve en son işlemleri. Bir çekmece olarak açılır. Kart yüzü, gösterme ve kilitleme özellikleri içine yerleştirilmiş `whopCard` elementinden gelir; böylece ana uygulama üç parçayı birleştirmek yerine tek bir yüzey alır. Bir işleme basmak veya tam listeyi istemek, isteği bildirir — çekmece hiçbir zaman gezinme yapmaz.

> [card] [Cards](https://docs.whop.com/tr/elements/latest/wallet/cards)
>
> Bir hesabın kart yüzeyleri, tek bir yerden bağlanır: kompakt verilmiş kart listesi, tam sıralanabilir liste, harcama grafiği ve gösterilebilir tek bir kart. Sayfanın ihtiyaç duyduğu yüzleri bağlayın — bu birimin oluşturulduğu hesabı ve kimlik bilgisini paylaşırlar; böylece bir listenin üstünde grafik gösteren bir sayfa onları tek seferde bağlar. *(alt denetleyici, 5 element)*
