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

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

> [!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. Bir tanıtıcı almak için onu oluşturun, ardından elementlerini o tanıtıcı üzerine bağlayın. Alt denetleyiciyi kaldırmak için `destroy()` çağırın. Yeni bir tanıtıcı almak için onu yeniden oluşturun.

## Önizleme

Bu alt denetleyicinin varsayılan düzeninin örnek verilerle canlı, etkileşimli bir demosu:

Görünüm hiyerarşinizin herhangi bir yerine bağlanır. [`BalanceElement`](https://docs.whop.com/tr/elements/latest/wallet/balances-balance#swift) ve [`ListElement`](https://docs.whop.com/tr/elements/latest/wallet/balances-list#swift) birbirinden bağımsızdır; bu nedenle birini tek başına veya ikisini aynı ekranda kullanın. Her biri bir `accountId` alır ve kendi verilerini yükler.

## Önizleme

Örnek uygulamada bir iPhone üzerinde çalışırken:

[iPhone simülatöründe çalışan BalanceElement](https://app.revyl.ai/embed/c1954726-8f9b-483d-9f50-247fa7bfb007?controls=0)

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <Balances>
          <BalanceElement />
          <BreakdownElement />
          <ListElement />
        </Balances>
      </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 */ });
  const balances = wallet.create('balances', { /* options */ });
  balances.create('balance').mount('#wallet-balances-balance');
  balances.create('breakdown').mount('#wallet-balances-breakdown');
  balances.create('list').mount('#wallet-balances-list');
</script>
```

```swift Swift theme={null}
import SwiftUI
import WhopElements

// WhopSDK.configure(tokenProvider:) runs once at app launch. See Getting started.
struct WalletScreen: View {
    let account = "biz_xxxx"

    var body: some View {
        ScrollView {
            VStack(spacing: 24) {
                BalanceElement(accountId: account)
                ListElement(accountId: account)
            }
            .padding()
        }
    }
}
```

## Seçenekler

Bunları `wallet.create('balances', { … })` çağrısına veya React'te `<Balances>` üzerinde prop olarak iletin. Üst öğe tarafından enjekte edilen prop'lar burada asla görünmez.

**accessToken** `string`

Bakiye dökümü ve mutabakat okumaları için kapsamlı bir token. Bir hesabın `company:balance:read` iznine ihtiyacı vardır. Atlanırsa izleyicinin aynı origin'deki oturumu kullanılır.

**openHoldingOnSelect** `boolean`

Bir satıra tıklandığında grafik ve liste yerine bu birimin varlık 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`.

## Metotlar

Bunları `wallet.create('balances', { … })` tarafından döndürülen alt tanıtıcı üzerinde çağırın.

### `update`

Yeni prop'ları ve geri çağırmaları alt denetleyiciyle birleştirir.

**Parametreler**

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

### `destroy`

Alt denetleyiciyi ve elementlerini yok eder, ardından özel yuvasını serbest bırakır. Sonraki bir `create("balances")` sıfırdan başlar.

## Parametreler

**accountId** `String` *required*

Görünümün parasını okuduğu hesap. `biz_` önekli bir hesap kimliği kullanın. `user_` önekli bir kullanıcı kimliği izleyicinin kendi bakiyesini okur ve bir hesap token'ı değil, izleyici kimlik doğrulaması (`WhopSDK.configureWithOAuth`) gerektirir.

## Durumlar

Her görünüm kendi durumlarını yönetir; bu nedenle hiçbiri diğerinin çizilmesini engellemez.

## Bilmekte fayda var

* Hiçbir durumu paylaşmazlar ve bağımsız olarak yüklenirler; bu nedenle birini tek başına veya ikisini aşağıdaki gibi birlikte kullanabilirsiniz.
* Ayrıntılar için [`BalanceElement`](https://docs.whop.com/tr/elements/latest/wallet/balances-balance#swift) ve [`ListElement`](https://docs.whop.com/tr/elements/latest/wallet/balances-list#swift) sayfalarını okuyun; [`ActivityElement`](https://docs.whop.com/tr/elements/latest/wallet/activity#swift) bunların arkasındaki hareketleri listeler.

> [!NOTE]
>
> Başlangıçta `WhopSDK.configure(tokenProvider:)` çağrısını bir kez yapın. Görünümler token'ı bekler. Bkz. [Başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md). `.whopTheme(_:)` ile bir tema uygulayın.

## Elementler

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

> [card] [BalanceElement](https://docs.whop.com/tr/elements/latest/wallet/balances-balance.md)
>
> Bir hesabın bakiyesi ve nasıl değiştiğini gösteren bir grafik. Toplam ve değişimi en üstte, grafik onun altında, zaman aralığı düğmeleri ise en altta yer alır. İzleyici grafikteki tek tek noktaları okuyabilir ve zaman aralığını kendisi değiştirebilir.

> [card] [BreakdownElement](https://docs.whop.com/tr/elements/latest/wallet/balances-breakdown.md)
>
> Tek bir para biriminin toplamının kullanılabilir, bekleyen, rezerv ve negatif bakiyelere ayrılmış hâli. Sıfır değerli satırlar kaybolur ve yüzey bilerek hiçbir para hareketi düğmesi içermez; böylece bu eylemler ana uygulamaya ait olur.

> [card] [SettlementElement](https://docs.whop.com/tr/elements/latest/wallet/balances-settlement.md)
>
> Whop'un kontrol panelinde gösterilen hesap bakiyesi ayrıntıları: kullanılabilir fonlar, bekleyen mutabakat tarihleri, rezerv koşulları ve varsa negatif bakiye. 550px'lik bir modal olarak açılır ve balances tanıtıcısının hesabını, para birimini ve kimlik bilgisini kullanır.

> [card] [ListElement](https://docs.whop.com/tr/elements/latest/wallet/balances-list.md)
>
> Bir hesabın bakiyesinin arkasındaki varlıklar. Her para birimi ve token, adını ve dolar cinsinden değerini gösteren kendi satırını alır; en büyükten başlayarak sıralanır. Satırlar izleyicinin hangisine dokunduğunu bildirebilir; böylece onun için kendi ekranınızı açabilirsiniz. `openHoldingOnSelect` açıkken bir satıra tıklamak, bu birimin grafiği ve listesi yerine o varlığın bakiye sayfasını gösterir.
