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

# DepositElement

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

> [!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. `showStep()` ve `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, DepositElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <DepositElement onDepositInitiated={(e) => console.log(e)} onCardDepositRequested={(e) => console.log(e)} onAddCardRequested={(e) => console.log(e)} onBankSelected={(e) => console.log(e)} onIdentityVerificationRequested={(e) => console.log(e)} onPlatformBalanceSelected={(e) => console.log(e)} onDepositConfirmed={(e) => console.log(e)} onStepChanged={(e) => console.log(e)} onDismissed={(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('deposit', {
    onDepositInitiated: (e) => console.log(e),
    onCardDepositRequested: (e) => console.log(e),
    onAddCardRequested: (e) => console.log(e),
    onBankSelected: (e) => console.log(e),
    onIdentityVerificationRequested: (e) => console.log(e),
    onPlatformBalanceSelected: (e) => console.log(e),
    onDepositConfirmed: (e) => console.log(e),
    onStepChanged: (e) => console.log(e),
    onDismissed: (e) => console.log(e)
  }).mount('#wallet-deposit');
</script>
```

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

## Prop'lar

**accessToken** `string`

Kanal çözümlemesinin kişisel (`user_`) bir hesabı okumasına izin veren kapsamlı bir token — `payout:account:read` ve banka kanalının hazırlanması için ayrıca `payout:account:update` gerektirir. Onu sunucunuzda `POST /api/v1/access_tokens` ile oluşturun. Atlanırsa çağrı izleyicinin kendi oturumunu taşır; bu da yalnızca aynı origin'de yanıt verir. İşletme hesapları herhangi bir kimlik bilgisi olmadan çözümlenir.

**amount** `string`

Tutarı önceden doldurur ve salt okunur yapar — borçlu olunan tutarı zaten bilen akışlar için. Sıfır veya altındaki bir tutar yok sayılır, 12 tam basamaktan uzun olan da öyle; geri kalanı para biriminin ondalık basamaklarına yuvarlanır. Varsayılan değer `""`.

**showCrypto** `boolean`

Hesabın bir para yatırma adresi olduğunda kripto kanalını sunar. Varsayılan değer `true`.

**showBank** `boolean`

Banka havalesi kanalını sunar. Hesabın banka bilgileri olmadan önce bile gösterilir — o durumda onu seçmek, hesabın hâlâ borçlu olduğu şey buysa izleyiciden kimliğini doğrulamasını ister, değilse kanalı henüz kullanılamaz olarak bildirir. Varsayılan değer `true`.

**savedCards** `DepositSavedCard[]`

Bu ödeyici için zaten tuttuğunuz kartlar, fonlama satırları olarak gösterilir. Birini seçmek tutarla birlikte `cardDepositRequested` yayar — element hiçbir zaman kart ödemesi toplamaz. Varsayılan değer `[]`.

**özellikler**

**id** `string` *required*

`cardDepositRequested` içinde geri yansıtılan ödeme yöntemi kimliği.

**label** `string` *required*

Satır etiketi; örneğin `Visa •••• 4242`.

**cardBrand** `string | null`

Satır simgesini seçmek için kullanılan marka anahtarı — `visa`, `mastercard`, `amex`, `discover`, `jcb`.

**allowNewCard** `boolean`

Kendi kart toplama akışınızı açabilmeniz için `addCardRequested` yayan bir "Add card" satırı ekler. Varsayılan değer `false`.

**showPlatformBalance** `boolean`

Tutar adımı olmadan hemen `platformBalanceSelected` yayan bir "Platform balance" satırı sunar. Varsayılan değer `false`.

**cardFee** `DepositCardFee | null`

Bir kart satırı seçildiğinde tutarın altında önizlenecek işlem ücretleri. `percentageFee` yüzde PUANI cinsindendir (`2.9` %2,9'dur); `fixedFee` ve `radarFee` ana birimlerdir (`0.3` 0,30 \$'dır). Varsayılan değer `null`.

**özellikler**

**percentageFee** `number` *required*

Kesir değil, yüzde PUANI: `2.9` %2,9 anlamına gelir.

**fixedFee** `number` *required*

Ana birimlerde sabit ücret: `0.3` 0,30 \$ anlamına gelir.

**radarFee** `number` *required*

Ana birimlerde dolandırıcılık tarama ücreti.

**depositRailFees** `Partial\<Record\<"crypto" | "bank", DepositRailFee\>\>`

Kanal seçicinin altındaki hesabın para yatırma ücretlerini kanala göre anahtarlanmış şekilde (`bank`, `crypto`) geçersiz kılar. Atlanan kanallar hesabın döndürdüğü ücretleri kullanır. `percentageFee` yüzde PUANI cinsindendir (`1.5` %1,5'tir); `fixedFeeUsd`, para yatırma para birimi ne olursa olsun USD ana birimidir (`2` 2,00 \$'dır). Bir tutar yazılmadan önce oranı, sonra ise tahsil edilen tutarı gösterir. Varsayılan değer `{}`.

**özellikler**

**crypto** `DepositRailFee`

**özellikler**

**percentageFee** `number` *required*

Kesir değil, yüzde PUANI: `1.5` %1,5 anlamına gelir.

**fixedFeeUsd** `number` *required*

USD ana birimlerinde sabit ücret: para yatırma para birimi ne olursa olsun `2` 2,00 \$ anlamına gelir.

**bank** `DepositRailFee`

**özellikler**

**percentageFee** `number` *required*

Kesir değil, yüzde PUANI: `1.5` %1,5 anlamına gelir.

**fixedFeeUsd** `number` *required*

USD ana birimlerinde sabit ücret: para yatırma para birimi ne olursa olsun `2` 2,00 \$ anlamına gelir.

**preferredMethodId** `string`

Bir kanalı kimliğe göre önceden seçer (`bank`, `crypto`, `platform_balance` veya kayıtlı bir kart kimliği). O kanal henüz sunulmuyorsa, başka bir kanal üzerinden fonlamak yerine Continue devre dışı kalır. Varsayılan değer `""`.

**deferBankToHost** `boolean`

Havale alanlarını göstermek yerine `bankSelected` yayar ve tutar ekranında kalır — hesabın zaten bir sanal banka hesabı olduktan sonra kendi adımını çalıştıran ana uygulamalar için. Varsayılan değer `false`.

**confirmCryptoDeposit** `boolean`

Kripto ekranında `depositConfirmed` yayan bir "I have deposited my funds" düğmesi gösterir; böylece transferi izlemeye başlayabilirsiniz. Varsayılan değer `false`.

**initialStep** `"amount" | "crypto" | "bank"`

Seçici yerine doğrudan bir kanalda açılır. `crypto` ve `bank` tutar gerektirmez; arkalarında seçici olmadığı için geri düğmeleri `dismissed` yayar. Varsayılan değer `"amount"`.

## Olaylar

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

### `onDepositInitiated`

Ödeyici bir tutarı ve kanalı onayladı. Herhangi bir talimat gösterilmeden önce her kanal için tetiklenir — analitik/huni kancası.

**payload** `object`

**özellikler**

**method** `"crypto" | "bank" | "card" | "platform_balance"` *required*

**amount** `number` *required*

**currency** `string` *required*

**paymentMethodId** `string`

### `onCardDepositRequested`

Kayıtlı bir kart seçildi. Ödemeyi kendi tarafınızda toplayın, ardından elementi seçiciye döndürmek için `showStep({ step: "amount" })` çağırın.

**payload** `object`

**özellikler**

**amount** `number` *required*

**currency** `string` *required*

**paymentMethodId** `string` *required*

### `onAddCardRequested`

"Add card" satırı seçildi — kart toplama akışınızı açın.

### `onBankSelected`

`deferBankToHost` ayarlıyken banka kanalı seçildi — adımınızı çalıştırın, ardından alanları kendiniz gösterin veya `showStep({ step: "bank" })` çağırın.

### `onIdentityVerificationRequested`

İzleyici, bu hesabın henüz bir sanal banka hesabı olmadan banka havalesini seçti. Element tutar ekranında kalır ve hiçbir zaman gezinme yapmaz — buna yanıt olarak `verifications` denetleyicisi gibi kendi doğrulamanızı bağlayın.

**payload** `object`

**özellikler**

**accountId** `string` *required*

### `onPlatformBalanceSelected`

Platform bakiyesi satırı seçildi. Hiçbir tutar taşımaz — onu kendi ekranınız toplar.

### `onDepositConfirmed`

Ödeyici kriptoyu gönderdiğini söyledi. `since`, gelen transferleri eşleştirmeye başlamak için unix saniyesi cinsinden bir alt sınırdır (biraz geriye bakar; böylece tıklamadan hemen önce gönderilen bir transfer de eşleşir).

**payload** `object`

**özellikler**

**network** `string` *required*

**token** `string` *required*

**networkLabel** `string` *required*

**since** `number` *required*

### `onStepChanged`

Görünür ekran değişti.

**payload** `object`

**özellikler**

**step** `"amount" | "crypto" | "bank"` *required*

### `onDismissed`

Ödeyici, elementin doğrudan açıldığı bir kanaldan geri çıktı — onu barındıran yüzeyi kapatın.

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

### `showStep`

Elementi bir ekrana taşır. `{ step: "amount" }`, kendi tarafınızda bir kart veya platform bakiyesi para yatırma işlemini tamamladıktan sonra kontrolü geri vermenin yoludur.

**Parametreler**

**input** `object` *required*

**özellikler**

**step** `"amount" | "crypto" | "bank"` *required*

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

### `refresh`

Hesabın fonlama kanallarını yeniden çözümler. Kendi tarafınızda hesabın sunabileceklerini değiştiren herhangi bir şeyden sonra — örneğin banka kaydını tamamlamak — çağırın; böylece yeni kanal önbelleğin süresinin dolmasını beklemeden görünür.

**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\<DepositElementProps\>` *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-DepositSurface` | Deposit elementinin kökü — bir seferde bir ekran |

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

wallet.update({
  appearance: {
    classes: { 'whop-DepositSurface': { fontWeight: '700' } }
  }
});
```

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