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

# PaymentRequest

> Özel düğmeler, hızlı ödeme ve kargo geri çağırmaları için alt düzey Apple Pay, Google Pay veya PayPal ödeme ekranı. Cüzdan kutucukları bu akışı `payments.createConfirmationToken` aracılığıyla otomatikleştirir. Kullanılabilirliği denetlemek ve cüzdanı hazırlamak için `canMakePayment()` sonucunu bekleyin, ardından kullanıcı etkileşimi işleyicisinde `show(type)` metodunu senkron olarak çağırın. Çözümlenen `ctok`, `ctok_` önekli bir onay token'ıdır. Onu, element tarafından oluşturulan bir token gibi sunucu tarafında onaylayın. Bir PayPal token'ı en fazla PayPal'ın alıcıya gösterdiği toplam tutarı tahsil eder.

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

Bu [`Payments`](https://docs.whop.com/tr/elements/latest/payments/overview) kaynağını bir element bağlamadan oluşturun: vanilla'da `whop.payments.paymentRequest.create({ … })`, React'te `useWhop().payments.paymentRequest.create({ … })`.

## Seçenekler

Bunları `whop.payments.paymentRequest.create({ … })` metoduna iletin.

**accountId** `string` *required*

İstemci tarafındaki her çağrının kapsamını belirleyen, `biz_` önekli hesap kimliği.

**currency** `string` *required*

Üç harfli ISO 4217 ödeme para birimi kodu.

**amount** `number` *required*

Küçük birimlerle ödeme tutarı. Daha sonra `update()` ile değiştirin.

**setupFutureUsage** `"off_session" | "on_session"`

Yalnızca kaydetme onayını gösterdikten sonra ayarlayın. Token'ı `off_session` veya `on_session` kullanımı için işaretler.

**paymentMethodConfiguration** `PaymentMethodConfigurationShape`

API'nin `enabled`, `disabled` ve `include_platform_defaults` biçimindeki ödeme yöntemi filtreleri. `canMakePayment()` metodunun bildirdiği cüzdanları daraltırlar: `disabled` türleri kaldırır, `enabled` sunulan türleri geri getirir ve `include_platform_defaults: false` yalnızca etkin türleri bırakır. Hesabın sunmadığı bir yöntemi asla eklemezler. PayPal, `paypal` türünü izler. `v1.9.0` sürümünden beri.

**özellikler**

**enabled** `string[]`

**disabled** `string[]`

**include\_platform\_defaults** `boolean`

**requestPayerEmail** `boolean`

Ödeme ekranından ödeyenin e-postasını isteyin; onay token'ı bunu gerektirir. Varsayılan değer `true`.

**requestPayerPhone** `boolean`

Ödeme ekranından ödeyenin telefon numarasını isteyin; sonuçta `payer.phone` olarak teslim edilir: onu sağlayan kişinin ülkesine göre ayrıştırılabildiğinde E.164 biçiminde, aksi hâlde cüzdanın verdiği şekliyle; `payer.country` fatura ülkesidir. Google Pay bunu ödeme ekranının zaten istediği fatura adresi üzerinden toplar. PayPal bunu iletişim bölümü üzerinden toplar ve telefonu olmayan bir hesabı reddeder. Varsayılan değer `false`.

**requestShipping** `boolean`

Ödeme ekranından bir teslimat adresi isteyin (ve verildiğinde `shippingOptions` sunun). PayPal her zaman bir adres ister, çünkü vergi bu adrese göre hesaplanır; ve adresi yalnızca bu ayarlandığında `shipping` olarak döndürür. Varsayılan değer `false`.

**requestPromoCode** `boolean`

Ödeme ekranının kendi promosyon kodu alanını sunun ve `onPromoCodeChange` olayını yanıtlayın. Apple Pay bu alanı Apple Pay sürüm 12'yi destekleyen cihazlarda (iOS 15 ve macOS 12) gösterir; Google Pay ise hesabın Google Pay kurulumunun tekliflere izin verdiği yerlerde gösterir. Diğer cihazlar ödeme ekranını bu alan olmadan açar. Varsayılan değer `false`. `v1.5.0` sürümünden beri.

**appliedPromoCode** `string`

Ücrete zaten uygulanmış bir promosyon kodu; alıcının görebilmesi, değiştirebilmesi veya kaldırabilmesi için ödeme ekranına önceden doldurulur. `v1.5.0` sürümünden beri.

**appliedPromoDescription** `string`

`appliedPromoCode` kodunun ne işe yaradığı; Google Pay'de kodun yanında gösterilir. Apple Pay'in kupon alanında açıklama yoktur. `v1.5.0` sürümünden beri.

**countryCode** `string`

Apple Pay ödeme ekranı için hesabın ISO 3166-1 alpha-2 ülke kodu. Hesabın yayımlanmış kayıt ülkesini kullanmak için bunu atlayın. Hiçbiri mevcut olmadığında ödeme ekranı varsayılan olarak `US` kullanır.

**lineItems** `PaymentRequestLineItem[]`

Ödeme ekranının toplamın altında listelediği satır kalemleri. Daha sonra `update()` ile değiştirin.

**özellikler**

**label** `string` *required*

**amount** `number` *required*

`amount` ile aynı şekilde küçük birimler.

**shippingOptions** `PaymentRequestShippingOption[]`

`requestShipping` ayarlandığında ödeme ekranının sunduğu kargo seçenekleri. Yalnızca görüntüleme amaçlıdır; `amount` değerini değişiklik işleyicinizden güncelleyin. Ödeme ekranı ilk seçenek seçili olarak açılır ve bunun için `onShippingOptionChange` tetiklemez, bu nedenle `amount` onun fiyatını zaten içermelidir. Daha sonra `update()` ile değiştirin.

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

## Metotlar

Bunları kaynak üzerinde çağırın.

> [!WARNING]
>
> `show` metodunu kullanıcı etkinleştirmesi sırasında senkron olarak çağırın. Ön koşulları önceden bekleyin (await).

### `canMakePayment`

Hesap sunduğunda, cihaz desteklediğinde ve bu sayfanın kaynağı (origin) hesap için onaylandığında her cüzdan için kullanılabilirliği döndürür (birinci taraf whop.com sayfaları önceden onaylıdır; bir satıcı sayfası, [Domains API](https://docs.whop.com/tr/api-reference/beta/domains/domain) aracılığıyla kendi alan adında Apple Pay'in hazır olmasını gerektirir ve orada Google Pay sunmak [Google Pay API Hizmet Koşulları](https://payments.developers.google.com/terms/sellertos)'na tabidir). Kendisi bir iframe içinde olan bir sayfada, tarayıcı bunu açığa çıkardığında Apple Pay bunun yerine üst düzey sayfanın alan adını denetler. WebKit dışı tarayıcılarda Apple Pay, masaüstünden iPhone'a devretme akışıdır, bu nedenle oradaki mobil cihazlar onu kullanılamaz olarak bildirir; iOS tarayıcılarındaki yerel Apple Pay bundan etkilenmez. `order`, cüzdanları hangi ödeme ekranının tarayıcıya yerel olduğuna göre sıralar (Safari'de önce Apple Pay, başka yerlerde önce Google Pay, en son PayPal), böylece hızlı ödeme düğmeleri en iyisinden başlayarak dizilebilir. `payPal`, hesap PayPal'ı bu para biriminde sunduğunda, tutar PayPal'ın sınırları içinde olduğunda, istek ödeyenin telefonunu istemediğinde (bir `off_session` isteği \$0 olabilir; bu, PayPal'ı ücret almadan kaydeder), PayPal'ın betikleri bu sayfada yüklendiğinde ve bu sayfanın kaynağı diğer cüzdanlarda olduğu gibi hesap için onaylandığında PayPal'ı bildirir. İçerik Güvenliği Politikası olan bir sayfa, `contentSecurityPolicy()` tarafından dahil edilen PayPal ana makinelerine izin vermelidir. PayPal'ın kendi v5 JavaScript SDK'sını zaten yükleyen bir sayfa `payPal: false` bildirir. Yalnızca listelediğiniz cüzdanları denetlemek için `types` iletin; `show(type)` o cüzdanın denetlenmiş olmasını gerektirir. `wallets`, kullanılabilir her cüzdanın resmî düğme görselini (`light` ve `dark` renk ve görsel) taşır. Bu, `show()` metodunu hazırlar. Her zaman önce bunun sonucunu bekleyin.

**Parametreler**

**filter** `object`

**özellikler**

**types** `("apple_pay" | "google_pay" | "paypal_express")[]`

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

**applePay** `boolean` *required*

**googlePay** `boolean` *required*

**payPal** `boolean`

**order** `("apple_pay" | "google_pay" | "paypal_express")[]`

Cüzdanlar, hangi ödeme ekranının bu tarayıcıya yerel olduğuna göre sıralanır (WebKit'te önce Apple Pay, diğer her yerde önce Google Pay, en son PayPal), böylece hızlı ödeme düğmeleri en iyisinden başlayarak dizilebilir. Tüketici tarafından belirtilen kullanılabilirlikte (önizlemeler) ve bundan önceki bağlantılarda bulunmaz. Payment-request'in WalletSheetType türü değil, satır içi bir birleşimdir: o modül zaten bunu içe aktarır.

**wallets** `object`

Kullanılabilir her cüzdanın cüzdan türüne göre anahtarlanmış ayrıntıları. Tüketici tarafından belirtilen kullanılabilirlikte (önizlemeler) bulunmaz.

**özellikler**

**apple\_pay** `WalletDetails`

**özellikler**

**button** `WalletButtonArt`

Cüzdanın resmî düğme görseli. Hiçbiri yayımlanmadığında bulunmaz.

**özellikler**

**light** `object` *required*

Açık renkli sayfalar için.

**özellikler**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Koyu renkli sayfalar için.

**özellikler**

**color** `string` *required*

**image** `string` *required*

**google\_pay** `WalletDetails`

**özellikler**

**button** `WalletButtonArt`

Cüzdanın resmî düğme görseli. Hiçbiri yayımlanmadığında bulunmaz.

**özellikler**

**light** `object` *required*

Açık renkli sayfalar için.

**özellikler**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Koyu renkli sayfalar için.

**özellikler**

**color** `string` *required*

**image** `string` *required*

**paypal\_express** `WalletDetails`

**özellikler**

**button** `WalletButtonArt`

Cüzdanın resmî düğme görseli. Hiçbiri yayımlanmadığında bulunmaz.

**özellikler**

**light** `object` *required*

Açık renkli sayfalar için.

**özellikler**

**color** `string` *required*

**image** `string` *required*

**dark** `object` *required*

Koyu renkli sayfalar için.

**özellikler**

**color** `string` *required*

**image** `string` *required*

### `show`

`canMakePayment()` sonucunu bekledikten sonra, seçilen cüzdanı basma anında senkron olarak açın: Apple, oturumun hareket yığını içinde oluşturulmasını gerektirir ve PayPal penceresini orada açar (masaüstünde bir açılır pencere; açılır pencere engellendiğinde ve mobilde PayPal'ın sayfa içi penceresi). Sayfanız zaten bir e-posta topladıysa `email` iletin; cüzdan onu alır ve ikinci kez sormaz. `requestPayerEmail: false` ile bir e-posta iletmek zorunludur ve onay token'ları e-posta gerektirdiğinden cüzdan o olmadan açılmayı reddeder. Ödeme ekranı açıkken `update()` hata fırlatır: değiştirmek için değişiklik olaylarını yanıtlayın. Kullanıcı etkinleştirmesi sırasında senkron olarak çağırın. Tarayıcılar etkinleştirmeyi asenkron adımlar boyunca iptal ettiğinden ön koşulları önceden bekleyin.

**Parametreler**

**type** `"apple_pay" | "google_pay" | "paypal_express"` *required*

**provided** `object`

**özellikler**

**email** `string`

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

**ctok** `string` *required*

`ctok_` önekli onay token'ı kimliği. Onu gizli anahtarınızla sunucu tarafında onaylayın.

**type** `"apple_pay" | "google_pay" | "paypal_express"` *required*

**payer** `object` *required*

`phone`, kişinin ülkesine göre ayrıştırılabildiğinde E.164 biçimindedir, aksi hâlde verildiği şekliyledir; PayPal bunu yalnızca `requestPayerPhone` için verir ve telefonu olmayan bir hesabı reddeder. `country`, her ödeme ekranının topladığı fatura ülkesidir.

**özellikler**

**email** `string`

**name** `string`

**phone** `string`

**country** `string`

**billing** `object | null` *required*

Değişiklik olaylarının taşıdığı kısaltılmış adresin aksine, onay token'ının taşıdığı eksiksiz fatura adresi; cüzdan adres vermediğinde `null`. Apple Pay ve Google Pay kartın fatura adresini verir. PayPal'da bu, alıcının PayPal'da seçtiği ve toplamın üzerinden vergilendirildiği adrestir.

**özellikler**

**address** `PaymentRequestAddress` *required*

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**shipping** `object | null` *required*

`requestShipping` ayarlanmadıkça `null`. `option` seçili kargo seçeneğidir: alıcı başka birini seçene kadar sunulan ilk seçenek; bir yanıt seçenekleri seçilen `id` olmadan değiştirdiğinde yine ilk seçenek. Apple Pay ve Google Pay, seçenekler sunulduğunda bunu her zaman ayarlar, PayPal ise asla ayarlamaz.

**özellikler**

**address** `PaymentRequestAddress`

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**option** `PaymentRequestShippingOption`

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

### `update`

Bu örnekteki `amount`, `lineItems` ve `shippingOptions` değerlerini değiştirin. Diğer tüm seçenekler `create()` sırasında sabitlenir: değiştirmek için yeni bir örnek oluşturun.

**Parametreler**

**patch** `object` *required*

**özellikler**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**özellikler**

**label** `string` *required*

**amount** `number` *required*

`amount` ile aynı şekilde küçük birimler.

**shippingOptions** `PaymentRequestShippingOption[]`

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

## Olaylar

Aşağıdaki olaylara abone olun. Her metot bir abonelikten çıkma fonksiyonu döndürür.

> [!WARNING]
>
> Her olay işleyicisi, belgelenmiş yanıt metodunu tam olarak bir kez çağırmalıdır. Yanıt vermeden önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar.

### `onShippingAddressChange`

Alıcı bir teslimat adresi seçti (yetkilendirme öncesi kısaltılmış: yalnızca şehir, eyalet, posta kodu ve ülke; Apple Pay bir ABD ZIP kodunu beş haneye indirir ve bir Kanada veya Birleşik Krallık posta kodunun son üç karakterini atar). Adres ve seçili kargo seçeneği için toplamlarla yanıt verin: alıcı başka birini seçene kadar ilk seçenek. `shippingOptions` seçenekleri değiştirir (boş bir liste hiçbir şeyi değiştirmez). Seçilen bir seçenek, yanıt onun `id` değerini koruduğu sürece seçili kalır; yanıt onu çıkardığında, ilk seçenek bir `onShippingOptionChange` olmadan seçim hâline gelir, bu nedenle onu fiyatlandırın. Yanıttaki her hata, sonraki bir adres yanıtı onu temizleyene kadar adreste kalır: bir `field` (`city`, `state`, `postal_code`, `country`) adlandıran hata Apple Pay'de o alanı işaretler, Google Pay ise yalnızca mesajı gösterir. Adreste bir hata durduğu sürece ödeme reddedilir. Kargo gönderemeyeceğiniz bir adresi, `field` olmadan bir `shipping_address_unserviceable` hatasıyla reddedin. Apple Pay, Google Pay ve PayPal'da 25 saniye içinde yanıt vermeyen bir işleyici, hata fırlatan bir işleyici gibi adresi başarısız kılar ve sonraki yanıtı yok sayılır. PayPal bunu alıcının seçtiği adresle tetikler ve bir `field` adlandıran hata, adresin o kısmını PayPal içinde reddeder. Her olay için `updateWith(…)` metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.

**ev** `ShippingAddressChangeEvent`

**özellikler**

**address** `PaymentRequestAddress` *required*

Sağlayıcıya göre normalleştirilmiş, yetkilendirme öncesi adres. Yalnızca şehir, eyalet, posta kodu ve ülkeyi içerir. Apple Pay posta kodunu kısaltır: bir ABD ZIP kodunu ilk beş hanesine, bir Kanada veya Birleşik Krallık posta kodunu ise son üç karakteri olmadan.

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**updateWith** `(update: PaymentRequestUpdate) =\> void` *required*

Bunu 25 saniye içinde tam olarak bir kez çağırın. Apple Pay, Google Pay ve PayPal'da o zamana kadar yanıt vermeyen bir işleyici, hata fırlatan bir işleyici gibi adresi başarısız kılar ve sonraki yanıtı yok sayılır.

**parametreler**

**update** `PaymentRequestUpdate` *required*

**özellikler**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**özellikler**

**label** `string` *required*

**amount** `number` *required*

`amount` ile aynı şekilde küçük birimler.

**shippingOptions** `PaymentRequestShippingOption[]`

Ödeme ekranının kargo seçeneklerini değiştirir. Seçili seçenek, `id` değeri listede olduğu sürece seçili kalır; aksi takdirde ilk seçenek `shippingOptionChange` olmadan seçim hâline gelir, bu nedenle onu aynı yanıtta fiyatlandırın. Boş bir liste hiçbir şeyi değiştirmez: kargo gönderemeyeceğiniz bir adresi bunun yerine bir `shipping_address_unserviceable` hatasıyla reddedin.

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

**errors** `PaymentRequestError[]`

**özellikler**

**code** `string`

Bir kargo yanıtının neyi reddettiği. Bir `billingAddressChange` veya `paymentMethodChange` yanıtındaki hata, kodu ne olursa olsun o olayın sorduğu kartı veya yöntemi reddeder.

Şunlardan biri: `"other"`, `"shipping_address_invalid"`, `"shipping_address_unserviceable"` veya `"shipping_option_invalid"`.

**message** `string` *required*

**field** `"state" | "country" | "city" | "postal_code"`

Hatanın ilgili olduğu adres alanı: kısaltılmış adresin taşıdığı alanlardan biri. Apple Pay, `code` ne olursa olsun o alanı mesajla işaretler; Google Pay yalnızca mesajı gösterir. Adresin tamamıyla ilgili bir hata için bunu atlayın.

### `onShippingOptionChange`

Alıcı bir kargo seçeneği seçti ya da Apple Pay seçili olanı yeniden duyurdu: adres değişikliklerinin tümü yanıtlandığında ve bekleyen yoksa Apple Pay bunu hâlâ seçili olan seçenek için tetikler. Seçili seçeneği çıkaran bir yanıttan sonra asla tetiklenmez; bu durumda ilk seçenek bir olay olmadan seçim hâline gelir, bu nedenle yanıtladığınız her toplam seçili seçeneği fiyatlandırır: alıcı başka birini seçene kadar ilk seçenek, yanıtlarınız `id` değerini koruduğu sürece seçilen seçenek ve bir yanıt onu çıkardığında yine ilk seçenek. Yalnızca tutar sözleşmesi: `updateWith` amount/lineItems/shippingOptions/errors taşır. `errors` içeren bir yanıt, alıcı işleyicinizin kabul ettiği bir seçeneği seçene kadar seçeneği reddeder. Apple Pay'de kargo seçeneği için bir hata yuvası yoktur, bu nedenle yanıt başka ne taşırsa taşısın son kabul edilen toplamı korur ve alıcı Öde'ye dokunduğunda ilk hatanın mesajı gösterilir. Google Pay mesajı seçenek seçildiğinde gösterir. Apple Pay, Google Pay ve PayPal'da 25 saniye içinde yanıt vermeyen bir işleyici, hata fırlatan bir işleyici gibi seçeneği reddeder ve sonraki yanıtı yok sayılır. Her olay için `updateWith(…)` metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.

**ev** `ShippingOptionChangeEvent`

**özellikler**

**option** `object & Partial\<PaymentRequestShippingOption\>` *required*

Her zaman seçili `id` değerini içerir. Sizin seçeneklerinizden biriyle eşleştiğinde seçeneğin tamamını içerir.

**özellikler**

**id** `string` *required*

**label** `string`

**detail** `string`

**amount** `number`

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

**updateWith** `(update: PaymentRequestUpdate) =\> void` *required*

Bunu 25 saniye içinde tam olarak bir kez çağırın. Apple Pay, Google Pay ve PayPal'da o zamana kadar yanıt vermeyen bir işleyici, satıcının reddi gibi seçeneği reddeder ve sonraki yanıtı yok sayılır.

**parametreler**

**update** `PaymentRequestUpdate` *required*

**özellikler**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**özellikler**

**label** `string` *required*

**amount** `number` *required*

`amount` ile aynı şekilde küçük birimler.

**shippingOptions** `PaymentRequestShippingOption[]`

Ödeme ekranının kargo seçeneklerini değiştirir. Seçili seçenek, `id` değeri listede olduğu sürece seçili kalır; aksi takdirde ilk seçenek `shippingOptionChange` olmadan seçim hâline gelir, bu nedenle onu aynı yanıtta fiyatlandırın. Boş bir liste hiçbir şeyi değiştirmez: kargo gönderemeyeceğiniz bir adresi bunun yerine bir `shipping_address_unserviceable` hatasıyla reddedin.

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

**errors** `PaymentRequestError[]`

**özellikler**

**code** `string`

Bir kargo yanıtının neyi reddettiği. Bir `billingAddressChange` veya `paymentMethodChange` yanıtındaki hata, kodu ne olursa olsun o olayın sorduğu kartı veya yöntemi reddeder.

Şunlardan biri: `"other"`, `"shipping_address_invalid"`, `"shipping_address_unserviceable"` veya `"shipping_option_invalid"`.

**message** `string` *required*

**field** `"state" | "country" | "city" | "postal_code"`

Hatanın ilgili olduğu adres alanı: kısaltılmış adresin taşıdığı alanlardan biri. Apple Pay, `code` ne olursa olsun o alanı mesajla işaretler; Google Pay yalnızca mesajı gösterir. Adresin tamamıyla ilgili bir hata için bunu atlayın.

### `onBillingAddressChange`

Alıcı, kısaltılmış fatura adresiyle (yalnızca şehir, eyalet, posta kodu ve ülke) birlikte bir kart seçti: toplamı, ücretin vergilendirildiği adrese göre yeniden fiyatlandırın. Apple Pay bunu alıcı bir kart seçtiğinde, Google Pay ise ödeme ekranı açıldığında ve alıcı her kart değiştirdiğinde tetikler. Küçük birimlerle `updateWith({ amount })`, geçerli toplamı korumak için `updateWith({})` veya kartı reddetmek için `updateWith({ errors })` ile yanıt verin. Her olay tam olarak bir kez yanıtlanır: hata fırlatan, reddedilen veya 10 saniye içinde yanıt vermeyen bir işleyici kartı reddeder, böylece alıcı başka bir kart seçer. Apple Pay ve Google Pay'de aynı seçim ardından `paymentMethodChange` tetikler ve ödeme ekranı her ikisi de yanıtlandığında güncellenir. PayPal bunu, alıcının PayPal'da seçtiği her teslimat adresiyle tetikler; bu, token'ının faturalandırdığı ve vergilendirdiği adrestir ve oradaki bir ret, o adresi PayPal içinde reddeder. Her olay için `updateWith(…)` metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.

**ev** `BillingAddressChangeEvent`

**özellikler**

**address** `PaymentRequestAddress` *required*

Sağlayıcıya göre normalleştirilmiş, yetkilendirme öncesi fatura adresi. Yalnızca şehir, eyalet, posta kodu ve ülkeyi içerir.

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**updateWith** `(update: PaymentRequestUpdate) =\> void` *required*

Bunu tam olarak bir kez çağırın. 10 saniye boyunca yanıtsız bırakılan bir olay kartı reddeder ve alıcı başka bir kart seçer.

**parametreler**

**update** `PaymentRequestUpdate` *required*

**özellikler**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**özellikler**

**label** `string` *required*

**amount** `number` *required*

`amount` ile aynı şekilde küçük birimler.

**shippingOptions** `PaymentRequestShippingOption[]`

Ödeme ekranının kargo seçeneklerini değiştirir. Seçili seçenek, `id` değeri listede olduğu sürece seçili kalır; aksi takdirde ilk seçenek `shippingOptionChange` olmadan seçim hâline gelir, bu nedenle onu aynı yanıtta fiyatlandırın. Boş bir liste hiçbir şeyi değiştirmez: kargo gönderemeyeceğiniz bir adresi bunun yerine bir `shipping_address_unserviceable` hatasıyla reddedin.

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

**errors** `PaymentRequestError[]`

**özellikler**

**code** `string`

Bir kargo yanıtının neyi reddettiği. Bir `billingAddressChange` veya `paymentMethodChange` yanıtındaki hata, kodu ne olursa olsun o olayın sorduğu kartı veya yöntemi reddeder.

Şunlardan biri: `"other"`, `"shipping_address_invalid"`, `"shipping_address_unserviceable"` veya `"shipping_option_invalid"`.

**message** `string` *required*

**field** `"state" | "country" | "city" | "postal_code"`

Hatanın ilgili olduğu adres alanı: kısaltılmış adresin taşıdığı alanlardan biri. Apple Pay, `code` ne olursa olsun o alanı mesajla işaretler; Google Pay yalnızca mesajı gösterir. Adresin tamamıyla ilgili bir hata için bunu atlayın.

### `onPaymentMethodChange`

Alıcı bir ödeme yöntemi seçti: toplamı onun için yeniden fiyatlandırın; örneğin kredi kartlarına ek ücret. Apple Pay bunu alıcı bir kart seçtiğinde, Google Pay ise ödeme ekranı açıldığında ve alıcı her kart değiştirdiğinde tetikler; her biri o kartın `billingAddressChange` olayından hemen sonra gelir. `paymentMethod.type` değeri `card` olur. `paymentMethod.card`, alıcı yetkilendirmeden önce cüzdanın kart hakkında söylediklerini taşır: Apple Pay `funding` bilgisini bildirir (Apple genellikle ağı o zamana kadar saklar), Google Pay ise `network` bilgisini. `paymentMethod.billingAddress`, kartın kısaltılmış fatura adresidir. Yeniden fiyatlandırmak için `updateWith({ amount, lineItems })`, geçerli toplamı korumak için `updateWith({})` veya yöntemi reddetmek için `updateWith({ errors })` ile yanıt verin; `shippingOptions` yok sayılır. Apple Pay bir reddi kartın fatura iletişim bilgisinde (verildiğinde adlandırılan `field` üzerinde) işaretler ve alıcı başka bir yöntem seçene kadar Öde düğmesini tutar. Google Pay mesajı kartta gösterir ve alıcı kabul ettiğiniz bir kartı seçene kadar o karttaki Öde dokunuşunu reddeder. Reddedilen bir kart, bu yanıtın veya `billingAddressChange` yanıtının fiyatlandırmasından bağımsız olarak toplamları olduğu gibi bırakır. Her olay tam olarak bir kez yanıtlanır: hata fırlatan, reddedilen veya 10 saniye içinde yanıt vermeyen bir işleyici yöntemi reddeder. Her ödeme ekranı, alıcı ödeme yapmadan önce yanıtınızı bekler. PayPal bunu asla tetiklemez. Her olay için `updateWith(…)` metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.

**ev** `PaymentMethodChangeEvent`

**özellikler**

**paymentMethod** `PaymentRequestPaymentMethod` *required*

Alıcının seçtiği yöntem; cüzdanın yetkilendirmeden önce tanımladığı şekliyle.

**özellikler**

**type** `string` *required*

Yalnızca kartları bildiren Apple Pay ve Google Pay'de `card`; PayPal'da `paypal`.

**card** `object`

Cüzdanın kart hakkında söyledikleri. Alıcı yetkilendirmeden önce, `paymentMethodChange` sırasında Apple Pay genellikle ağ olmadan fon türünü, Google Pay ise ağını bildirir. Yetkilendirme anında Apple Pay ve Google Pay her ikisini de bildirir.

**özellikler**

**network** `string`

**funding** `"credit" | "debit" | "prepaid" | "store"`

**billingAddress** `PaymentRequestAddress`

Apple Pay ve Google Pay'in kartla birlikte teslim ettiği, kartın kısaltılmış fatura adresi (yalnızca şehir, eyalet, posta kodu ve ülke).

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**displayName** `string`

Cüzdanın yöntem için kendi etiketi; örneğin `Visa 1234`. Apple Pay ve Google Pay bunu yalnızca alıcı yetkilendirdiğinde ayarlar, bu nedenle onu yalnızca `paymentAuthorization` taşır. Gösterin, ancak ayrıştırmayın: cüzdanlar herhangi bir biçim garanti etmez.

**updateWith** `(update: PaymentRequestUpdate) =\> void` *required*

Bunu tam olarak bir kez çağırın: `amount` ve `lineItems` ödeme ekranını yöntem için yeniden fiyatlandırır, `updateWith({})` toplamı korur ve `errors` yöntemi reddeder. 10 saniye boyunca yanıtsız bırakılan bir olay yöntemi reddeder.

**parametreler**

**update** `PaymentRequestUpdate` *required*

**özellikler**

**amount** `number`

**lineItems** `PaymentRequestLineItem[]`

**özellikler**

**label** `string` *required*

**amount** `number` *required*

`amount` ile aynı şekilde küçük birimler.

**shippingOptions** `PaymentRequestShippingOption[]`

Ödeme ekranının kargo seçeneklerini değiştirir. Seçili seçenek, `id` değeri listede olduğu sürece seçili kalır; aksi takdirde ilk seçenek `shippingOptionChange` olmadan seçim hâline gelir, bu nedenle onu aynı yanıtta fiyatlandırın. Boş bir liste hiçbir şeyi değiştirmez: kargo gönderemeyeceğiniz bir adresi bunun yerine bir `shipping_address_unserviceable` hatasıyla reddedin.

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

**errors** `PaymentRequestError[]`

**özellikler**

**code** `string`

Bir kargo yanıtının neyi reddettiği. Bir `billingAddressChange` veya `paymentMethodChange` yanıtındaki hata, kodu ne olursa olsun o olayın sorduğu kartı veya yöntemi reddeder.

Şunlardan biri: `"other"`, `"shipping_address_invalid"`, `"shipping_address_unserviceable"` veya `"shipping_option_invalid"`.

**message** `string` *required*

**field** `"state" | "country" | "city" | "postal_code"`

Hatanın ilgili olduğu adres alanı: kısaltılmış adresin taşıdığı alanlardan biri. Apple Pay, `code` ne olursa olsun o alanı mesajla işaretler; Google Pay yalnızca mesajı gösterir. Adresin tamamıyla ilgili bir hata için bunu atlayın.

### `onPromoCodeChange`

Alıcı, ödeme ekranının promosyon alanına (`requestPromoCode`) bir kod yazdı, kodu değiştirdi veya kaldırdı. Kodu yeni bir toplamla uygulamak için `updateWith({ amount })`, geçerli toplamla uygulamak için `updateWith({})` veya yerinde reddetmek için `updateWith({ error })` ile yanıt verin. Bir kaldırma `code` null olarak gelir ve aynı şekilde yanıtlanır. Uygulanmış bir kodu değiştirmek, asla önce bir kaldırma olarak değil, yeni kodla tek bir olay olarak gelir ve reddedilen yeni bir kod uygulanmış olanı yerinde bırakır. `shippingOptions` seçili seçeneği çıkardığında, ilk seçenek bir `onShippingOptionChange` olmadan seçim hâline gelir, bu nedenle onu fiyatlandırın. `appliedDescription`, Google Pay'de koda açıklama ekler; Apple Pay'in kupon alanında açıklama yoktur, bu nedenle alıcının görmesi gereken her şeyi bir satır kalemi etiketine koyun. Hata fırlatan, reddedilen veya 10 saniye içinde yanıt vermeyen bir işleyici kodu reddeder. Her olay için `updateWith(…)` metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.

**ev** `PromoCodeChangeEvent`

**özellikler**

**code** `string | null` *required*

Şu anda ödeme ekranının promosyon alanındaki kod veya alıcı onu kaldırdığında null. Uygulanmış bir kodu değiştirmek, asla önce bir kaldırma olarak değil, yeni kodla tek bir olaydır.

**updateWith** `(update: PromoCodeUpdate) =\> void` *required*

Tam olarak bir kez yanıt verin: `error` kodu reddeder ve toplamları korur; diğer her yanıt kodu uygular. `amount` ve `lineItems` ödeme ekranını kod altında yeniden fiyatlandırır, `shippingOptions` kargo seçeneklerini değiştirir (ücretsiz kargo kodu) ve `appliedDescription`, ödeme ekranının bir açıklama gösterdiği yerde (Google Pay) uygulanan koda açıklama ekler. `updateWith({})` kodu geçerli toplamla uygular.

**parametreler**

**update** `PromoCodeUpdate` *required*

**özellikler**

**amount** `number`

Kod altındaki toplam, küçük birimlerle.

**lineItems** `PaymentRequestLineItem[]`

Ödeme ekranının kod altındaki satır kalemleri; örneğin indirim ve değiştirdiği vergi.

**özellikler**

**label** `string` *required*

**amount** `number` *required*

`amount` ile aynı şekilde küçük birimler.

**shippingOptions** `PaymentRequestShippingOption[]`

Ödeme ekranının kargo seçeneklerini kod altında değiştirir; örneğin bir ücreti sıfıra indiren ücretsiz kargo kodu. Bir seçenek, `id` değeri listede olduğu sürece seçili kalır; aksi takdirde ilk seçenek `shippingOptionChange` olmadan seçim hâline gelir. Seçili seçeneğin fiyatı değiştiğinde `amount` değerini de gönderin, çünkü toplam kendiliğinden güncellenmez. Boş bir liste hiçbir şeyi değiştirmez.

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

**appliedDescription** `string`

Google Pay'de uygulanan kodun yanında gösterilen bir açıklama. Apple Pay'in kupon alanında açıklama yoktur, bu nedenle alıcının görmesi gereken her şeyi bir satır kalemi etiketine koyun.

**error** `object`

Kodu reddeder. Ödeme ekranı `message` değerini promosyon alanının yanında gösterir.

**özellikler**

**message** `string` *required*

### `onPaymentAuthorization`

Alıcı ödemeyi yetkilendirdi ve henüz bir onay token'ı yok. Önce onaylamak veya reddetmek için abone olun: ödeme ekranı yanıtınızı bekler ve bir işleyici olmadan token hemen oluşturulur. Olay; ödeyeni, ödeme yöntemini (kısaltılmış fatura adresiyle ve `displayName` içinde cüzdanın onun için kendi etiketiyle, örneğin `Visa 1234`), teslimat adresini ve seçeneğini, alıcının yetkilendirdiği toplamı ve satır kalemlerini taşır. Token'ı oluşturmak için `respondWith({ approved: true })` ile yanıt verin; ardından `show()` ve `onConfirmationToken` onu her zamanki gibi teslim eder. Reddetmek için `respondWith({ approved: false, message })` ile yanıt verin: token oluşturulmaz, Apple Pay ve Google Pay `message` değerini ödeme ekranında gösterir ve alıcı bir şeyi değiştirip yeniden ödeme yapabilir veya ödeme ekranını kapatabilir. PayPal mesajınızı gösteremez, bu nedenle oradaki bir ret denemeyi sonlandırır: `show()`, `payment_request_refused` ile reddedilir ve alıcı PayPal'a yeniden basabilir. Her olay tam olarak bir kez yanıtlanır ve yalnızca `approved: true` bir token oluşturur: hata fırlatan, reddedilen veya 25 saniye içinde yanıt vermeyen bir işleyici ödemeyi reddeder; bu, Apple Pay ve Google Pay'in kendi 30 saniyelik sınırlarından önce reddi gösterebilmesi için yeterince erkendir. Her olay için `respondWith(…)` metodunu tam olarak bir kez çağırın. Onu çağırmadan önce hata fırlatan veya reddedilen bir işleyici, o güncellemeyi hemen başarısız kılar. Abonelikten çıkma fonksiyonunu döndürür.

**ev** `PaymentAuthorizationEvent`

**özellikler**

**type** `"apple_pay" | "google_pay" | "paypal_express"` *required*

Alıcının yetkilendirme yaptığı cüzdan.

**payer** `object` *required*

Sonucun taşıyacağı şekliyle ödeyen.

**özellikler**

**email** `string`

**name** `string`

**phone** `string`

**country** `string`

**paymentMethod** `PaymentRequestPaymentMethod` *required*

Alıcının yetkilendirdiği yöntem. Fatura adresi, `paymentMethodChange` olayının taşıdığı şekilde şehir, eyalet, posta kodu ve ülkeye kısaltılır.

**özellikler**

**type** `string` *required*

Yalnızca kartları bildiren Apple Pay ve Google Pay'de `card`; PayPal'da `paypal`.

**card** `object`

Cüzdanın kart hakkında söyledikleri. Alıcı yetkilendirmeden önce, `paymentMethodChange` sırasında Apple Pay genellikle ağ olmadan fon türünü, Google Pay ise ağını bildirir. Yetkilendirme anında Apple Pay ve Google Pay her ikisini de bildirir.

**özellikler**

**network** `string`

**funding** `"credit" | "debit" | "prepaid" | "store"`

**billingAddress** `PaymentRequestAddress`

Apple Pay ve Google Pay'in kartla birlikte teslim ettiği, kartın kısaltılmış fatura adresi (yalnızca şehir, eyalet, posta kodu ve ülke).

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**displayName** `string`

Cüzdanın yöntem için kendi etiketi; örneğin `Visa 1234`. Apple Pay ve Google Pay bunu yalnızca alıcı yetkilendirdiğinde ayarlar, bu nedenle onu yalnızca `paymentAuthorization` taşır. Gösterin, ancak ayrıştırmayın: cüzdanlar herhangi bir biçim garanti etmez.

**shipping** `object | null` *required*

`requestShipping` ayarlanmadıkça `null`. Aksi takdirde sonucun taşıyacağı adres ve seçenek.

**özellikler**

**address** `PaymentRequestAddress`

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**option** `PaymentRequestShippingOption`

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

**amount** `number` *required*

Alıcının yetkilendirdiği toplam, küçük birimlerle.

**lineItems** `PaymentRequestLineItem[]` *required*

Ödeme ekranının o toplamın altında gösterdiği satır kalemleri.

**özellikler**

**label** `string` *required*

**amount** `number` *required*

`amount` ile aynı şekilde küçük birimler.

**respondWith** `(response: PaymentAuthorizationResponse) =\> void` *required*

Bunu tam olarak bir kez çağırın. `{ approved: true }` onay token'ını oluşturur. Diğer her şey ödemeyi reddeder ve token oluşturulmaz.

**parametreler**

**response** `PaymentAuthorizationResponse` *required*

**özellikler**

**approved** `boolean` *required*

`true` onay token'ını oluşturur. `false` ödemeyi reddeder.

**message** `string`

Reddettiğinizde, yetkilendirmeyi alan ödeme ekranında alıcıya gösterilir.

### `onConfirmationToken`

Ödeme ekranı bir onay token'ı oluşturdu; ödeme ekranı kapandıktan sonra bildirilir. Bu, `show()` metodunun döndürdüğü sonuçla aynıdır. Abonelikten çıkma fonksiyonunu döndürür.

**ev** `PaymentRequestResult`

**özellikler**

**ctok** `string` *required*

`ctok_` önekli onay token'ı kimliği. Onu gizli anahtarınızla sunucu tarafında onaylayın.

**type** `"apple_pay" | "google_pay" | "paypal_express"` *required*

**payer** `object` *required*

`phone`, kişinin ülkesine göre ayrıştırılabildiğinde E.164 biçimindedir, aksi hâlde verildiği şekliyledir; PayPal bunu yalnızca `requestPayerPhone` için verir ve telefonu olmayan bir hesabı reddeder. `country`, her ödeme ekranının topladığı fatura ülkesidir.

**özellikler**

**email** `string`

**name** `string`

**phone** `string`

**country** `string`

**billing** `object | null` *required*

Değişiklik olaylarının taşıdığı kısaltılmış adresin aksine, onay token'ının taşıdığı eksiksiz fatura adresi; cüzdan adres vermediğinde `null`. Apple Pay ve Google Pay kartın fatura adresini verir. PayPal'da bu, alıcının PayPal'da seçtiği ve toplamın üzerinden vergilendirildiği adrestir.

**özellikler**

**address** `PaymentRequestAddress` *required*

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**shipping** `object | null` *required*

`requestShipping` ayarlanmadıkça `null`. `option` seçili kargo seçeneğidir: alıcı başka birini seçene kadar sunulan ilk seçenek; bir yanıt seçenekleri seçilen `id` olmadan değiştirdiğinde yine ilk seçenek. Apple Pay ve Google Pay, seçenekler sunulduğunda bunu her zaman ayarlar, PayPal ise asla ayarlamaz.

**özellikler**

**address** `PaymentRequestAddress`

**özellikler**

**name** `string`

Adresteki ad.

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

**country** `string`

**recipient** `string` *deprecated*

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

`name` ile aynı değer.

**phone** `string`

**option** `PaymentRequestShippingOption`

**özellikler**

**id** `string` *required*

**label** `string` *required*

**detail** `string`

**amount** `number` *required*

Küçük birimli görüntüleme değeri. Kaynak kargo ücretini hesaplamaz. `amount` değerini işleyicinizden güncelleyin.

### `onCancel`

Alıcı ödeme ekranını kapattı veya PayPal'ı kapattı. Abonelikten çıkma fonksiyonunu döndürür.

## İçerik güvenliği politikası

Bu kaynak bir çerçevede değil, sayfanızda çalışır. İçerik Güvenliği Politikası olan bir sayfa bu kaynaklara ihtiyaç duyar. `@whop/elements` içindeki `contentSecurityPolicy()` bu tablodaki her kaynağı döndürür. Sandbox kaynağı `environment: "sandbox"` ile geçerlidir.

| Gereksinim | Yönerge | Üretim kaynağı | Sandbox kaynağı |
| - | - | - | - |
| Google Pay'in betiği | `script-src` | `https://pay.google.com` | Aynı |
| ↳ pay.js'in çağırdığı Google Pay API'si | `connect-src` | `https://pay.google.com` | Aynı |
| ↳ Google'ın pay.js için listelediği bir ana makine | `connect-src` | `https://google.com` | Aynı |
| ↳ Google'ın pay.js için listelediği bir ana makine | `connect-src` | `https://account.google.com` | Aynı |
| ↳ Google'ın pay.js için listelediği bir ana makine | `connect-src` | `https://www.google.com` | Aynı |
| Apple Pay'in betiği | `script-src` | `https://applepay.cdn-apple.com` | Aynı |
| Cüzdanın ödeme verilerini tokenleştiren Basis Theory API'si | `connect-src` | `https://api.basistheory.com` | Aynı |
| Braintree'nin PayPal betiği | `script-src` | `https://js.braintreegateway.com` | Aynı |
| ↳ Braintree betiğinin çağırdığı Braintree GraphQL API'si | `connect-src` | `https://payments.braintree-api.com` | `https://payments.sandbox.braintree-api.com` |
| ↳ Braintree betiğinin çağırdığı Braintree istemci API'si | `connect-src` | `https://api.braintreegateway.com` | `https://api.sandbox.braintreegateway.com` |
| ↳ Braintree betiğinin açtığı PayPal giriş çerçevesi | `frame-src` | `https://checkout.paypal.com` | Aynı |
| ↳ Braintree betiğinin açtığı bir Braintree çerçevesi | `frame-src` | `https://assets.braintreegateway.com` | Aynı |
| Braintree'nin PayPal betiğinin yüklediği Braintree istemci betiği | `script-src` | `https://assets.braintreegateway.com` | Aynı |
| Braintree betiğinin yüklediği PayPal SDK'sı | `script-src` | `https://www.paypal.com` | `https://www.sandbox.paypal.com` |
| ↳ PayPal SDK'sının yüklediği PayPal FraudNet betiği | `script-src` | `https://c.paypal.com` | Aynı |
| ↳ PayPal SDK'sının çağırdığı PayPal API'si | `connect-src` | `https://api-m.paypal.com` | `https://api-m.sandbox.paypal.com` |
| ↳ PayPal SDK'sının çağırdığı PayPal günlükleyicisi | `connect-src` | `https://www.paypal.com` | `https://www.sandbox.paypal.com` |
| ↳ PayPal SDK'sının açtığı PayPal sayfa içi penceresi | `frame-src` | `https://www.paypal.com` | `https://www.sandbox.paypal.com` |
| ↳ PayPal SDK'sının gösterdiği PayPal logoları | `img-src` | `https://www.paypalobjects.com` | Aynı |

iOS'ta bu yalnızca Apple Pay'dir: Google Pay, Swift karşılığı olmayan bir web `show(type)` yoludur. Element yok, denetleyici yok: formun üstündeki bir hızlı ödeme düğmesi için kendiniz yönettiğiniz bir nesne. `canMakePayment()` ödeme ekranını hazırlar ve `show()`, bir elementin oluşturduğu `ctok_` ile aynı değere çözümlenir. Müşteri yetkilendirir yetkilendirmez ödeme ekranı bir başarı onay işaretiyle kapanır; token'ı sunucunuzda onaylayın ve sonucu uygulamanızda gösterin.

## Kullanım

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

struct ExpressCheckout: View {
    @State private var request = WhopPaymentRequest(
        accountID: "biz_xxxx",
        charge: .plan(id: "plan_xxxx")
    )
    @State private var isAvailable = false

    var body: some View {
        VStack {
            if isAvailable {
                WhopApplePayButton {
                    Task { await pay() }
                }
                .frame(height: 48)
            }
        }
        .task { isAvailable = await request.canMakePayment() }
    }

    private func pay() async {
        do {
            let token = try await request.show()
            try await myBackend.confirm(token.id)
        } catch {
            // show the error in your app; the sheet has already closed
        }
    }
}
```

## Parametreler

**accountID** `String` *required*

Ücretin ait olduğu, `biz_` önekli hesap.

**configuration** `WhopElementsConfiguration`

`environment`, `returnURL` ve `locale` diğer her yerde olduğu gibi davranır. Varsayılan değer `WhopElementsConfiguration()`.

**charge** `WhopCharge` *required*

`.plan(id:)` veya `.amount(minorUnits:currency:)`. Daha sonra ayarlanabilir; bir sonraki `canMakePayment()` onu yeniden çözümler.

**setupFutureUsage** `WhopSetupFutureUsage?`

`.offSession` veya `.onSession`. Yalnızca kaydetme onayını gösterdikten sonra ayarlayın.

**options** `WhopPaymentRequest.Options`

`requestPayerEmail` ve `requestBillingAddress`, sağlamadığınız bilgileri ödeme ekranından ister (her ikisinin de varsayılanı `true`) ve `label`, toplamın üstünde gösterilen satır kalemini geçersiz kılar.

## `WhopConfirmationToken`

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

* `id: String`: sunucu tarafında onaylanacak `ctok_`
* `paymentMethodType: WhopPaymentMethodType`: bu yolda `apple_pay`

## Durumlar

`canMakePayment()`, cihaz ödeme yapamadığında, hesapta kayıtlı bir Apple Pay satıcısı olmadığında veya ücret çözümlenemediğinde false döndürür; hangisi olduğunu `lastError` söyler. `isPresenting`, ödeme ekranı kapandıktan sonraki oluşturma dahil, `show()` çağrısından dönene veya hata fırlatana kadar true olur; bir çağrı devam ederken yapılan ikinci bir `show()` çağrısı `confirmationInFlight` fırlatır. `show()` sessizce başarısız olmak yerine `walletUnavailable` fırlatır ve mesajı, ödeme ekranını kapatan bir alıcıyı hiç açılamayan bir ödeme ekranından ayırt eder; API'nin reddettiği bir satıcı doğrulaması, o API hatasını alındığı şekliyle fırlatır.

## Bilmekte fayda var

* `show()` sıradan bir async çağrıdır, bu nedenle ödeme ekranını sunmadan önce ücretin ihtiyaç duyduğu her şeyi bekleyebilirsiniz.
* Bunu, Apple'ın kendi `PKPaymentButton` bileşeni olan `WhopApplePayButton` ile eşleştirin. Apple'ın yönergeleri, çizilmiş bir taklit yerine sistem denetimini gerektirir.
* Ödeme ekranından tam olarak sağlamadığınız durumlarda bir e-posta ve fatura adresi istenir ve yanıtları yalnızca boşlukları doldurur.
* Apple Pay satıcısı, Whop hesabında kayıtlı olandır. Uygulamanız hiçbir şey sağlamaz ve `In-App Payments` yeteneğine ihtiyaç duymaz.

## Kurulum

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

> [!NOTE]
>
> `WhopPaymentRequest` kapsam veya bağlı bir element gerektirmez, bu nedenle ekranda `WhopBrandingElement` gerektirmeyen tek ödeme yüzeyidir. Kayıtlı satıcı (merchant of record) satırını kendiniz gösterin. 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).


## Related topics

- [Payments](https://docs.whop.com/tr/elements/latest/payments/overview.md)
- [Kendi düğmenizden bir cüzdan sayfası açın](https://docs.whop.com/tr/developer/guides/payment-request.md)
- [Void payment](https://docs.whop.com/tr/api-reference/legacy/payments/void-payment.md)
