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

# BalanceElement

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

> [!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çindeki [`Balances`](https://docs.whop.com/tr/elements/latest/wallet/balances) içine bağlanır. `accountId` ve `currency` `Wallet` üzerinden gelir. Prop'ları ve geri çağırmaları oluşturma seçenekleri veya React prop'ları aracılığıyla iletin.

Görünüm hiyerarşinizin herhangi bir yerine bağlanır. Bir `accountId` alır ve kendi verilerini yükler; `range`, açıldığı zaman aralığını seçer. Kök bir `VStack` olduğundan içeriğine göre boyutlanır ve ona verdiğiniz genişliği doldurur.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <Balances>
          <BalanceElement onRangeChanged={(e) => console.log(e)} onRangeBrushed={(e) => console.log(e)} />
        </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', {
    onRangeChanged: (e) => console.log(e),
    onRangeBrushed: (e) => console.log(e)
  }).mount('#wallet-balances-balance');
</script>
```

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

// WhopSDK.configure(tokenProvider:) runs once at app launch. See Getting started.
struct WalletScreen: View {
    var body: some View {
        BalanceElement(
            accountId: "biz_xxxx",
            range: .oneMonth
        )
    }
}
```

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

[iPhone simülatöründe çalışan BalanceElement](https://app.revyl.ai/embed/bb0f1c0a-4242-486a-a5f5-03dd9711744c?controls=0)

## Prop'lar

**accessToken** `string`

Okumalar için kapsamlı bir token. Bir hesabın toplam için `company:balance:read`, grafik için `stats:read` iznine ihtiyacı vardır; bir kullanıcının kendi bakiyesi `user:balance:read` gerektirir. Onu sunucunuzda `POST /api/v1/access_tokens` ile oluşturun ve süresi dolmadan önce yenisini ayarlayın. Bu olmadan okumalar izleyicinin kendi oturumunu kullanır; bu da yalnızca aynı origin'de çalışır. Varsayılan değer `""`.

**range** `"1D" | "1W" | "1M" | "1Y" | "ALL"`

Açılacak zaman aralığı. Düğmeler onu oradan itibaren değiştirir; kendiniz kontrol etmek için bu prop'u yeniden ayarlayın. Varsayılan değer `"1M"`.

**openedAt** `string`

Hesabın açıldığı zaman, ISO 8601 zaman damgası olarak. `ALL`, beş yıllık varsayılanı yerine buradan başlar; böylece bundan daha eski bir hesap tüm geçmişini korur. Varsayılan değer `""`.

**accountName** `string`

Hesap adını etikete ekler: normalde `Total balance · Acme`, izleyici bir noktayı okurken ise `Acme balance on Jul 9`. Bu olmadan etiket yalnızca `Total balance` olur. Varsayılan değer `""`.

**brush** `object | null`

Grafikteki seçili aralık, ISO 8601 zaman damgaları olarak. Seçimi kendiniz kontrol etmek için ayarlayın veya izleyicinin yaptığı seçimi temizlemek için `null` yapın. `rangeBrushed` olayının bildirdiğini geri yansıtın; böylece sayfanızın başka bir yerinde bir filtreyi temizlemek buradaki seçimi de temizler. Varsayılan değer `null`.

**özellikler**

**from** `string` *required*

**to** `string` *required*

**markedAt** `string`

Grafikte işaretlenecek bir an, ISO 8601 zaman damgası olarak — sayfanızdaki başka bir şeyin işaret ettiği nokta; örneğin bir etkinlik listesinde işaretçinin altındaki satır. İzleyicinin o noktanın üzerine kendisi gelmiş gibi okunur ve ekrandaki pencerenin dışına düştüğünde veya izleyici grafiği okurken yok sayılır. Varsayılan değer `""`.

**includeOwnedAccounts** `boolean`

Bir kullanıcı için yalnızca kendi parası yerine kendi parasıyla birlikte sahip olduğu her hesabın toplamını alır. Zaten tek bir hesap olan bir hesap için yok sayılır. Varsayılan değer `false`.

**hideTotal** `boolean`

Toplamı ve değişimini gizler; grafik ve aralık düğmeleri kalır. Varsayılan değer `false`.

**hideChart** `boolean`

Grafiği gizler; toplam ve aralık düğmeleri kalır. Varsayılan değer `false`.

**height** `number`

Grafiğin piksel cinsinden çizim yüksekliği. Varsayılan değer `210`.

## Olaylar

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

### `onRangeChanged`

Görünür zaman aralığı değişti. Sayfanızdaki başka bir şey aynı dönemi okuyorsa onu yansıtın.

**payload** `object`

**özellikler**

**range** `"1D" | "1W" | "1M" | "1Y" | "ALL"` *required*

### `onRangeBrushed`

İzleyici bir aralık seçmek için grafik üzerinde sürükledi veya seçimi temizledi (`null`). ISO 8601 zaman damgalarını ve okundukları aralığı verir; böylece etkinlik listesi veya tablo gibi kendi görünümlerinizi aynı döneme göre filtreleyebilirsiniz.

**payload** `object | null`

**özellikler**

**from** `string` *required*

**to** `string` *required*

**range** `"1D" | "1W" | "1M" | "1Y" | "ALL"` *required*

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

### `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\<BalanceElementProps\>` *required*

## Stil verme

Bu parçalara `appearance.classes` aracılığıyla stil verin. Özellik adları için camel case veya kebab case kullanın ve birimleri ekleyin. Sayfa stil sayfaları elementin çerçevesine ulaşamaz. Framework her bildirimi eklemeden önce doğrular.

| Sınıf | Hedef |
| - | - |
| `.whop-Balance` | Toplam, çizgisi ve pencere seçici |
| `.whop-BalanceBrushSummary` | Ölçülen aralık |
| `.whop-BalanceChart` | Bakiye çizgisi |
| `.whop-BalanceRanges` | Pencere seçici |
| `.whop-BalanceTotal` | Toplam ve değişimi |

```ts theme={null}
const wallet = whop.wallet.create({
  appearance: {
    classes: {
      'whop-Balance': { borderRadius: '8px', fontWeight: '600' },
      'whop-BalanceBrushSummary': { borderRadius: '8px', fontWeight: '600' },
      'whop-BalanceChart': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

// 5 classes use this shape
wallet.update({
  appearance: { classes: { 'whop-Balance': { fontWeight: '700' } } }
});
```

React'te `appearance` değerini `<Wallet>` bileşenine iletin. Genel olarak `WhopElements({ appearance })` ile ayarlayın.

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

**currency** `String`

Toplamın ve grafiğin gösterildiği para birimi. Varsayılan değer `"usd"`.

**range** `WalletBalanceRange`

Grafiğin açıldığı zaman aralığı: `.oneDay`, `.oneWeek`, `.oneMonth`, `.oneYear`, `.all`. Varsayılan değer `.oneMonth`; izleyici seçiciyle değiştirebilir.

## Durumlar

Veriler yüklenirken yer tutucu bir grafik gösterir. Karşılaştırma dönemi başarısız olursa değişim tahmin edilmek yerine gizlenir; böylece ekrandaki her sayı gerçekten ölçülmüş bir sayıdır. Çözümlenemeyen bir hesap kimliği dönmeye devam etmek yerine `Couldn't load this account.` gösterir.

## Bilmekte fayda var

* Grafikte gezinmek için basılı tutup sürükleyin. Başlık parmağınızın altındaki noktayı izler ve bıraktığınızda toplama geri döner.
* Bakiye geçmişi yalnızca `biz_` önekli hesap kimlikleri için kullanılabilir; bu nedenle `user_` önekli kişisel bir hesap toplamı grafik olmadan gösterir.
* Aynı toplamı tek tek varlıklara ayıran [`ListElement`](https://docs.whop.com/tr/elements/latest/wallet/balances-list#swift) ile birlikte kullanılır.

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


## Related topics

- [Balances](https://docs.whop.com/tr/elements/latest/wallet/balances.md)
- [Elements ile başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md)
- [ListElement](https://docs.whop.com/tr/elements/latest/wallet/balances-list.md)
