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

# CheckoutSession

> Kendi PayPal düğmesini çizen bir sayfa için düşük seviyeli, arayüzsüz (headless) ödeme oturumu. `load()`, ödeme oturumunu `lineItems` üzerinden oluşturur; `show("paypal", { termsAccepted: true })` alıcıyı PayPal'a gönderir (masaüstünde bir açılır pencere, telefonlarda sekmenin tamamı) ve alıcı onayladığında ödemeyle birlikte çözümlenir. `paymentMethodOptions.paypal.requestShipping` ile PayPal alıcıdan bir teslimat adresi ister ve hesabın `shipping_address.changed` olayına abone olan webhook'u, alıcı PayPal'dayken her adresi sunucunuzda fiyatlandırır; ödeme yalnızca alıcı onayladıktan sonra, o fiyattan oluşturulur. Tam sayfa yönlendirmeden sonra promise hiçbir zaman sonuçlanmaz; bunun yerine sonucu `redirectUrl` adresinin `payment` ve `status` sorgu parametrelerinden okuyun.

> [!NOTE]
>
> Bu sayfa `@whop/elements@1.10.0` ve `@whop/elements-react@1.10.0` sürümlerini belgeler.

*`v1.10.0` sürümünden beri.*

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

## Seçenekler

Bunları `whop.checkout.checkoutSession.create({ … })` çağrısına iletin.

**accountId** `string` *required*

Satır öğelerini satan, `biz_` önekli hesap kimliği.

**lineItems** `CheckoutSessionLineItem[]` *required*

Alıcının satın aldığı şey: her giriş bir varyantı (`plan_…`) ve isteğe bağlı bir `quantity` değerini (varsayılan 1) belirtir. Birden fazla giriş bir sepet oluşturur.

**özellikler**

**variant** `string` *required*

**quantity** `number`

**redirectUrl** `string` *required*

Sekme yönlendirildiğinde alıcının PayPal'dan sonra ulaştığı adres; sonuna `payment` ve `status` eklenir: `succeeded`, `canceled`, `failed` veya Whop ödemeyi hâlâ tamamlarken `processing` (sonuçlandığını görmek için ödemeyi sunucunuzdan okuyun). Masaüstünde bunun yerine açılır pencere kapanır ve `show()` sonuçlanır.

**metadata** `Record\<string, string\>`

Ödeme oturumunda tutulan ve oluşturduğu ödemeye kopyalanan, en fazla 40 adet kendi dize anahtarınız ve değeriniz; böylece ödemede ve webhook'larında geri gelirler, örneğin reklam ve satış ortaklığı ilişkilendirmesi için. Alıcının tarayıcısından ayarlandıkları için fiyatlar veya teslimat için asla bunlara güvenmeyin.

**setupFutureUsage** `"off_session"`

Alıcının PayPal hesabını kaydetmek için `off_session` olarak ayarlayın; böylece sunucunuz daha sonra alıcı olmadan, örneğin tek tıklamalı bir ek satış için ücretlendirme yapabilir. PayPal, alıcı onay verirken gelecekteki ödemeleri kabul etmesini ister. Bunu yalnızca alıcıya PayPal hesabının kaydedileceğini söyledikten sonra ayarlayın.

**email** `string`

Ödemenin ve üyeliğin ait olduğu alıcının e-postası. Onay veren PayPal hesabının e-postasını kullanmak için atlayın.

**paymentMethodOptions** `CheckoutSessionPaymentMethodOptions`

Tek bir ödeme yöntemi için seçenekler. `paypal.requestShipping`, PayPal'ın alıcıdan bir teslimat adresi istemesini sağlar. Hesabın `shipping_address.changed` olayına abone olan etkin bir `https` webhook'u olduğunda Whop her adres için onu çağırır ve yanıt olarak döndürdüğü toplamları tahsil eder. Varsayılan değer `false`.

**özellikler**

**paypal** `CheckoutSessionPayPalOptions`

**özellikler**

**requestShipping** `boolean`

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

### `load`

Ödeme oturumunu `lineItems` üzerinden oluşturur. Tekrar çağırmak aynı oturumu döndürür. `show()`, oturum henüz yüklenmemişse önce onu yükler. `terms`, alıcının ödeme yaparak kabul ettiği şeydir: `links` değerlerini (satıcının yayımlanmış politikaları ve Whop'un alıcı koşulları) düğmenizin yanında gösterin ve `terms.required` değeri `true` olduğunda alıcının bunları etkin biçimde, örneğin bir onay kutusuyla kabul etmesini sağlayın. `requirements`, oturumun ödenebilmesi için gerekenleri listeler: `email`, `terms` ve `paypal.requestShipping` ile `shipping_address` dışındaki hiçbir şey burada toplanamaz, bu nedenle `show()` bunları reddeder.

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

**id** `string` *required*

**status** `string` *required*

**requirements** `string[]` *required*

**terms** `CheckoutSessionTerms` *required*

**özellikler**

**required** `boolean` *required*

**links** `CheckoutSessionTermsLink[]` *required*

**özellikler**

**kind** `string` *required*

`"terms_of_service"`, `"privacy_policy"`, `"return_policy"`, `"eula"`, `"whop_buyer_terms"` veya `"whop_privacy_policy"` değerlerinden biri.

**url** `string` *required*

### `show`

Bunu PayPal düğmenizin tıklama işleyicisinde senkron olarak çağırın: masaüstünde açılır pencereyi orada açar ve daha sonra açılan bir açılır pencere engellenir. `termsAccepted: true` değerini yalnızca `load()` çağrısının `terms.links` değerleri bu basış için düğmenin yanında gösterildiyse ve `terms.required` değeri `true` olduğunda alıcı bunları etkin biçimde kabul ettiyse iletin. Alıcı onaylayıp Whop ücreti tahsil ettiğinde `{ payment }` ile çözümlenir. `termsAccepted` olmadan `code` değeri `attestation_required`, oturum PayPal'ın toplayamayacağı bir şeye ihtiyaç duyduğunda `requirements_unsupported` (`load()` çağrısının `requirements` değerine bakın), alıcı PayPal'ı iptal ettiğinde veya kapattığında `payment_request_cancelled`, hesap bu ödemeyi webhook'u aracılığıyla fiyatlandıramadığında `seller_pricing_unavailable` (kendi vergisini yönetmiyorsa veya sepette bir promosyon kodu, alıcı ücreti, pazar yeri bölüşümü ya da yenilenen bir plan varsa) ve diğer durumlarda `payment_failed` olan bir hatayla reddedilir. Telefonlarda sekme PayPal'a gider ve promise hiçbir zaman sonuçlanmaz. Kullanıcı etkinleştirmesi sırasında senkron olarak çağırın. Tarayıcılar asenkron adımlar arasında etkinleştirmeyi iptal ettiği için ön koşulları önceden bekleyin.

**Parametreler**

**paymentMethod** `"paypal"` *required*

**options** `CheckoutSessionShowOptions`

**özellikler**

**termsAccepted** `boolean`

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

**payment** `CheckoutSessionPayment` *required*

**özellikler**

**id** `string` *required*

**status** `string` *required*
