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

# AddressElement

> Bir fatura veya teslimat adresi toplar. Alanlar, sıralama ve doğrulama seçilen ülkeye göre belirlenir. Sokak adresi otomatik tamamlamasını (telefonlarda tam ekran) ve adresi okumak ya da doğrulamak için metotları içerir.

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

> [!NOTE]
>
> **Her `mode` için bir tane.** Tek bir Payments tanıtıcısı altında her `mode` değeri için bir `<AddressElement />` bağlayın. Aynı `mode` ile ikinci bir bağlama reddedilir. Bir elementin `mode` değeri onu oluşturduğunuzda ayarlanır; değiştirmek için elementi yok edin ve yeni bir tane oluşturun.

Bir `WhopPayments` kapsamı içine bağlanır. Fatura adresini seçilen ülkenin kendi biçiminde toplar ve siz bağlasanız da bağlamasanız da denetleyici token oluşturma için onu okur.

Ücretin ve onay token'ının sahibi olan `<Payments>` içine bağlayın. `<Payments>` ise `<WhopElements>` içine bağlanır. Fatura adresini alıcının kendi ülke biçiminde gösterir ve sağlayıcıya yayımlar; böylece `createConfirmationToken`, kendisine herhangi bir şey iletilmeden onu alır.

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

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

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

export function BillingStep() {
  return (
    <Payments accountId="biz_xxxxxxxx" plan="plan_xxxxxxxx">
      <ScrollView>
        <AddressElement
          layout="full"
          scope="full"
          name="combined"
          line2="toggle"
          onChange={({ complete, address }) => console.log(complete, address.country)}
        />
      </ScrollView>
    </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('address', { onChange: (e) => console.log(e) }).mount('#payments-address');
</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 address = PostalAddress()
    @State private var addressComplete = false

    var body: some View {
        WhopPayments(accountID: "biz_xxxx", charge: .plan(id: "plan_xxxx")) { payments in
            ScrollView {
                VStack(alignment: .leading, spacing: 20) {
                WhopAddressElement(address: $address, isComplete: $addressComplete)
                    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 AddressElement](https://app.revyl.ai/embed/d5ebb0fa-b4cb-48b7-8fd4-033f844518c0?controls=0)

## Prop'lar

**mode** `"billing" | "shipping"`

Bunun hangi adresi topladığı: `billing` (varsayılan) veya `shipping`. Tarayıcının otomatik tamamlama amacını da ayarlar. Tek bir tanıtıcı altında her birinden bir tane bağlayabilirsiniz. Fatura ayrıntıları fatura elementinden veya hiçbir fatura elementi bağlı değilse teslimat elementinden gelir. Varsayılan değer `"billing"`.

**name** `"split" | "none" | "combined"`

Ad satırı: tek bir tam ad alanı (varsayılan), ayrı ad/soyad alanları veya hiçbiri. Varsayılan değer `"combined"`.

**line2** `"never" | "toggle" | "always"`

Adres satırı 2: her zaman görünür (varsayılan), bir metin düğmesiyle ortaya çıkar (`toggle`) veya hiç toplanmaz. Varsayılan değer `"always"`.

**defaultValues** `object`

İlk çizimden önce bir kez uygulanan başlangıç değerleri (`address.country` bir ISO 3166-1 alpha-2 ülke kodudur). IP'ye dayalı ülke algılamasına göre önceliklidir.

**özellikler**

**name** `string`

**address** `object`

**özellikler**

**name** `string`

**first\_name** `string`

**last\_name** `string`

**organization** `string`

**organization\_type** `"business" | "individual"`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**layout** `"full" | "compact" | "wrap"`

`full` (varsayılan) etiketli alanları üst üste dizer. `compact`, yer tutucuyla etiketlenmiş alanları tek bir kenarlık içinde gruplar. `wrap`, `full` düzeninin ayrı alanlarını korur ve ayrıca şehir, eyalet ve posta kodunu yan yana koyar. Bunlar ve `full` düzeninin zaten yan yana koyduğu çiftler (ad ve soyad, kuruluş), genişliğin izin verdiği kadar bir satıra sığar ve genişlik daraldıkça alt satıra geçer. Varsayılan değer `"full"`.

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

`above` (varsayılan) her etiketi alanının dışında tutar: `full` düzeninde alanın üstünde, `compact` düzeninde yer tutucusu olarak. `floating`, her iki düzende de her etiketi alanının yer tutucusu olarak kullanır, ardından alanın bir değeri olduğunda yazılan metnin üstünde küçük bir etiket gösterir. Varsayılan değer `"above"`. `v1.5.0` sürümünden beri.

**scope** `"minimal" | "full"`

`full` (varsayılan), seçilen ülkenin eksiksiz adres biçimini izler. `minimal` yalnızca ülke ve posta kodunu toplar. `name`, gerekli ad alanlarını bağımsız olarak ekler. Bunları atlamak için `name` değerini `none` olarak ayarlayın. Bu element bir ödeme yönteminin gerektirdiği alanları eklemez. Kart onayı bir ad, ülke ve posta kodu gerektirir, bu nedenle `name` seçeneğini etkin tutun veya `billingDetails.name` iletin. Varsayılan değer `"full"`.

**organization** `"none" | "name" | "name_with_type"`

Kuruluş alanları: hiçbiri (varsayılan), yalnızca ad veya işletme/bireysel seçicisiyle birlikte ad. Varsayılan değer `"none"`.

**detectCountry** `boolean`

Ülkeyi varsayılan olarak alıcının IP adresinden belirler (ilk çizimden önce çözümlenir). Önce denetleyicinin `countryHint` değerine, ardından US'ye geri döner. Varsayılan değer `true`.

**allowedCountries** `string[]`

İzin verilen ISO 3166-1 alpha-2 ülke kodları. Tek bir kodla seçici görünür kalır ancak yalnızca o ülkeyi sunar.

**autocomplete** `boolean`

Sokak adresi için Google Places önerilerini etkinleştirir. Hiçbir eşleşme görünmezse veya Places engellenmişse liste eşleşme olmadığını bildirir ve alıcıların adresi elle girmesine izin verir. Telefonda öneriler, klavyenin onları kapatacağı alanın altında değil, sokak alanındaki bir arama düğmesinden tam ekran açılır. Düz bir giriş için `false` olarak ayarlayın. Varsayılan değer `true`.

**expanded** `boolean`

Her adres alanını baştan gösterir. Varsayılan olarak (`false`) form sokak adresiyle açılır ve alıcı bir öneri seçtiğinde, bir adres yazdığında veya elle girmeyi seçtiğinde geri kalanını ortaya çıkarır. Varsayılan değer `false`. `v1.6.0` sürümünden beri.

**customFields** `object[]`

Adres formuyla birlikte gösterilen ek alanlar. Değerler doğrulanır ve ayrı `custom` eşlemesinde yayınlanır.

**özellikler**

**key** `string` *required*

**label** `string` *required*

**type** `"phone" | "text" | "select" | "date"` *required*

**position** `string` *required*

`"after_name"`, `"after_organization"`, `"before_country"` veya `"after_address"` değerlerinden biri.

**required** `boolean`

**options** `string[]`

**format** `string`

**autocomplete** `string`

**countryHint** `string`

`defaultValues` ve IP algılamasından sonraki yedek ülke. Bir ISO 3166-1 alpha-2 kodu kullanın. Boş bir değer `US` değerine geri döner. Varsayılan değer `""`.

## Olaylar

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

### `onChange`

Adres değiştiğinde tetiklenir. Ülkeye özgü tüm alanlar ve gerekli özel alanlar geçerli olduğunda `complete` true olur. `address`, `postal_code` dahil olmak üzere onay token'ının `billing_details` adlarını izler. `country` bir ISO 3166-1 alpha-2 kodudur. Özel değerler `custom` içindedir.

**payload** `object`

**özellikler**

**complete** `boolean` *required*

**address** `object` *required*

**özellikler**

**name** `string`

**first\_name** `string`

**last\_name** `string`

**organization** `string`

**organization\_type** `"business" | "individual"`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

**custom** `Record\<string, 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.

### `validate`

Formu doğrular, tüm satır içi hataları ortaya çıkarır ve asla hata fırlatmaz. `complete`, `address` ve `errors` döndürür. `errors`, tam olarak `complete` true olduğunda boştur. Anahtarlar `postal_code` ve `line1` gibi sözleşme adlarını, özel alanlar için `custom:<key>` biçimini ve yükleme sırasında geçici `form` anahtarını kullanır.

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

**complete** `boolean` *required*

**address** `object` *required*

**özellikler**

**name** `string`

**first\_name** `string`

**last\_name** `string`

**organization** `string`

**organization\_type** `"business" | "individual"`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

**errors** `Record\<string, string\>` *required*

### `getValues`

Doğrulama yapmadan veya hataları ortaya çıkarmadan `address` ve `custom` döndürür.

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

**address** `object` *required*

**özellikler**

**name** `string`

**first\_name** `string`

**last\_name** `string`

**organization** `string`

**organization\_type** `"business" | "individual"`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string` *required*

**custom** `Record\<string, string\>` *required*

### `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\<AddressElementProps\>` *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 |

```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' }
    }
  }
});

// 18 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

**address** `Binding\<PostalAddress\>?`

Toplanan adresi geri okur. Denetleyici her iki durumda da onu toplar.

**isComplete** `Binding\<Bool\>?`

Ülkenin gerektirdiği her alan doldurulup geçerli olduğunda true olur.

**mode** `WhopAddressElement.Mode`

`.billing` veya `.shipping`. Shipping, klavyeden teslimat alanlarını ister. Varsayılan değer `.billing`.

**layout** `WhopAddressElement.Layout`

`.full` her alanı etiketler ve üst üste dizer; `.compact` etiketleri yer tutuculara taşır. Varsayılan değer `.full`.

**scope** `WhopAddressElement.Scope`

`.full` ülkenin tam biçimini toplar; `.minimal` yalnızca ülke ve posta kodunu toplar. Varsayılan değer `.full`.

**name** `WhopAddressElement.NameFields`

Tek bir tam ad alanı için `.combined`, ad ve soyad için `.split`, adı dışarıda bırakmak için `.none`. Varsayılan değer `.combined`.

**organization** `WhopAddressElement.OrganizationFields`

`.none`, bir kuruluş adı için `.name` veya ayrıca bunun bir işletme mi yoksa bir birey mi olduğunu sormak için `.nameWithType`. Varsayılan değer `.none`.

**line2** `WhopAddressElement.Line2Field`

`.always` ikinci satırı gösterir, `.toggle` onu bir düğmeyle ortaya çıkarır, `.never` dışarıda bırakır. Varsayılan değer `.toggle`.

**defaultValues** `PostalAddress?`

Başlangıç değerleri. `country` değeri bir ISO 3166-1 alpha-2 kodudur ve algılamaya göre önceliklidir.

**detectCountry** `Bool`

True olduğunda alıcının kendi ülkesiyle başlar. Önce `countryHint` değerine, ardından ücret para biriminin ülkesine, ardından US'ye geri döner. Varsayılan değer `true`.

**allowedCountries** `[String]?`

Seçiciyi, seçilen yöntemin kendi kısıtlamasıyla kesiştirilmiş bu ISO 3166-1 alpha-2 kodlarıyla sınırlar.

**countryHint** `String?`

Ülke zinciri için ISO 3166-1 alpha-2 yedek değeri.

**autocomplete** `Bool`

Alıcı yazarken sokak önerileri. Kapalıyken seçilecek bir şey olmadığından her alan baştan gösterilir. Varsayılan değer `true`.

## `PostalAddress`

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

* `country: String`: ISO 3166-1 alpha-2, büyük harfle
* `line1` / `line2` / `city` / `state` / `postalCode`: `String?`, ülkenin kendi biçiminde
* `name` / `firstName` / `lastName`: `String?`, `name` moduna göre
* `organization` / `organizationType`: `String?`, `organization` moduna göre

## Durumlar

Form hemen görüntülenir. `.full` kapsamında otomatik tamamlama açıkken yerleşim alanları bir öneri veya elle girişten sonra görünür; kapatırsanız her alan bir kerede gösterilir. Hatalar ilk onay denemesinde, ardından canlı olarak ortaya çıkar.

## Bilmekte fayda var

* Sokak önerilerini cihaz üzerinde MapKit sağlar. Whop, alıcının yazarken girdiği sorguyu asla görmez.
* `defaultValues.country` algılamaya göre önceliklidir. Algılama önce `countryHint` değerine, ardından ücret para biriminin ülkesine, ardından US'ye geri döner.
* `allowedCountries`, seçilen yöntemin kendi fatura ülkesi kısıtlamasıyla kesiştirilir; böylece yalnızca tek bir ülkeyi kabul eden bir yöntem seçiciyi kendiliğinden daraltır.
* `PostalAddress`, onay token'ının `billing_details` anahtarlarını kullanır; böylece aynı JSON platformlar arasında çalışır.

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

**mode** `'billing' | 'shipping'`

Otomatik tamamlama amacı. Varsayılan değer `billing`.

**layout** `'full' | 'compact'`

`full` her alanı etiketler ve üst üste dizer. `compact` etiketleri yer tutuculara taşır. Varsayılan değer `full`.

**scope** `'full' | 'minimal'`

`full` ülkenin eksiksiz biçimini izler. `minimal` yalnızca ülke ve posta kodunu toplar. Varsayılan değer `full`.

**name** `'combined' | 'split' | 'none'`

Tek bir tam ad alanı, ad ve soyad veya ad alanı yok. Varsayılan değer `combined`.

**organization** `'none' | 'name' | 'name_with_type'`

Bir kuruluşun toplanıp toplanmayacağı ve ayrıca bunun bir işletme mi yoksa bir birey mi olduğunun sorulup sorulmayacağı. Varsayılan değer `none`.

**line2** `'toggle' | 'always' | 'never'`

İkinci adres satırının nasıl görüneceği. Varsayılan değer, bir "Add address line 2" düğmesi gösteren `toggle` değeridir.

**allowedCountries** `string[]`

Ülke seçiciyi bu ISO 3166-1 alpha-2 kodlarıyla sınırlayın. Seçilen bir ödeme yönteminin kendi ülke listesi bunu daha da daraltır, asla genişletmez.

**detectCountry** `boolean`

Ülkeyi varsayılan olarak alıcının IP adresinden belirler.

**countryHint** `string`

`defaultValues` ve IP algılamasından sonraki yedek ülke. ISO 3166-1 alpha-2.

**defaultValues** `\{ name?: string; address?: Partial\<EmittedAddress\> \}`

Devam ettirilen bir oturum için bağlama sırasında bir kez uygulanan başlangıç değerleri.

**customFields** `CustomFieldSpec[]`

Bildirilen bir konumda (`after_name`, `after_organization`, `before_country`, `after_address`) gösterilen ek alanlar. Zorunlu olanlar `complete` durumunu koşullar.

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

Her düzenlemede geçerli anlık görüntüyle 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.

## `AddressChangePayload`

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

* `complete: boolean`: ülkenin gerektirdiği her alan doldurulmuş ve geçerli
* `address: EmittedAddress`: alıcının şimdiye kadar girdiği bilgiler
* `custom: Record<string, string>`: bildirdiğiniz tüm `customFields` alanlarının değerleri

## Durumlar

Ülke kataloğu yüklenirken üç alanlı bir iskelet, ardından form. Ülkeyi değiştirmek alanları yeniden planlar, çünkü biçim sabit bir küme değil, ülkeye aittir. Ülkenin gerektirdiği her alan doldurulup geçerli olduğunda `onChange`, `complete` bildirir.

## Bilmekte fayda var

* `detectCountry` açıkken ülke varsayılan olarak alıcının IP adresinden, ardından `countryHint` değerinden, ardından US'den belirlenir. `defaultValues.address.country` üçünü de geçersiz kılar.
* `autocomplete` web'de olduğu gibi varsayılan olarak açıktır, ancak Google Places yerine **platform geocoder** tarafından sunulur; bu nedenle API anahtarı, hesap veya ek bağımlılık gerektirmez. iOS, bir parçayı birkaç adayla yanıtlayan, gerçek bir yazarken öneri API'si olan `MKLocalSearchCompleter` kullanır. Android, kısmi bir adresten tahmin yürütmek yerine *eksiksiz* bir adresi çözümleyen `android.location.Geocoder` kullanır: yaklaşık bir sonuç ve yarım yazılmış bir sokakta daha kaba bir sonuç bekleyin. Android anahtarsız bir yazarken öneri özelliği sunmaz ve alternatifi olan Places SDK birkaç megabayt ekler ve bu SDK'yı gömen her uygulamada konum izinlerini zorunlu kılardı.
* Herhangi bir platformun yetersiz kalması tasarım gereği sessizdir: arka ucu, ağı veya eşleşmesi olmayan bir geocoder hiçbir şey göstermez ve alıcı adresi, zaten başladığı gibi, elle yazar. Otomatik tamamlama hiçbir zaman bir ödemeyi engellemez.
* Yayınlanan adres, web elementi ve onay token'ının `billing_details` değeriyle aynı anahtarları kullanır; böylece tek bir payload biçimi platformlar arasında çalışır.
* Bağlı bir adres elementi, sağlayıcının fatura kaynağıdır. Onu kaldırırsanız `createConfirmationToken`, kendisine doğrudan ilettiğiniz değerlere geri döner.

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

- [PaymentElement](https://docs.whop.com/tr/elements/latest/payments/payment.md)
- [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)
