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

# Dashboard

> Bir hesabın sitenize gömülü kendi kontrol paneli yüzeyleri. `accountId` ile bir hesaba kapsamlandırın, ardından hesabın ödemeleri için `paymentsTable`, tek bir ödeme için `paymentDetail`, Whop'un kendi kontrol panelinin bakiyenin üstünde gösterdiği bekleyen eylem afişleri (kimlik doğrulama, para yatırma, vergi ve diğerleri) için `required-actions` ve yalnızca kimlik hatırlatması için `verification` bağlayın. Her yüzey aynı kimlik bilgisiyle okur, bu nedenle yan yana iki yüzey her zaman aynı hesabı gösterir. Afişler, hesabın bekleyen hiçbir şeyi kalmadığında hiçbir şey göstermez, bu nedenle bir düzende kalıcı olarak yer alabilirler ve kendilerinin yanıtlayamadığı basışları (Add money ve Verify) bildirirler; böylece ana uygulama, `wallet` denetleyicisinin `deposit` elementi veya `verifications` denetleyicisinin `kyc` elementi gibi kendi para yatırma ya da doğrulama akışını bağlar.

> [!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, Dashboard } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Dashboard /* options */>
        {/* mount elements here */}
      </Dashboard>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const dashboard = window.WhopElements().dashboard.create({ /* options */ });
</script>
```

## Seçenekler

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

**accessToken** `string`

Bu tanıtıcı altındaki her yüzeyin okuma yaparken kullandığı kapsamlı bir token. Sunucunuzda `POST /api/v1/access_tokens` ile tanıtıcının tamamı için tek bir token oluşturun ve süresi dolmadan önce `update({ accessToken })` ile yenisini ayarlayın. Ödemeleri okumak için `payment:basic:read` gerekir; alıcı e-postaları için ayrıca `member:email:read`, müşteri yolculuğu için `member:basic:read`, takip sütunu için `shipment:basic:read` ve bir ödemedeki ürün ve plan adları için `access_pass:basic:read` ile `plan:basic:read` gerekir. Afişler `payout:account:read` gerektirir; eylem çubuğundan doğrulama başlatmak için `identity:write` gerekir. Atlanırsa okumalar izleyicinin kendi oturumunu taşır; bu da yalnızca aynı kaynaktan (same-origin) gelen isteklere yanıt verir.

**accountId** `string` *required*

Bu yüzeylerin kayıtlarını okuduğu hesap veya kullanıcı kimliği. Hesap kimlikleri `biz_` öneklidir; kullanıcı kimlikleri `user_` öneklidir, yalnızca izleyicinin kendi bekleyen eylemlerini okuyabilir ve ödemeleri yoktur.

**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 metinleri 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 tüm değerler varsayılan yerel ayara geri döner.

## Olaylar

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

### `onLoadingChange`

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

**loading** `boolean`

## Metotlar

Bunları `whop.dashboard.create({ … })` veya `useDashboard()` üzerinden alınan Dashboard tanıtıcısında çağırın.

### `update`

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

**Parametreler**

**options** `Partial\<DashboardOptions\>` *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 tüm çağrıları reddeder; baştan başlamak için yeni bir tanıtıcı oluşturun. React, sağlayıcı kaldırıldığında grubu otomatik olarak kaldırır.

## Elementler

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

> [card] [RequiredActionsElement](https://docs.whop.com/tr/elements/latest/dashboard/required-actions.md)
>
> Whop'un bakiye kontrol panelindeki bekleyen eylem afişleri (kimlik doğrulama, para yatırma, vergi ve diğerleri), API'nin döndürdüğü sırayla. Bekleyen hiçbir şeyi olmayan bir hesap hiçbir şey göstermez, bu nedenle element bir düzende kalıcı olarak yer alabilir. Metinler API'den gelir. Verify düğmesine basmak barındırılan bir kimlik oturumu başlatır ve oraya gider; Add money `depositRequested` bildirir ve yerinde kalır, böylece ana uygulama kendi para yatırma akışını, örneğin `wallet` denetleyicisinin `deposit` elementini bağlar; diğer tüm düğmeler eylemin kendi bağlantısını izler. Dashboard tanıtıcısının `payout:account:read` gerektiren `accessToken` değeriyle okur; doğrulamayı başlatmak için ayrıca `identity:write` gerekir. Başarısız bir okuma hata yerine hiçbir şey göstermez; bir afiş asla başkasının sayfasındaki en dikkat çekici şey olmamalıdır.

> [card] [VerificationElement](https://docs.whop.com/tr/elements/latest/dashboard/verification.md)
>
> Hesap sahibinden kimliğini doğrulamasını isteyen, yalnızca doğrulama beklerken gösterilen bir afiş; zaten doğrulanmış bir hesap hiçbir şey göstermez, bu nedenle element bir düzende kalıcı olarak yer alabilir. Başlık ve durum mesajları API'den gelir; hesap sahibini doğrulamaya başlamaya davet ederken daha kısa bir açıklama kullanılır; böylece hesabın gerçek durumunu izlerler: başlatılmamış bir hesap kartların ve ödemelerin kilidini açmaya davet edilir, incelemedeki bir hesap beklemede olarak görünür ve başarısız ya da işaretlenmiş bir hesap da bunu belirtir. Düğmeye basmak `verificationRequested` bildirir ve yerinde kalır, böylece ana uygulama kendi doğrulamasını, örneğin `verifications` denetleyicisinin `kyc` elementini bağlar. Dashboard tanıtıcısının `payout:account:read` gerektiren `accessToken` değeriyle okur. Başarısız bir okuma hata yerine hiçbir şey göstermez; bir hatırlatma asla sayfadaki en dikkat çekici şey olmamalıdır.

> [card] [PaymentsTableElement](https://docs.whop.com/tr/elements/latest/dashboard/paymentsTable.md)
>
> Durum kartları, arama, filtreler, sıralama, satır seçimi, CSV dışa aktarma, sütun ayarları ve sayfalama içeren kontrol paneli ödemeler tablosu. Eksiksiz sayıları hesaplamak ve yerel olarak filtrelemek için tüm ödeme sayfalarını okur; ödeme geçmişi mütevazı olan hesaplar için tasarlanmıştır. Müşteri ayrıntıları ve iadeler olaylar aracılığıyla uygulamanıza devredilir.

> [card] [PaymentDetailElement](https://docs.whop.com/tr/elements/latest/dashboard/paymentDetail.md)
>
> Kontrol paneli dökümü, etkinlik, müşteri, ayrıntılar ve müşteri yolculuğu içeren bir ödeme ayrıntısı sayfası. Her bölüm gizlenebilir. payment:basic:read ile okur; müşteri e-postası için member:email:read, yolculuk için member:basic:read gerekir. Eylem olayları, uygulamanızın değişiklikleri onaylamasını ve yetkilendirmesini sağlar; bu element hiçbir zaman bir ödemeyi kendisi iade etmez, yeniden denemez veya geçersiz kılmaz.
