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

# Checkout

> Whop ödeme oturumları API'sine karşı bir veya daha fazla plan için eksiksiz, barındırılan bir ödemeyi yönetir: kalem kalem fiyat özeti, promosyon kodları, alıcının ödeme yaptığı para birimi ve ödeme toplama yüzeyinin tamamı (içine yerleştirilmiş ödeme elementleri). `items`, tek bir `plan` veya oluşturduğunuz bir `checkoutConfiguration` ile bağlayın; element ödeme oturumunu kendisi açar; oturum kimlik bilgisi elementten asla çıkmaz. Kurulum (setup) modundaki bir ödeme yapılandırması aynı elementi bir ödeme yöntemi kaydetme işlemi olarak bağlar: hiçbir ücret alınmaz, alıcının yöntemi daha sonra ücretlendirmeniz için saklanır ve tamamlanan ödeme `setup_intent_id` ile yönlendirilir. Alıcı element içinde ödeme yapar ve tamamlanan bir ödeme, elementi içeren sayfa da dahil olmak üzere geçerli sekmeyi `returnUrl` adresine yönlendirir. Teslimatı bir tarayıcı geri çağırması yerine webhook'lardan yapın. `returnUrl` olmadan alıcı elementin kendi başarı ekranında kalır. Element, 3DS veya bir banka sayfası gibi site dışı bir ödeme adımını otomatik olarak yönetir. whop.com üzerinde alıcıyı geri yüklenen ödemeye geri getirir; bir gömme içinde ise alıcı, sonuç ne olursa olsun `payment` ve `status` sorgu parametreleriyle (`succeeded`, `failed` veya `canceled`) aynı `returnUrl` adresine döner; bu nedenle `returnUrl` adresindeki sayfa, ziyareti bir satış olarak değerlendirmeden önce `status` değerini okumalıdır. Element içinde başarısız olan bir ödeme, nedeni gösterilerek aynı ödemeyi yeniden açar, böylece alıcı tekrar ödeme yapabilir. Her seçenek oluşturma sırasında ayarlanır: element bağlandığında bu değerlerden bir ödeme oturumu oluşturur. Daha sonra `update()` veya yeni React prop'larıyla birini değiştirmek mevcut siparişi değiştirmek yerine başarısız olur. Satın alınan şeyi değiştirmek için yeni bir ödeme bağlayı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.*

## Playground

Elementleri örnek verilerle bir araya getirin. Kontrolleri kullanın, elementler ekleyip düzenleyin ve olayların canlı olarak tetiklenmesini izleyin:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Checkout /* options */>
        {/* mount elements here */}
      </Checkout>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const checkout = window.WhopElements().checkout.create({ /* options */ });
</script>
```

## Seçenekler

Bunları `whop.checkout.create({ … })` çağrısına veya React'te `<Checkout>` üzerinde prop olarak iletin.

**plan** `string`

`plan_` önekli mevcut plan kimliği. Bu planı ve `quantity` değerini içeren bir `items` dizisinin kısaltmasıdır. Fiyatı plan belirler; tutarlarla ilgili hiçbir şey istemci tarafında belirlenemez. `plan`, `items` veya bir `checkoutConfiguration` değerinden birini iletin. Yalnızca oluşturma sırasında ayarlanır: oturum bundan oluşturulur ve daha sonra değiştirilmesi reddedilir.

**quantity** `number`

Satın alınacak birim sayısı. Birden fazla adete izin vermeyen planlar 1'in üzerindeki değerleri reddeder. Yalnızca oluşturma sırasında ayarlanır: oturum bununla oluşturulur ve daha sonra değiştirilmesi reddedilir. @default 1

**items** `CheckoutItemInput[]`

Bu ödemedeki planlar ve her birinden kaç birim satın alınacağı. Her öğe aynı satıcıya ait olmalı ve uyumlu faturalama koşulları kullanmalıdır; API sepetin tamamını doğrular ve tek bir ücret olarak fiyatlandırır. Bunu `plan`, `quantity` veya `checkoutConfiguration` yerine iletin. Yalnızca oluşturma sırasında ayarlanır: oturum tam olarak bu sepetten oluşturulur ve daha sonra değiştirilmesi reddedilir.

**özellikler**

**plan** `string` *required*

`plan_` önekli mevcut plan kimliği.

**quantity** `number`

Satın alınacak birim sayısı. Varsayılan değer 1'dir; planlar 1'in üzerindeki miktarlara izin vermeyebilir.

**checkoutConfiguration** `string`

`ch_` önekli mevcut ödeme yapılandırması kimliği. Element ödeme oturumunu bundan oluşturur: yapılandırma satılan planı belirtir (veya `setup` modunda hiçbir plan belirtmez; ödeme bir ödeme yöntemini kaydeder ve hiçbir ücret almaz) ve kendi satış ortağı kodunu, meta verilerini, yönlendirmesini ve ödeme yöntemi ön ayarlarını belirler; burada onunla birlikte iletilen bir seçenek, alan bazında yapılandırmanın kopyasına göre önceliklidir. Yanında `plan` değerini yalnızca `quantity` ayarlamak için iletin; bu, yapılandırmanın kendi planı olmalıdır ve ön ayarlarının altından asla değiştirilemez. Yalnızca oluşturma sırasında ayarlanır.

**promoCode** `string`

Alıcı fiyatı görmeden önce uygulanacak bir promosyon kodu; indirim ilk fiyat teklifindedir ve alıcı yine de onu değiştirebilir veya kaldırabilir. Bir pazarlama bağlantısının taşıdığı kodu iletin: süresi dolmuş veya hiç geçerli olmamış bir kod, ödemeyi promosyon satırında nedeni gösterilerek tam fiyattan açar; asla açılmayan bir ödemeye yol açmaz. Yalnızca oluşturma sırasında ayarlanır.

**affiliateCode** `string`

Bu ödemenin ilişkilendirildiği satış ortağı. Yalnızca oluşturma sırasında ayarlanır.

**attribution** `CheckoutAttributionInput`

Hesabın raporlaması için bu satışın nereden geldiği: alıcının geldiği bağlantının kampanya parametreleri (`utmSource`, `utmMedium`, `utmCampaign`, `utmTerm`, `utmContent`, `utm` altındaki diğer tüm `utm_*` parametreleri, bir Whop `trackingLinkId`, bir `funnelId` ve kendi `source` değeriniz). Buradaki her şey siparişe karşı kaydedilir ve alıcıya asla gösterilmez. Yalnızca oluşturma sırasında ayarlanır.

**özellikler**

**utmSource** `string`

**utmMedium** `string`

**utmCampaign** `string`

**utmTerm** `string`

**utmContent** `string`

**trackingLinkId** `string`

**funnelId** `string`

**source** `string`

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

Bağlantının taşıdığı diğer tüm `utm_*` parametreleri, tam adlarıyla anahtarlanmış olarak (`{ utm_funnel: 'spring' }`). `utm_` ile başlamayan anahtarlar yok sayılır ve yukarıdaki adlandırılmış alanlar buradaki aynı anahtara göre önceliklidir.

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

Siparişe karşı kaydedilecek ve ödemede geri okunacak kendi anahtar/değer çiftleriniz: sipariş kimlikleri, sepet kimlikleri veya mutabakat yaptığınız herhangi bir şey. En fazla 40 dize çifti. Yalnızca oluşturma sırasında ayarlanır.

**returnUrl** `string`

Sonucu ne olursa olsun, site dışı bir ödeme adımından sonra alıcının ulaştığı adres. Sekme, sonuna `payment` (`pay_` kimliği; kurulum modundaki bir ödeme için `sint_` kimliğiyle `setup`) ve `status` (`succeeded`, `failed` veya `canceled`) eklenmiş ve diğer sorgu parametreleriniz korunmuş olarak gelir. Bir başarı sayfası göstermeden önce `status` değerine göre dallanın: reddedilen veya yarıda bırakılan bir site dışı adım da buraya ulaşır. Teslimatı bu ziyaretten değil, webhook'lardan yapın. Yalnızca https (localhost için http). Yalnızca oluşturma sırasında ayarlanır.

**appearance** `Appearance`

Bu grubun elementleri için görsel özelleştirme. Genel `WhopElements({ appearance })` ayarını geçersiz kılar. `update({ appearance })` ile canlı olarak değiştirin.

**locale** `WhopElementsLocale`

Bu grubun element arayüz metinleri için yerel ayar. Genel yapılandırmayı geçersiz kılmak için uygulamanın derlenmiş yerel ayarlarından birine ayarlayın. Diğer tüm değerler varsayılan yerel ayara geri döner.

## Olaylar

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

### `onComplete`

Ödeme tamamlandığında ve sonucu kesinleştiğinde bağlama başına bir kez tetiklenir. `result` neyin kesinleştiğini belirtir: `payment` (alıcı ödeme yaptı, `paymentId`), `waitlist_entry` (alıcı bir bekleme listesine katıldı, `entryId`) veya `setup` (kurulum modundaki bir ödeme ödeme yöntemini kaydetti, `setupIntentId`); `sessionId` her durumda ödeme oturumudur. Herhangi bir `returnUrl` gezinmesinden önce tetiklenir, bu nedenle kendi analizlerinizin veya reklam piksellerinizin satın alma işlemini kaydettiği yer burasıdır. Teslimatı bu geri çağırmadan değil, webhook'lardan yapın: daha sonraki bir sayfa yüklemesinde geri yüklenen bir ödeme, aynı sonuç için onu tekrar tetikler.

**payload** `CheckoutPaymentCompletion | CheckoutWaitlistCompletion | CheckoutSetupCompletion`

**CheckoutPaymentCompletion**

**sessionId** `string` *required*

`chs_` önekli ödeme oturumu.

**result** `"payment"` *required*

**paymentId** `string` *required*

`pay_` önekli ödeme; satın alma işleminin altında kaydedileceği kimlik.

**CheckoutWaitlistCompletion**

**sessionId** `string` *required*

`chs_` önekli ödeme oturumu.

**result** `"waitlist_entry"` *required*

**entryId** `string` *required*

`ent_` önekli bekleme listesi girişi.

**CheckoutSetupCompletion**

**sessionId** `string` *required*

`chs_` önekli ödeme oturumu.

**result** `"setup"` *required*

**setupIntentId** `string` *required*

`sint_` önekli kaydedilmiş kurulum.

### `onLoadingChange`

Gruplanmış yükleme durumu değiştiğinde çalışır. Bağlı herhangi bir element hâlâ yüklenirken değer `true` olur.

**loading** `boolean`

## Metotlar

Bunları `whop.checkout.create({ … })` veya `useCheckout()` üzerinden alınan Checkout tanıtıcısında çağırın.

### `update`

Yeni tanıtıcı seçeneklerini bağlı her elementle birleştirir. React'te bunun yerine ad alanı prop'larını değiştirin.

**Parametreler**

**options** `Partial\<CheckoutOptions\>` *required*

### `destroy`

Bu tanıtıcının oluşturduğu her elementi ve alt denetleyiciyi yok eder, denetleyici çerçevesini kaldırır ve aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz, ancak yok edilmiş bir tanıtıcı diğer tüm çağrıları reddeder; baştan başlamak için yeni bir tanıtıcı oluşturun. React, sağlayıcı kaldırıldığında grubu otomatik olarak kaldırır.

## Kaynaklar

Bu SDK nesnelerini bir element bağlamadan oluşturun. Her birinin kendi sayfası vardır:

> [card] [CheckoutSession](https://docs.whop.com/tr/elements/latest/checkout/checkoutSession.md)
>
> 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.

## Elementler

Bu grubun bağladığı elementler. Her birinin kendi sayfası vardır:

**Alternatifler.** Aynı anda yalnızca birini bağlayın. Başka birini bağlamadan önce onu yok edin:

> [card] [CheckoutElement](https://docs.whop.com/tr/elements/latest/checkout/checkout.md)
>
> Eksiksiz ödeme yüzeyi: canlı fiyat teklifiyle sipariş özeti, promosyon kodu girişi, alıcının ödeme yaptığı para birimi, bu ödemenin alıcıdan toplaması gereken her şey, birleştirilmiş ödeme yöntemleri yüzeyi ve ödeme akışı. Topladığı şey, satıcının ayarladığı her neyse odur (e-posta, kendi soruları, bir telefon numarası, fiziksel ürünler için bir teslimat adresi, koşullarının açıkça kabul edilmesi) ve satıcının seçtiği sırayla tek bir ekranda birlikte gösterilir; bu nedenle yeni bir şey istemeye başlayan bir satıcının burada herhangi bir değişiklik yapması gerekmez. Satın alma işleminin tamamını gösterir; oturum ve kimlik bilgisi ödeme denetleyicisine aittir. Site dışı bir adım gerektiren bir ödemeden sonra alıcı geri döndüğünde, sunucunun bildirdiği sonucu da bu aynı yüzey gösterir.

> [card] [ExpressCheckoutElement](https://docs.whop.com/tr/elements/latest/checkout/expressCheckout.md)
>
> Bir ödeme için tek dokunuşla Apple Pay, Google Pay ve PayPal düğmeleri: cüzdan, oturumun hâlâ ihtiyaç duyduğu her şeyi toplar (alıcının e-postası, fiziksel ürünler için bir teslimat adresi, Apple Pay ve Google Pay'de satıcının topladığı durumlarda bir telefon numarası ve Apple Pay'de satıcının giriş sunduğu durumlarda bir promosyon kodu) ve tek bir dokunuş satın alma işlemini tamamlar. Giriş alanını tam ödeme elementiyle paylaşır, bu nedenle bir tanıtıcı ikisinden tam olarak birini bağlar: satın alma işleminin bir sayfa (sheet) tarafından tamamlanabilecek kadar basit olduğu durumlarda yalnızca bu düğme, diğer her şey için tam ödeme yüzeyi. Yalnızca alıcının cihazının gerçekten ödeme yapabildiği ve ödemenin kendi ödeme yöntemi yapılandırmasının izin verdiği cüzdanları, sunulan düğme görselleriyle gösterir ve hiçbir cüzdan kullanılamadığında hiçbir şey göstermez. PayPal, satıcının kabul ettiği durumlarda görünür, kendi penceresinde açılır ve alıcının PayPal hesabını satın alma işlemiyle birlikte kaydeder; böylece bir yenileme, ücretsiz deneme ve satıcının daha sonra yaptığı ücretlendirmeler kayıtlı bir kart gibi çalışır. Üç cüzdanın tamamı sayfanın alan adında Apple Pay gerektirir: birinci taraf whop.com sayfaları önceden onaylıdır ve diğer tüm siteler, bu düğmelerden herhangi biri orada gösterilmeden önce [Domains API](https://docs.whop.com/tr/api-reference/beta/domains/domain) aracılığıyla alan adlarına Apple Pay eklemelidir. Google Pay'i kendi sitenizde sunmak Google Pay API Hizmet Şartları'na tabidir. Sayfanın dürüstçe tamamlayamayacağı bir ödeme (bekleme listesine katılma, bir aktarım, yalnızca bir sayfanın sorabileceği bir form sorusu), başarısız olacak bir düğme göstermek yerine açıkça reddedilir.


## Related topics

- [CheckoutSession](https://docs.whop.com/tr/elements/latest/checkout/checkoutSession.md)
- [CheckoutElement](https://docs.whop.com/tr/elements/latest/checkout/checkout.md)
- [Delete a Checkout Configuration](https://docs.whop.com/tr/api-reference/checkout-configurations/delete-a-checkout-configuration.md)
