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

# SendElement

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

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Wallet /* options */>
        <SendElement onStepChanged={(e) => console.log(e)} onSendCompleted={(e) => console.log(e)} onLinkCreated={(e) => console.log(e)} onDone={(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('send', {
    onStepChanged: (e) => console.log(e),
    onSendCompleted: (e) => console.log(e),
    onLinkCreated: (e) => console.log(e),
    onDone: (e) => console.log(e)
  }).mount('#wallet-send');
</script>
```

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

## Prop'lar

**accessToken** `string`

Ayrıcalıklı okuma/yazma için kapsamlı bir token — doğrudan transferler için `payout:transfer_funds`, alıcı listeleri için `payout:withdraw_funds` ve talep bağlantıları için `airdrop_link:manage` gerektirir. Atlanırsa okuma izleyicinin kendi oturumunu taşır; bu da yalnızca aynı origin'de yanıt verir.

**title** `string`

Alıcı seçicinin başlığını geçersiz kılar. Atlanırsa başlık "Choose recipient" olur.

**canSearchRecipients** `boolean`

Alıcı aramasını etkinleştirir. Altıdan az kayıtlı alıcısı olanlara kişi ve işletme önerir ve yazdıktan sonra Add recipient üzerinden arama yapar. Varsayılan değer `true`.

**canCreateLink** `boolean`

Alıcı seçicide talep bağlantısı eylemini gösterir. `airdrop_link:manage` iznine sahip olmayan bir ana uygulama için kapatın. Varsayılan değer `true`.

**initialRecipient** `SendRecipient | null`

Seçiciyi atlar ve doğrudan bu alıcının tutar ekranında açılır — "bu kişiye öde" eylem satırı için. Bu durumda arkasında seçici olmadığından geri düğmesi gösterilmez. Varsayılan değer `null`.

**özellikler**

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profilePicUrl** `string | null` *required*

**kind** `"email" | "business" | "user"` *required*

**initialCurrency** `string`

Tutar ekranının seçicisinde bir para birimini önceden seçer. Önce `currency` değerine, ardından USD'ye geri döner. Varsayılan değer `""`.

## Olaylar

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

### `onStepChanged`

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

**payload** `object`

**özellikler**

**step** `string` *required*

`"success"`, `"enter_amount"`, `"select_recipient"`, `"add_recipient"`, `"create_link"` veya `"link_success"` değerlerinden biri.

### `onSendCompleted`

Bir transfer başarılı oldu. Kendi tarafınızda hesabın bakiyesini veya etkinliğini okuyan her şeyi yenileyin.

**payload** `object`

**özellikler**

**recipient** `SendRecipient | Omit\<SendRecipient, "kind"\> & object` *required*

**SendRecipient**

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profilePicUrl** `string | null` *required*

**kind** `"email" | "business" | "user"` *required*

**biçim 2**

**id** `string` *required*

**name** `string | null` *required*

**username** `string | null` *required*

**profilePicUrl** `string | null` *required*

**kind** `"bill_pay"` *required*

**nickname** `string | null`

**after** `string`

**methodName** `string` *required*

**destinationCurrency** `string` *required*

**amount** `number` *required*

**currency** `string` *required*

### `onLinkCreated`

Bir talep bağlantısı oluşturuldu. Kendi tarafınızda hesabın bakiyesini okuyan her şeyi yenileyin.

**payload** `object`

**özellikler**

**claimUrl** `string` *required*

**amount** `number` *required*

**redeemableCount** `number` *required*

### `onDone`

İzleyici bir başarı ekranında "Done" düğmesine tıkladı — 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.

### `refresh`

Hesabın bakiyelerini ve alıcı listesini yeniden getirir. Kendi tarafınızda sunabileceklerini değiştiren herhangi bir şeyden sonra çağırın.

**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\<SendElementProps\>` *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-AddressSuggestion` | Otomatik tamamlama katmanındaki tek bir öneri satırı |
| `.whop-AddressSuggestionActive` | Klavye/işaretçi ile etkin olan öneri satırına eklenir |
| `.whop-AddressSuggestionManual` | Öneri listesini kapatan "Enter address manually" satırı |
| `.whop-AddressSuggestionsEmpty` | Sorgu hiçbir adres eşleşmesi olmadan sonuçlandığında gösterilen sessiz satır |
| `.whop-SendSurface` | Send elementinin kökü — bir seferde bir ekran |

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

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

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