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

# PaymentElement

> Kullanılabilir ödeme yöntemlerini gösterir ve seçilen yöntemin gerekli alanlarını ve bilgilendirmelerini toplar. Ödeme düğmenizi etkinleştirmek için `change` kullanın. Etkinleştirme işleyicisinde `payments.createConfirmationToken()` çağırın. Token'ı sunucu tarafında onaylayın, ardından bekleyen herhangi bir adımı `payments.handleNextAction(…)` metoduna iletin. Adrese bağlı güncellemeler için `addressChange` kullanın.

> [!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. `select()` çağırmak için oluşturulan tanıtıcıyı veya React `ref` değerini saklayın.

> [!NOTE]
>
> **Dışlayıcı.**`PaymentElement`, bu Payments tanıtıcısında `CardElement` veya `CardFields` için bir alternatiftir. Aynı anda yalnızca birini bağlayın. Başka birini bağlamadan önce onu yok edin.

> [!NOTE]
>
> **`BrandingElement` öğesini bekler.** Bu element, aynı Payments tanıtıcısında `BrandingElement` bağlanana kadar yükleme durumunda kalır.

Bir `WhopPayments` kapsamı içine bağlanır. Ücretin sunduğu yöntem kutucuklarını, ardından seçilen yöntemin topladığı her şeyi gösterir: kart alanları, yöntemin bildirdiği alanlar veya Apple Pay düğmesi.

Ücretin ve onay token'ının sahibi olan `<Payments>` içine bağlayın. `<Payments>` ise `<WhopElements>` içine bağlanır. Ücret için yöntem kutucuklarını gösterir ve seçilen yöntemin bildirdiği her şeyi toplar; böylece bir kart, bir cüzdan ödeme ekranı ve bir banka yönlendirmesi aynı tek satırdır.

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

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

```tsx React Native theme={null}
import { useRef, useState } from 'react';
import { Button, ScrollView } from 'react-native';
import { EmailElement, PaymentElement, Payments, type PaymentsHandle } from '@whop/elements-react-native';

export function PaymentStep() {
  const payments = useRef<PaymentsHandle | null>(null);
  const [ready, setReady] = useState(false);

  return (
    <Payments
      ref={payments}
      accountId="biz_xxxxxxxx"
      plan="plan_xxxxxxxx"
      returnUrl="https://example.com/checkout/return"
    >
      <ScrollView>
        <EmailElement />
        <PaymentElement onChange={(p) => setReady(p.complete)} />
      </ScrollView>
      <Button
        title="Pay"
        disabled={!ready}
        onPress={async () => {
          const token = await payments.current!.createConfirmationToken();
          console.log(token.confirmationToken, token.type);
        }}
      />
    </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('payment', {
    onChange: (e) => console.log(e),
    onAddressChange: (e) => console.log(e)
  }).mount('#payments-payment');
  payments.create('branding').mount('#payments-branding');
</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 selection = WhopPaymentSelection(isComplete: false, type: nil, displayName: nil, category: nil)

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

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

[React Native örnek uygulamasında Android üzerinde çalışan PaymentElement](https://app.revyl.ai/embed/c05028fb-0d33-4f36-b6f9-5339a4b9a054?controls=0)

## Prop'lar

**order** `string[]`

Her iki düzende de görüntüleme sırasını kontrol eder. Listelenen türler sırayla önce görünür. Listelenmeyen türler göreli sıralarını korur. Kullanılabilirliği etkilemez. Varsayılan değer `[]`.

**wallets** `object`

Elementin hangi cüzdanları sunduğunu kontrol eder. Her anahtar varsayılan olarak `'auto'` değerini alır; bu, cüzdanı hesabın, alıcının cihazının ve ücretin desteklediği her yerde sunar. `'never'`, o cüzdanı yöntem listesinden kaldırır. Sayfanız kendi Apple Pay, Google Pay veya PayPal düğmelerini `paymentRequest` ile çiziyorsa, alıcıların her cüzdanı yalnızca bir kez görmesi için bunu kullanın. `payPal: 'never'`, PayPal yöntemini kaldırır. Kayıtlı ödeme yöntemleri etkilenmez. Varsayılan değer `{}`. `v1.8.0` sürümünden beri.

**özellikler**

**applePay** `"never" | "auto"`

**googlePay** `"never" | "auto"`

**payPal** `"never" | "auto"`

**fields** `object`

Fatura bilgilerinin toplanmasını kontrol eder. `billingDetails: 'minimal'` (varsayılan) her yöntemin matrisini izler. Yöntemler varsayılan olarak adı ve ülkenin eksiksiz biçimini toplar. Bir geçersiz kılma yalnızca bildirilen minimumu topluyor ya da hiçbir şey toplamıyor olabilir. Kartlar için minimum, kart üzerindeki ad, ülke ve posta kodudur. `'full'`, her yeni yöntem için adı ve ülkenin eksiksiz biçimini zorunlu kılar. `'never'` bloğu gizler. `address: 'minimal'` yalnızca her yöntemin bildirdiği minimumu ve bu minimumun ülke içermediği her yerde bir ülkeyi toplar (`billingDetails: 'full'` ödemenin vergilendirildiğini belirtiyorsa posta kodunu da); ancak hiç adres toplamayan cüzdanlar, kripto, banka borçlandırmaları, banka havaleleri, kartın fiziksel olarak sunulduğu ödemeler ve uygulama içi satın almalar ile sağlayıcısı eksiksiz fatura adresi gerektiren (`requires_full_billing_address`) ve kutucuğu işaretlenmemiş bir ödemeyle aynı kuralları izleyen yöntemler bunun dışındadır; aksi takdirde `billingDetails: 'full'` ayarına üstün gelir; satıcı eksiksiz bir fatura adresi toplamıyorsa bunu kullanın. `phone: 'never'`, formunuz fatura telefonunu zaten topluyorsa yalnızca o girişi gizler; bunu gerektiren yöntemler için `billingDetails.phone` değerini `createConfirmationToken` metoduna iletin. Bunun yerine adresi `createConfirmationToken` metoduna iletin. Ülke seçici yalnızca yöntemin ve ödeme para biriminin desteklediği ülkeleri içerir. Bir taksit planı seçiliyken, planın hizmet verdiği ülkelere daralır; fatura ülkesi, ücretin altında işlendiği işlem ülkesidir. Yalnızca bir ülke mevcut olduğunda kilitlenir. Varsayılan değer `{"billingDetails":"minimal"}`.

**özellikler**

**billingDetails** `"minimal" | "full" | "never"`

**address** `"minimal" | "auto"`

**phone** `"never" | "auto"`

**defaultValues** `object`

Her yöntemin fatura bloğu ilk kez görüntülendiğinde fatura bilgilerini önceden doldurur. Alıcı önceden doldurulan her alanı düzenleyebilir. `address.country` bir ISO 3166-1 alpha-2 kodudur ve yalnızca seçilen yöntem bunu kabul ettiğinde uygulanır. `phone`, telefon toplayan yöntemler için fatura telefonu girişini `+14155552671` gibi E.164 biçiminde doldurur; yöntemin desteklediği telefon ülkelerinin dışındaki bir numara yok sayılır. Yalnızca bloğun görüntülediği alanlar önceden doldurulur ve gönderilir. Diğer her şeyi `billingDetails` içinde `createConfirmationToken` metoduna iletin. `v1.1.0` sürümünden beri.

**özellikler**

**billingDetails** `object`

**özellikler**

**name** `string`

**phone** `string`

**address** `object`

**özellikler**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**layout** `"accordion" | "horizontal"`

Seçici düzeni. `accordion` (varsayılan) yöntemleri üst üste dizer ve ayrıntıları satır içinde genişletir. `horizontal`, eşit genişlikte, kaydırılmayan kutucuklar ve altında seçili ayrıntıları gösterir. Dört yöntemden sonra bir Daha Fazla kutucuğu yerel bir seçici açar. Orada seçilen yöntem, bir sonraki seçime kadar son kutucuğu kaplar. Seçim ve onay aynı şekilde davranır. Varsayılan değer `"accordion"`.

**separated** `boolean`

Yalnızca `accordion`. Yöntemler arasına boşluk ve ayrı kart stili ekler. `layout` değeri `horizontal` olduğunda yok sayılır. Varsayılan değer `false`.

**autoSelect** `boolean`

Çözümlemeden sonra sunulan ilk yöntemin seçilip seçilmeyeceği. Varsayılan `true` değeri `order` ayarına uyar ve bir alıcı etkileşimi gibi `selected` ile `change` olaylarını yayar. Alıcı etkileşiminden önce bir kez çalışır ve hiçbir yöntem sunulmadığında hiçbir şey yapmaz. Seçimsiz bağlamak için `false` olarak ayarlayın. Bundan bağımsız olarak, bir güncelleme seçili yöntemi kaldırırsa seçim, sunulan ilk yönteme geri döner. Zaten seçimsiz olan bir element seçimsiz kalır. Varsayılan değer `true`.

## Olaylar

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

### `onChange`

Seçim değiştiğinde tetiklenir. `complete: true`, alıcının bir yöntem seçtiği ve kart alanlarını veya gerekli girişlerini tamamladığı anlamına gelir. Onayı etkinleştirmek için bunu kullanın. `paymentMethod`, kayıtlı ya da yeni seçili ödeme yöntemidir veya hiçbir şey seçili değilken `null` olur: `displayName` ve `icons` seçimi elementin gösterdiği şekilde adlandırır (`balance.imageUrl` ile bir bakiye sahibinin görseli), `card` bir kartın ağını, son dört hanesini ve fon türünü taşır, `requiresBillingPhone` yöntemin fatura bilgilerinde telefon gerektirip gerektirmediğini belirtir ve `countries` yöntemin ücretin para biriminde hangi ülkelerden ödeme yapabileceğini listeler. Üst düzeydeki `type`, `requiresBillingPhone` ve `method` kullanımdan kaldırılmıştır: bunları `paymentMethod` içinden okuyun. Üst düzeydeki `supportsBuyerFee` de herhangi bir alternatifi olmadan kullanımdan kaldırılmıştır: Whop alıcı hizmet ücretini kendisi fiyatlandırır.

**payload** `PaymentElementChangeEvent`

**özellikler**

**complete** `boolean` *required*

Alıcının bir yöntem seçip seçmediği ve kart alanlarını veya gerekli girişlerini tamamlayıp tamamlamadığı. Onayı etkinleştirmek için bunu kullanın.

**paymentMethod** `PaymentElementPaymentMethod | null` *required*

Seçili ödeme yöntemi veya hiçbir şey seçili değilken `null`.

**özellikler**

**id** `string | null` *required*

Alıcının seçtiği kayıtlı ödeme yöntemi; alıcının şu anda girdiği bir yöntem veya bir bakiye için `null`.

**type** `string` *required*

Ödeme yöntemi türü: `card`, `klarna`, `apple_pay`, `balance` vb.

**category** `string` *required*

Türün ait olduğu aile; örneğin `card`, `wallet`, `bnpl` veya `balance`.

**displayName** `string` *required*

Seçimin nasıl adlandırılacağı: kayıtlı bir yöntemin kendi etiketi ("Visa •••• 4242", "Cash App \$tag"), bir bakiyenin adı ("Acme", "Personal Balance"), alıcı yazarken bir kartın ağı ve son dört hanesi ya da aksi hâlde yöntemin kendi adı ("Klarna").

**icons** `PaymentMethodIcons`

Seçimin simge görseli: kayıtlı bir yöntemin kendi simgeleri, yazılan bir kartın ağ görseli ya da aksi hâlde yöntemin simgeleri. Her zaman SVG ve PNG sürümleri olan bir simge setidir.

**özellikler**

**square** `PaymentMethodIconVariants | null`

**özellikler**

**light** `object` *required*

**özellikler**

**svg** `string` *required*

**dark** `object` *required*

**özellikler**

**svg** `string` *required*

**card** `PaymentMethodIconVariants | null`

**özellikler**

**light** `object` *required*

**özellikler**

**svg** `string` *required*

**dark** `object` *required*

**özellikler**

**svg** `string` *required*

**balance** `object`

Bir bakiye seçimi hakkında türünün ötesinde bilinenler: `imageUrl`, bakiye sahibinin görselidir; `icons` yerine gösterilecek, simge seti değil tek bir raster görsel URL'sidir. Diğer yöntemlerde ve sahibinin görseli olmayan bir bakiyede bulunmaz.

**özellikler**

**imageUrl** `string`

**card** `object`

Bir kart seçimi hakkında bilinenler: kayıtlı bir kartın ayrıntıları veya alıcı yazarken yazılan bir kartın ayrıntıları. Diğer yöntemlerde bulunmaz.

**özellikler**

**network** `string`

**last4** `string`

**funding** `string`

**requiresBillingPhone** `boolean` *required*

`fields.phone` elementin kendi telefon girişini devre dışı bıraktığı durum dahil, yöntemin fatura bilgilerinde telefon gerektirip gerektirmediği.

**countries** `string[]` *required*

Yöntemin ücretin para biriminde ödeme yapabildiği, küçük harfli iki harfli ülke kodları.

**type** `string` *deprecated*

> [!WARNING]
>
> Kullanımdan kaldırıldı. `paymentMethod.type` kullanın.

**supportsBuyerFee** `boolean` *deprecated*

> [!WARNING]
>
> Kullanımdan kaldırıldı. Whop alıcı hizmet ücretini kendisi fiyatlandırdığından bir sayfanın buna ihtiyacı yoktur. Bir sonraki ana sürümde kaldırılacak.

**requiresBillingPhone** `boolean` *deprecated*

> [!WARNING]
>
> Kullanımdan kaldırıldı. `paymentMethod.requiresBillingPhone` kullanın.

**method** `object` *deprecated*

> [!WARNING]
>
> Kullanımdan kaldırıldı. `paymentMethod` kullanın. Alıcı kayıtlı bir yöntem seçtiğinde bulunmaz.

**özellikler**

**type** `string` *required*

**category** `string` *required*

**template** `string` *required*

**display\_name** `string` *required*

**countries** `object[]` *required*

**özellikler**

**country** `string` *required*

**min\_amount** `number | null` *required*

**max\_amount** `number | null` *required*

**min\_amount** `number | null` *required*

**max\_amount** `number | null` *required*

### `onAddressChange`

Dahili fatura adresi değiştikten yaklaşık 300 ms sonra tetiklenir. Vergi, kargo veya adrese bağlı diğer güncellemeler için bunu kullanın. `country` bir ISO 3166-1 alpha-2 kodudur. Yük, boş olan veya o ülke için kullanılmayan diğer adres anahtarlarını içermez. `complete: true`, fatura bloğunun geçerli ve eksiksiz olduğu anlamına gelir. Bu olay yalnızca adres toplama ödeme elementine ait olduğu sürece tetiklenir. `fields.billingDetails: 'never'` ile kendi adres kaynağınızı kullanın. Bağlı bir `AddressElement` ile onun `change` olayını kullanın.

**payload** `object`

**özellikler**

**complete** `boolean` *required*

**address** `object` *required*

**özellikler**

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *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.

### `select`

Bir alıcı etkileşimiyle aynı yoldan bir yöntem seçer. Örneğin `select('cashapp')` kutucuğu genişletir ve `selected` ile `change` olaylarını yayar. Kartlar, alanları tamamlanana kadar `complete: false` olarak kalır. Bilinmeyen, kullanılamayan veya tutara bağlı olarak kısıtlanan yöntemler `METHOD_NOT_OFFERED` koduyla reddedilir. `select(null)` seçimi temizler ve `complete: false` ile `change` yayar. Tam harici kontrol için `autoSelect={false}` ile birlikte kullanın.

**Parametreler**

**input** `string | null` *required*

**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\<PaymentElementProps\>` *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-Address` | Adres formunun kökü |
| `.whop-AddressErrorSummary` | Doğrulama eksik veya geçersiz alanları ortaya çıkardığında gösterilen özet satırı |
| `.whop-AddressField` | Adres formundaki tek bir alan hücresi |
| `.whop-AddressFieldError` | Bir adres alanının hata satırı: tam düzende alanın altında, kompakt düzende bir composer mesajı için grubun altında |
| `.whop-AddressFieldInput` | Adres formundaki bir metin girişi |
| `.whop-AddressFieldInputInvalid` | Bir adres girişi doğrulamadan geçemediği sürece ona eklenir |
| `.whop-AddressFieldInvalid` | Kompakt bir alan hücresi doğrulamadan geçemediği sürece ona eklenir |
| `.whop-AddressFieldLabel` | Adres alanı etiketi: alanın üstünde veya kayan etiketlerle alanın içinde |
| `.whop-AddressFieldSelect` | Adres formundaki bir seçim kutusu (ülke, eyalet, kuruluş türü) |
| `.whop-AddressGroup` | Kompakt düzende tüm alanları içeren kenarlıklı grup |
| `.whop-AddressLine2Toggle` | Daraltılmış adres satırı 2 açma/kapama düğmesi |
| `.whop-AddressManualEntry` | Daraltılmış formun altındaki "Enter address manually" metin düğmesi; ülkenin tam biçimini genişletir |
| `.whop-AddressSearchButton` | Telefonda sokak alanının sonundaki arama düğmesi |
| `.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-AddressSuggestions` | Adres satırı 1 alanına sabitlenmiş otomatik tamamlama önerileri katmanı |
| `.whop-AddressSuggestionsEmpty` | Sorgu hiçbir adres eşleşmesi olmadan sonuçlandığında gösterilen sade satır |
| `.whop-CardField` | Kart numarası, son kullanma tarihi veya güvenlik kodu alanı |
| `.whop-CardFieldError` | Kart doğrulama mesajı |
| `.whop-CardFieldGroup` | Gruplanmış kart alanları: numara üstte, son kullanma tarihi ve güvenlik kodu altta |
| `.whop-CardFieldInput` | Kenarlıklı PCI giriş kapsayıcısı |
| `.whop-CardFieldInputFocused` | Odaklanmış PCI giriş kapsayıcısı |
| `.whop-CardFieldInputInvalid` | Geçersiz veya eksik PCI giriş kapsayıcısı |
| `.whop-CardLabel` | Kart bilgileri etiketi |
| `.whop-Payment` | Ödeme elementinin kökü |
| `.whop-PaymentBalance` | Bakiye kutucuğundaki tek bir cüzdan |
| `.whop-PaymentBalanceHint` | Cüzdanın ücret para birimindeki kullanılabilir tutarı |
| `.whop-PaymentBalanceList` | Bakiye kutucuğunun alıcının cüzdanlarını içeren kaydırılabilir listesi |
| `.whop-PaymentBalanceMore` | Görünüme kaydırıldıkça daha fazla bakiye yükleyen gözcü satırı |
| `.whop-PaymentBalanceRow` | Tıklanabilir bakiye satırı |
| `.whop-PaymentBalanceRowSelected` | Seçili bakiye satırı |
| `.whop-PaymentBalanceRowUnavailable` | Şu anda ödeme yapamayan (engellenmiş veya boş) bir cüzdan; grileştirilmiş ve devre dışı |
| `.whop-PaymentBillingBlock` | Ödeme elementinin dahili fatura adresi bloğu |
| `.whop-PaymentCardFields` | Satır içi kart alanları paneli |
| `.whop-PaymentCompactBalance` | Kompakt doğrudan ödemede seçili bakiye |
| `.whop-PaymentCompactSavedMethod` | Kompakt doğrudan ödemede seçili kayıtlı yöntem |
| `.whop-PaymentCurrencyFallback` | Hiçbir şey sunulmadığında yedek para birimine geçiş |
| `.whop-PaymentDetailIcon` | Ayrıntı bölgesinin açıklamasının yanındaki şablon simgesi |
| `.whop-PaymentDetailRegion` | Seçili bir yöntem için genişletilmiş ayrıntı bölgesi: önce toplama yüzeyleri (satır içi kart alanları, bildirilen girişler), ardından alt blok olarak açıklama ve bilgilendirme satırları |
| `.whop-PaymentDetailSubtext` | Cüzdan yöntemlerinde açıklamanın altındaki onay alt metni |
| `.whop-PaymentDetailText` | Ayrıntı bölgesinin açıklama satırı |
| `.whop-PaymentError` | Kullanılamayan ödeme yöntemleri hata paneli |
| `.whop-PaymentFieldError` | Bildirilen bir girişin altındaki Geçersiz mesajı |
| `.whop-PaymentFieldInput` | Ayrıntı bölgesinde bildirilen bir yöntem girişi |
| `.whop-PaymentFieldInputInvalid` | Bildirilen bir girişin değeri bildirilen biçime uymadığı sürece ona eklenir |
| `.whop-PaymentFieldLabel` | Bildirilen ödeme alanı etiketi |
| `.whop-PaymentInstallmentDetail` | Bir taksit seçeneği satırının taksit başına tutarı |
| `.whop-PaymentInstallmentLabel` | Bir taksit seçeneği satırının etiketi |
| `.whop-PaymentInstallmentList` | Taksit seçicinin seçenek listesi |
| `.whop-PaymentInstallmentRadio` | Bir taksit seçeneği satırındaki radyo göstergesi |
| `.whop-PaymentInstallmentRow` | Tek bir taksit seçeneği satırı |
| `.whop-PaymentInstallmentRowSelected` | Seçili taksit seçeneği satırı |
| `.whop-PaymentInstallments` | Ödeme yöntemi taksit seçicisi |
| `.whop-PaymentInstallmentsLabel` | Taksit seçicinin başlığı |
| `.whop-PaymentInstallmentsNotice` | Bildirilmiş ücreti olmayan seçili bir kademenin altındaki kart çıkarıcı ücreti uyarısı |
| `.whop-PaymentMandateLink` | Talimat bildirimi içindeki talimat koşulları bağlantısı |
| `.whop-PaymentMandateNotice` | Matris yapılandırması bir talimat (mandate) bildiren yöntemlerdeki talimat yetkilendirme bildirimi |
| `.whop-PaymentMethod` | Tek bir ödeme yöntemi: satır ve genişleyen ayrıntı bölgesi |
| `.whop-PaymentMethodDetail` | Seçili yöntemin ayrıntısını ortaya çıkaran genişleyen bölge: satır içi kart alanları, açıklama veya bildirilen girişler |
| `.whop-PaymentMethodIcon` | Bir satırdaki yöntem simgesi |
| `.whop-PaymentMethodLabel` | Bir satırdaki yöntemin görünen adı |
| `.whop-PaymentMethodMoreSelect` | Daha Fazla kutucuğunun üzerine yayılan görünmez yerel seçim kutusu |
| `.whop-PaymentMethodMoreTile` | Yöntem simgeleri ve yerel bir seçici içeren taşma kutucuğu |
| `.whop-PaymentMethodPanel` | Kutucuk satırının altındaki seçili yöntemin ayrıntı paneli (yatay düzen) |
| `.whop-PaymentMethodRadio` | Bir yöntem satırındaki radyo göstergesi |
| `.whop-PaymentMethodRadioSelected` | Seçili ödeme yöntemi radyosu |
| `.whop-PaymentMethodRow` | Tıklanabilir ödeme yöntemi satırı |
| `.whop-PaymentMethodRowSelected` | Seçili ödeme yöntemi satırı |
| `.whop-PaymentMethods` | Ödeme yöntemi listesi |
| `.whop-PaymentMethodSelected` | Seçili ödeme yöntemine eklenir: satırı ve genişletilmiş ayrıntı bölgesi |
| `.whop-PaymentMethodSeparated` | Bir yöntem öğesine veya daha fazla yöntem genişleticisine, kendi ayrı kartı olarak gösterildiği sürece eklenir |
| `.whop-PaymentMethodsSeparated` | Ayrılmış akordeon yöntem listesi |
| `.whop-PaymentMethodTile` | Yatay kutucuk satırındaki tek bir yöntem kutucuğu |
| `.whop-PaymentMethodTileRow` | Taşan yöntemlerin son Daha Fazla kutucuğunda yer aldığı yatay yöntem kutucuğu satırı |
| `.whop-PaymentMethodTileSelected` | Seçili ödeme yöntemi kutucuğu |
| `.whop-PaymentMoreRow` | "N more payment methods" genişletici satırı |
| `.whop-PaymentPayerDocument` | Para birimine özgü alıcı kimlik belgesi alanları |
| `.whop-PaymentPayerDocumentError` | Alıcı kimlik belgesi hatası |
| `.whop-PaymentPayerDocumentLabel` | Alıcı kimlik belgesi etiketi |
| `.whop-PaymentPayerDocumentType` | Alıcı kimlik belgesi türü seçicisi |
| `.whop-PaymentSavedMethod` | Özellikle tek bir kayıtlı ödeme yöntemi; PaymentMethod sınıfını da taşır |
| `.whop-PaymentSavedMethodHint` | Kayıtlı yöntemin sondaki ayrıntısı: bir kartın son kullanma tarihi |
| `.whop-PaymentSavedMethodRow` | Özellikle tıklanabilir kayıtlı yöntem satırı; PaymentMethodRow sınıfını da taşır |
| `.whop-PaymentSavedMethodRowSelected` | Seçili kayıtlı ödeme yöntemi satırı |
| `.whop-PaymentSavedMethods` | Özellikle kayıtlı yöntemler listesi; PaymentMethods sınıfını da taşır, böylece tek bir kural her iki listeye de stil verir |
| `.whop-PaymentSavedMethodSeparated` | Özellikle kayıtlı bir yöntemdeki ayrılmış işareti |
| `.whop-PaymentSavedMore` | Kayıtlı ödeme yöntemlerinin sonraki sayfasını getiren kontrol |
| `.whop-PaymentSavedMoreSpinner` | Kayıtlı ödeme yöntemlerinin sonraki sayfası yüklenirken gösterilen yükleme göstergesi |
| `.whop-PaymentSettlementNotice` | Matris yapılandırması bir mutabakat süresi bildiren yöntemlerdeki mutabakat süresi ipucu |

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

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

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

## Parametreler

**order** `[WhopPaymentMethodType]`

Bu bağlama için kutucuk sırası; denetleyicinin `methodOrder` değerini geçersiz kılar. Listelenen türler listedeki konumlarını alır; geri kalanlar gelen sıralarını koruyarak onların arkasında yer alır.

**selection** `Binding\<WhopPaymentSelection\>?`

Geçerli seçimi ve eksiksizliğini geri okur. Denetleyici her durumda ikisini de izler.

## `WhopPaymentSelection`

Bir seçimin döndürdüğü değerler:

* `isComplete: Bool`: seçili yöntem ihtiyaç duyduğu her şeye sahip
* `type: WhopPaymentMethodType?`: seçili yöntem
* `displayName: String?`: matrisin yazdığı şekliyle etiketi
* `category: String?`: `card`, `wallet`, `bank_debit`, …

## Durumlar

Yöntem matrisi yüklenirken iskelet kutucuklar, okuma başarısız olduğunda ise hata mesajı gösterir. Kategorisi bu derlemede çalıştırılamayan bir yöntem, bozuk bir kutucuk olarak gösterilmek yerine atlanır. Bir cüzdan seçmek, onay yüzeyini Apple Pay ile değiştirir.

## Bilmekte fayda var

* Apple Pay uygulamanızdan hiçbir şey gerektirmez: satıcı tanımlayıcısı yok, `In-App Payments` yeteneği yok. Satıcı, Whop hesabında kayıtlı olandır ve cihaz ödeme yapabildiği her durumda kutucuk görüntülenir.
* Bir `secure` alanı bildiren yöntem, onu barındırılan bir giriş olarak gösterir. Bu değerler asla işleminize girmez.
* Oturum açmış bir alıcının saklanan yöntemleri yeni olanların üstünde görünür. Kimlik bilgisini üreten oturum açmayı sunmak için [`WhopEmailElement`](https://docs.whop.com/tr/elements/latest/payments/email#swift) bağlayın; saklanan bir satırı seçmek hiçbir şey toplamaz ve bir referans oluşturur.
* Taksit kademeleri yayımlayan bir kart ücreti, kart panelinin içinde bir plan seçici gösterir. Alıcının kartının kullanamayacağı bir plan soluklaşmak yerine daraltılır ve bölgesi fatura ülkesiyle eşleşmeyen bir plan, herhangi bir tokenizer çalışmadan önce reddedilir.
* Kimlik belgesi gerektiren bir pazar (bugün için bir `ars` ücreti), tür seçiciyi ve numara alanını panelin içinde gösterir. Bu numara karttan farklı olarak tokenizer'a giderken uygulamanızdan geçer, ancak yine de asla Whop'a ulaşmaz.
* Kart ve güvenli alan değerleri oluşturmadan önce tokenleştirilir, bu nedenle uygulamanızdan geçen tek şey onay token'ıdır.
* Bir yöntem fatura ülkesine ihtiyaç duyduğunda yanına [`WhopAddressElement`](https://docs.whop.com/tr/elements/latest/payments/address#swift) bağlayın: kutucuk listesi o ülkenin izin verdiği yöntemlere daralır.

## Kurulum

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

> [!NOTE]
>
> Onu, denetleyiciyi oluşturan ve içeriğine aktaran bir `WhopPayments(accountID:charge:)` kapsamı içine bağlayın. Bir e-posta ile oturum açma bir alıcıyı doğruladığında `payments.buyer` oturum açmış alıcıdır. Whop bu satışlarda kayıtlı satıcı (merchant of record) olduğundan `WhopBrandingElement` de ekranda olmalıdır; `createConfirmationToken` o olmadan reddeder. `.whopElementsAppearance(_:)` ile stil verin. Modül, cüzdan SDK'sının `WhopElements` modülü değil, `Elements` modülüdür. Bkz. [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).

## Prop'lar

**order** `string[]`

Stripe'ın `paymentMethodOrder` semantiğiyle yöntem görüntüleme sırası. Listelenmeyen türler gelen göreli sıralarını koruyarak listelenenlerin arkasında yer alır. `<Payments>` üzerinde de bir kez ayarlanabilir.

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

Her seçim ve eksiksizlik değişikliğinde tetiklenir. Gönder düğmenizi `complete` değerine bağlayın.

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

## `PaymentChangePayload`

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

* `complete: boolean`: seçili yöntem ihtiyaç duyduğu her şeye sahip
* `type?: string`: seçili yöntem türü, örn. `card`
* `method?: { type, category, template, display_name }`: seçili yöntemin matris girdisi

## Durumlar

Yöntem matrisi gelene kadar üç iskelet satır, ardından kutucuklar. Bir kutucuğu seçmek, altındaki ayrıntı bölgesini genişletir. Seçili yöntem ihtiyaç duyduğu her şeye sahip olduğunda `onChange`, `complete` bildirir; gönder düğmenizi kısıtlayan budur. Uygun yöntemi olmayan bir ücret, hiçbir şey göstermemek yerine açıklayıcı bir boş durum gösterir.

## Bilmekte fayda var

* Kart numaraları asla kodunuzdan geçmez. Alanlar PCI açısından yalıtılmış yerel girişlerdir ve SDK Whop'a bir token iletir; böylece uygulamanız PCI kapsamı dışında kalır.
* Apple Pay ve Google Pay her ikisi de platformun kendi ödeme ekranını sunar. Hiçbiri sizden bir şey gerektirmez: Apple Pay, Whop hesabında kayıtlı satıcıyı kullanır, bu nedenle iletilecek bir satıcı tanımlayıcısı veya Xcode'da eklenecek bir yetenek yoktur; `googlePayMerchantName` ise yalnızca ödeme ekranında gösterilen adı ayarlar ve varsayılanı Whop'tur.
* Yönlendirme yöntemleri ve 3D Secure, iOS'ta `ASWebAuthenticationSession`, Android'de Custom Tabs açar. Asla bir WebView değil, sistem tarayıcısı kullanılır; böylece kartı veren kuruluşun sayfası uygulamanızın güven sınırının dışında kalır.
* `<Payments>` üzerindeki `returnUrl` değerini barındırdığınız bir **https** URL'sine ayarlayın. API, https veya loopback dışındaki her şeyi reddeder (`PaymentsApi::ValidateReturnUrl`), bu nedenle özel bir uygulama şeması burada kullanılamaz. Bir derin bağlantı kaydetmezsiniz: kartı veren kuruluş yönlendirdikten sonra `handleNextAction`, ödeme sonuçlanana kadar sorgular ve tarayıcıyı kendisi kapatır.

> [!NOTE]
>
> Uygulamanızı bir kez `<WhopElements getToken={…}>` ile sarın, ardından elementlerin etrafına `<Payments>` bağlayın. Bkz. [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).
