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

# EmailElement

> Alıcının e-postasını toplar ve bağlı olduğu sürece `payments.createConfirmationToken()` çağrısına iletir. Açıkça belirtilen `billingDetails.email` önceliklidir. Eşleşen bir Whop hesabı, kod doğrulamasıyla veya hesabın bir geçiş anahtarı (passkey) varsa onunla isteğe bağlı oturum açma seçeneği gösterir. Başarılı oturum açma, ödeme elementindeki kayıtlı ödeme yöntemlerinin kilidini açar. Alıcılar misafir olarak devam edebilir.

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

[`Payments`](https://docs.whop.com/tr/elements/latest/payments/overview) içine bağlanır. Prop'ları ve geri çağırmaları oluşturma seçenekleri veya React prop'ları aracılığıyla iletin.

Bir `WhopPayments` kapsamı içine bağlanır. Her onay token'ının gerektirdiği alıcı e-postasını toplar; siz bağlasanız da bağlamasanız da denetleyici token üretimi için onu okur.

Ödemeyi ve onay token'ını yöneten `<Payments>` içine bağlayın. `<Payments>` ise `<WhopElements>` içine bağlanır. Alıcının e-postasını toplar ve sağlayıcıya yayınlar; böylece `createConfirmationToken` kendisine hiçbir şey iletilmeden onu gönderir.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Payments /* options */>
        <EmailElement onChange={(e) => console.log(e)} />
      </Payments>
    </WhopElements>
  );
}
```

```tsx React Native theme={null}
import { EmailElement, Payments } from '@whop/elements-react-native';

export function ContactStep() {
  return (
    <Payments accountId="biz_xxxxxxxx" plan="plan_xxxxxxxx">
      <EmailElement onChange={({ email, complete }) => console.log(email, complete)} />
    </Payments>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const payments = window.WhopElements().payments.create({ /* options */ });
  payments.create('email', { onChange: (e) => console.log(e) }).mount('#payments-email');
</script>
```

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

// .whopElements(environment:) runs once at the app root. See Getting started.
struct CheckoutScreen: View {
    @State private var email = ""

    var body: some View {
        WhopPayments(accountID: "biz_xxxx", charge: .plan(id: "plan_xxxx")) { payments in
            ScrollView {
                VStack(alignment: .leading, spacing: 20) {
                WhopEmailElement(email: $email)
                    WhopBrandingElement()
                }
                .padding()
            }
        }
    }
}
```

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

[React Native örnek uygulamasında Android üzerinde çalışan EmailElement](https://app.revyl.ai/embed/00ebe239-4c8b-4fe4-90d9-0e57771e2f35?controls=0)

## Prop'lar

**label** `boolean`

Yerelleştirilmiş etiketi gösterir. Kendi etiketinizi sağlıyorsanız `false` olarak ayarlayın. Giriş, yerelleştirilmiş bir `aria-label` değerini korur. Varsayılan değer `true`.

**placeholder** `string`

E-posta girişi için yer tutucu metin. Boş (varsayılan) bırakılırsa `you@example.com` görüntülenir. Kayan etiketlerde bunun yerine etiket metni yer tutucu olur. Varsayılan değer `""`.

**labelMode** `"above" | "floating"`

`above` (varsayılan) etiketi girişin üstünde gösterir. `floating` etiket metnini yer tutucu olarak kullanır, ardından girişte bir değer olduğunda yazılan metnin üstünde küçük bir etiket gösterir. `label` değeri `false` olduğunda yok sayılır. Varsayılan değer `"above"`. `v1.5.0` sürümünden beri.

**defaultValue** `string`

Bağlama sırasında bir kez uygulanan başlangıç değeri. Varsayılan değer `""`.

## Olaylar

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

### `onChange`

E-posta değiştiğinde tetiklenir. E-posta makul göründüğünde `complete` true olur. Oturum açma, bunu oturum açılan e-postayla tetikler; bu e-posta `createConfirmationToken()` çağrısına da aktarılır.

**payload** `object`

**özellikler**

**email** `string` *required*

**complete** `boolean` *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\<EmailElementProps\>` *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-Email` | E-posta elementinin kökü |
| `.whop-EmailChecking` | E-posta kontrol edilirken veya bir oturum açma kodu gönderilirken hareket eden çerçeve |
| `.whop-EmailCodeHint` | Oturum açma kodunu isteyen satır |
| `.whop-EmailError` | Geçersiz e-posta mesajı |
| `.whop-EmailInput` | E-posta girişi |
| `.whop-EmailInputInvalid` | Makul olmayan bir değere sahip e-posta girişi |
| `.whop-EmailLabel` | E-posta alanı etiketi |
| `.whop-EmailPasskey` | E-posta girişinin içindeki geçiş anahtarıyla oturum açma düğmesi |
| `.whop-EmailSignedIn` | Oturum açmış alıcı satırı |
| `.whop-EmailSignIn` | Tekrar hoş geldiniz oturum açma denetimi |
| `.whop-EmailSignInError` | Oturum açma hata mesajı |
| `.whop-EmailSignOut` | Farklı bir e-posta seçme denetimi |
| `.whop-EmailWelcome` | Hesap e-postasının üzerindeki karşılama ekranı selamlaması |
| `.whop-VerificationError` | İletişim kutusundaki hata mesajı |
| `.whop-VerificationInput` | Tek kullanımlık kod girişi |
| `.whop-VerificationInputInvalid` | Başarısız bir denemeden sonra kod girişine eklenir |
| `.whop-VerificationInputSlot` | Tek kullanımlık kod girişinin tek bir hane kutusu |
| `.whop-VerificationInputSlotActive` | Alıcının yazmakta olduğu kod yuvasına eklenir |
| `.whop-VerificationPending` | Bir gönderim sürerken gösterilen "doğrulanıyor…" satırı |

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

// 19 classes use this shape
payments.update({
  appearance: { classes: { 'whop-Email': { fontWeight: '700' } } }
});
```

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

## Parametreler

**email** `Binding\<String\>?`

Değeri geri okur. Denetleyici her durumda onu toplar.

**showsLabel** `Bool`

Kendi etiketinizi sağladığınızda false olarak ayarlayın; giriş erişilebilirlik etiketini korur. Varsayılan değer `true`.

**placeholder** `String?`

Boş bırakılırsa `you@example.com` görüntülenir.

## Durumlar

Hemen görüntülenir. Makul olmayan bir adres, hatasını alan odağı kaybettiğinde, ardından canlı olarak gösterir.

## Bilmekte fayda var

* Bu element olmadan `billingDetails.email` değerini `createConfirmationToken` çağrısına kendiniz iletin. Token üretimi e-postası olmayan bir token'ı reddeder.
* Token üretimi sırasında açıkça belirtilen `billingDetails.email`, bu elementin topladığı değere göre önceliklidir.
* Makul bir adres, gecikmeli olarak ve odak kaybında yeniden hesap dizininde sorgulanır. Tanınan bir adres oturum açma seçeneği sunar ve element altı haneli kod sayfasını kendisi gösterir.
* Doğrulanmış bir oturum açma, [`WhopPaymentElement`](https://docs.whop.com/tr/elements/latest/payments/payment#swift) içinde alıcının kayıtlı ödeme yöntemlerinin kilidini açar. Alıcının kim olduğunu öğrenmek için `payments.buyer` değerini okuyun, onu unutmak için `payments.signOut()` çağırın.
* Kapsamlı token bir saat geçerlidir ve yenilenmez. Süresi dolduğunda kayıtlı yöntemler yolu boş döner ve alıcı, bir misafirin izlediği yolun aynısıyla yeni bir yöntemle öder.

## Kurulum

```swift theme={null}
dependencies: [
    .package(url: "https://github.com/whopio/elements-swift.git", from: "0.1.0")
]
```

> [!NOTE]
>
> Denetleyiciyi oluşturan ve içeriğine ileten bir `WhopPayments(accountID:charge:)` kapsamı içine bağlayın. Bir e-posta oturum açma işlemi alıcıyı doğruladığında `payments.buyer` oturum açmış alıcıdır. `WhopBrandingElement` da ekranda olmalıdır; çünkü bu satışlarda kayıtlı satıcı (merchant of record) Whop'tur ve `createConfirmationToken` onsuz reddeder. `.whopElementsAppearance(_:)` ile stil verin. Modül, cüzdan SDK'sının `WhopElements` modülü değil, `Elements` modülüdür. [Başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md) ve [Görünüm](https://docs.whop.com/tr/elements/latest/appearance.md) sayfalarına bakın.

## Prop'lar

**defaultValue** `string`

Bağlama sırasında bir kez uygulanan başlangıç değeri.

**label** `boolean`

Yerelleştirilmiş etiketi gösterir. Varsayılan değer `true`.

**placeholder** `string`

Boş bırakılırsa `you@example.com` görüntülenir.

**onChange** `(payload: EmailChangePayload) =\> void`

Her düzenlemede tetiklenir.

**style** `StyleProp\<ViewStyle\>`

Elementin dış `View` bileşenine uygulanır. Tema için, bu yüzeydeki her elementi kapsayan sağlayıcı üzerindeki `appearance.parts` seçeneğini tercih edin. React Native parça adlarının bugün web'in `whop-*` sınıf adlarından farklı, kendine ait bir küme olduğunu unutmayın; bu nedenle bir web appearance nesnesi değiştirilmeden aktarılamaz.

**fallback** `ReactNode`

Element yüklenirken yerleşik iskelet yerine gösterilir.

**onReady** `() =\> void`

Element etkileşimli hâle geldiğinde bir kez tetiklenir. `<Payments>` bunları gruplar, bu nedenle genellikle istediğiniz şey onun kendi `onLoadingChange` geri çağırmasıdır.

**onError** `(error: \{ message: string; code?: string \}) =\> void`

Bu element için bir yükleme veya yapılandırma hatası. Element her iki durumda da kendi hata ekranını gösterir.

## `EmailChangePayload`

`onChange` geri çağırmasının döndürdüğü değerler:

* `email: string`: geçerli değer
* `complete: boolean`: adres ayrıştırılabiliyor

## Durumlar

Hemen görüntülenir. Adres ayrıştırılabildiğinde `onChange` `complete` bildirir ve element odak kaybında kendi doğrulama mesajını gösterir.

## Bilmekte fayda var

* Yayınlanan e-posta, onay token'ının `billing_details.email` olarak taşıdığı değerdir. `createConfirmationToken` çağrısına `billingDetails.email` iletmek bunu geçersiz kılar.
* Formunuz kendi etiketini sağlıyorsa `label={false}` ayarlayın. Giriş her iki durumda da erişilebilirlik etiketini korur.

> [!NOTE]
>
> Uygulamanızı bir kez `<WhopElements getToken={…}>` ile sarın, ardından elementlerin etrafına `<Payments>` bağlayın. [Başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md) ve [Görünüm](https://docs.whop.com/tr/elements/latest/appearance.md) sayfalarına bakın.


## Related topics

- [Elements ile başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md)
- [BrandingElement](https://docs.whop.com/tr/elements/latest/payments/branding.md)
- [Payment Elements ile ödeme sayfası oluşturun](https://docs.whop.com/tr/developer/guides/payment-elements.md)
