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

# Payments

> Bir `plan_` kimliğinden veya satır içi para birimi ve tutardan ödeme alın ya da `mode: "setup"` ile ücret almadan bir ödeme yöntemini kaydedin. PaymentElement, CardElement veya CardFields bağlayın, ardından fatura bilgileriyle `payments.createConfirmationToken` çağırın. Cüzdan seçimleri sayfalarını otomatik olarak açar. Hesap sayfa içi banka bağlantısı sunduğunda (banka hesabı ödeme yöntemi türünde `bank_debit.bank_connection`), bir banka hesabı seçimi de sayfada Plaid Link'i açar. Bunlardan birini kapatan bir alıcı, çağrının `payment_request_cancelled` ile reddedilmesine yol açar; ödeme işleyiciniz bunu bir iptal olarak ele almalıdır. Token'ı sunucu tarafında onaylayın, ardından bekleyen herhangi bir adım için ödemenin veya setup intent'in `client_secret` değerini `handleNextAction` çağrısına iletin.

> [!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, Payments } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

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

```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 */ });
</script>
```

## Seçenekler

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

> [!NOTE]
>
> Bu kombinasyonlardan tam olarak birini iletin:
>
> * `accountId` ve `plan`
> * `accountId`, `currency` ve `amount`
> * `accountId`, `mode: "setup"` ve `currency`
> * `plan`, `currency`, `amount` veya `mode` değerlerinin hiçbiri

**accountId** `string`

`biz_` önekli hesap kimliği. Yalnızca bir hesap yüzeyi olmadan statik metotları çağırırken belirtmeyin.

**mode** `"payment" | "setup"`

Bağlama modu, varsayılan olarak `payment`. `setup` bir ödeme yöntemini kaydeder ve ne şimdi ne de daha sonra ücret alır: yalnızca kaydedilebilen yöntemler sunulur ve tutar sınırları uygulanmaz. `createConfirmationToken()` ile onaylayın, ardından setup intent'i sunucu tarafında oluşturun.

**plan** `string`

`plan_` önekli plan kimliği. İstemci tarafında para birimi, tutar ve yöntem yapılandırmasına çözümlenir. Bir plan veya satır içi para birimi ve tutar iletin, asla ikisini birden iletmeyin.

**offerAmounts** `object`

Ödeme, BNPL gibi ücretsiz bir yöntem için `amount` değerini yeniden fiyatlandırdığında yöntemleri sınırlamak için kullanılan, küçük birim cinsinden `feeInclusive` ve `feeFree` toplamları. Her yöntem eşleşen toplamına göre kontrol edilir; bu, seçilen ücretsiz yöntemin kaybolmasını önler. Belirtilmezse her yöntemi `amount` sınırlar.

**özellikler**

**feeInclusive** `number` *required*

**feeFree** `number` *required*

**returnUrl** `string`

Site dışı banka veya 3DS adımları için dönüş URL'si. Varsayılan olarak bağlamanın yapıldığı sayfadır. Sonuç ne olursa olsun alıcı, `payment` (veya `setup`), `status` (`succeeded`, `failed`, `canceled` ya da `processing` gibi hâlâ beklemede olan bir durum) ve `client_secret` eklenmiş şekilde oraya ulaşır; bu nedenle bir başarı sayfası göstermeden önce `status` değerine göre dallanın.

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

Bir kurulum (setup), ödeme yöntemini bir kurulumun kabul ettiği tek kullanım olan `off_session` kullanımı için kaydeder.

**previewWalletAvailability** `WalletAvailability`

Belirleyici önizlemeler için cüzdan kullanılabilirliği geçersiz kılması. Canlı ödemeler ana ortamı yoklar.

**özellikler**

**applePay** `boolean` *required*

**googlePay** `boolean` *required*

**payPal** `boolean`

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

Hangi sayfanın bu tarayıcıya özgü olduğuna göre sıralanmış cüzdanlar — 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 sıralanabilir. Kullanıcı tarafından belirtilen kullanılabilirlikte (önizlemeler) ve bundan önceki bağlantı biçimlerinde bulunmaz. payment-request'in WalletSheetType türü değil, satır içi bir birleşim türü: o modül zaten bunu içe aktarır.

**wallets** `object`

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

**özellikler**

**apple\_pay** `WalletDetails`

**özellikler**

**button** `WalletButtonArt`

Cüzdanın resmi düğme görseli. Yayınlanmış bir görsel yoksa 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 resmi düğme görseli. Yayınlanmış bir görsel yoksa 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 resmi düğme görseli. Yayınlanmış bir görsel yoksa 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*

**currency** `string`

Küçük harfli, üç harfli ISO 4217 para birimi kodu. Ödeme yöntemi matrisini filtreler.

**amount** `number`

Küçük birim cinsinden ödeme tutarı. Sınırları bu tutarı kapsamayan yöntemler sunulmaz.

**paymentMethodConfiguration** `object`

API'nin `enabled`, `disabled` ve `include_platform_defaults` biçimindeki hesap ödeme yöntemi filtreleri. `disabled` türleri kaldırır, `enabled` sunulan türleri geri getirir ve `include_platform_defaults: false` yalnızca etkinleştirilmiş türleri bırakır. Planlar kendi yapılandırmalarını sağlar.

**özellikler**

**enabled** `string[]`

**disabled** `string[]`

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

**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 yerleşik 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.

### `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.payments.create({ … })` veya `usePayments()` üzerinden alınan Payments tanıtıcısında çağırın.

### `createConfirmationToken`

Ödeme düğmenizden seçilen yöntem için bir onay token'ı oluşturur. Ödemenin fatura bilgilerini iletin. Bunlar `email` içermelidir. Fatura bilgisi toplama devre dışıyken bunu gerektiren yöntemler için `phone` sağlayın. Kartlar ayrıca `name` ve `line1` ile `country` içeren bir adres gerektirir. Cüzdan seçimleri, ödeme düğmesi etkileşimi sırasında sayfalarını açar. Hesap sayfa içi banka bağlantısı sunduğunda (banka hesabı ödeme yöntemi türünde `bank_debit.bank_connection`), bir banka hesabı seçimi de bu sırada Plaid Link'i açar ve çağrı, alıcı bir hesap bağladığında çözümlenir. Bunun için bir whop.com sayfası veya [Domains API](https://docs.whop.com/tr/api-reference/beta/domains/domain) aracılığıyla Apple Pay için hazırlanmış bir alan adı ve `contentSecurityPolicy()` tarafından döndürülen Plaid ana makinelerine izin veren bir İçerik Güvenliği Politikası gerekir. Aksi takdirde alıcı hesabı bunun yerine gönderimden sonra bağlar. Alıcı sayfayı veya Link'i kapatırsa çağrı `payment_request_cancelled` ile reddedilir: bunu bir ödeme hatası olarak değil, bir iptal olarak ele alın ve alıcının yeniden ödeme yapmasına izin verin. Döndürülen `confirmationToken` değerini sunucu tarafında onaylayın, ardından `WhopElements.payments.handleNextAction(…)` çağırın. Denetleyici iframe'inde değil, sayfanızda (ana taraf) çalışır.

**Parametreler**

**input** `object` *required*

**özellikler**

**billingDetails** `object`

**özellikler**

**email** `string`

**name** `string`

**phone** `string`

**address** `object`

**özellikler**

**country** `string`

**line1** `string`

**line2** `string`

**city** `string`

**state** `string`

**postal\_code** `string`

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

**confirmationToken** `string` *required*

**type** `string` *required*

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

## Statik metotlar

Bunları bağlama yapmadan çağırın: vanilla JavaScript'te `whop.payments.<method>(…)` veya React'te `useWhop().payments.<method>(…)`.

### `handleNextAction`

Onaylanmış bir ödemenin bekleyen adımını bir element bağlamadan tamamlar. Ödemeyi `clientSecret` tanımlar. Bir ödeme kimliğine ihtiyacınız yoktur. Satır içi adımlar bir iletişim kutusunda açılır ve `redirected: false` ile çözümlenir. İletişim kutusunu kapatmak, ödemenin beklemede kalabilecek mevcut durumunu döndürür. Tam sayfa adımlar `redirected: true` ile `return_url` adresine veya ödemenin dönüş URL'si yoksa barındırılan bir makbuza yönlendirir. Bir iframe içinde en üst düzey sekmede gezinirler. Yerleştiren sayfa bu gezinmeyi reddederse `TAB_NAVIGATION_BLOCKED` koduyla reddedilirler ve ödeme beklemede kalır. Hedefi sunumdan önce güncellemek için `returnUrl` ayarlayın. Bir güncelleme hatası, herhangi bir adım çalışmadan önce reddedilir. Satır içi adımlar asla o URL'ye gitmez. Ücreti hâlâ belirlenmekte olan bir ödeme, bir adım görünene veya sonuçlanana kadar yoklanır; adımı olmayan, sonuçlanmış bir ödeme hemen çözümlenir.

**Parametreler**

**input** `object` *required*

**özellikler**

**clientSecret** `string` *required*

**returnUrl** `string`

**pollIntervalMs** `number`

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

**status** `string` *required*

**redirected** `boolean` *required*

**lastPaymentError** `object | null` *required*

**özellikler**

**code** `string | null`

**decline\_code** `string | null`

**message** `string | null`

## Kaynaklar

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

> [card] [PaymentRequest](https://docs.whop.com/tr/elements/latest/payments/paymentRequest.md)
>
> Özel düğmeler, hızlı ödeme ve teslimat geri çağırmaları için düşük seviyeli Apple Pay, Google Pay veya PayPal sayfası. Cüzdan kutucukları bu akışı `payments.createConfirmationToken` aracılığıyla otomatikleştirir. Kullanılabilirliği kontrol etmek ve cüzdanı hazırlamak için `canMakePayment()` sonucunu bekleyin, ardından kullanıcı etkileşimi işleyicisinde `show(type)` çağrısını eşzamanlı olarak yapın. Çözümlenen `ctok`, `ctok_` önekli bir onay token'ıdır. Bunu, bir elementin ürettiği token gibi sunucu tarafında onaylayın. Bir PayPal token'ı en fazla PayPal'ın alıcıya gösterdiği toplam tutarı tahsil eder.

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

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

| Gereksinim | Yönerge | Üretim kaynağı | Sandbox kaynağı |
| - | - | - | - |
| Plaid Link betiği | `script-src` | `https://cdn.plaid.com` | Aynı |
| ↳ Plaid betiğinin açtığı Plaid Link çerçevesi | `frame-src` | `https://cdn.plaid.com` | Aynı |
| ↳ Plaid betiğinin çağırdığı Plaid API'si | `connect-src` | `https://production.plaid.com` | `https://sandbox.plaid.com` |

## Elementler

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

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

> [card] [EmailElement](https://docs.whop.com/tr/elements/latest/payments/email.md)
>
> Alıcının e-postasını toplar ve bağlı olduğu sürece `payments.createConfirmationToken()` çağrısına iletir. Açıkça belirtilen `billingDetails.email` önceliklidir. Eşleşen bir Whop hesabı, kod doğrulamasıyla veya hesabın bir geçiş anahtarı (passkey) varsa onunla isteğe bağlı oturum açma seçeneği gösterir. Başarılı oturum açma, ödeme elementindeki kayıtlı ödeme yöntemlerinin kilidini açar. Alıcılar misafir olarak devam edebilir.

> [card] [TaxIdElement](https://docs.whop.com/tr/elements/latest/payments/taxId.md)
>
> API tarafından kabul edilen bir işletme vergi kaydını toplar. Etiketler alıcıya yönelik adlar kullanır. Yer tutucu, seçilen biçimle eşleşir. `country` bir türü önceden seçer. `onChange` kesinleşmiş çiftleri yayar. API doğrulama hatalarını ana uygulama sağlar.

> [card] [BrandingElement](https://docs.whop.com/tr/elements/latest/payments/branding.md)
>
> **Zorunlu — `AddressElement`, `EmailElement` ve `TaxIdElement` dışındaki diğer elementler onu bekler.** Whop'un kayıtlı satıcı (merchant of record) bildirimi: alıcının Whop'un Alıcı Hizmet Şartları'nı ve Gizlilik Politikası'nı kabul ettiği metin, Whop logo yazısıyla birlikte. Zorunludur; ödeme, kart ve kart alanları elementleri bu bağlanana kadar yükleme durumunda kalır ve onsuz ödemeler onaylanamaz.

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

> [card] [PaymentElement](https://docs.whop.com/tr/elements/latest/payments/payment.md)
>
> Kullanılabilir ödeme yöntemlerini gösterir ve seçilen yöntemin gerekli alanlarını ve bildirimlerini toplar. Ödeme düğmenizi etkinleştirmek için `change` kullanın. Etkinleştirme işleyicisinde `payments.createConfirmationToken()` çağırın. Token'ı sunucu tarafında onaylayın, ardından bekleyen herhangi bir adımı `payments.handleNextAction(…)` çağrısına iletin. Adrese bağlı güncellemeler için `addressChange` kullanın.

> [card] [CardElement](https://docs.whop.com/tr/elements/latest/payments/card.md)
>
> Kart numarası, son kullanma tarihi ve güvenlik kodu için önceden düzenlenmiş alanlar. `payments.create("card")` ile oluşturun, ödeme düğmenizi `onChange` üzerinden etkinleştirin ve `payments.createConfirmationToken()` ile onaylayın. Kart numaraları PCI'dan yalıtılmış barındırılan alanlarda kalır. `layout`, `stacked` (varsayılan) ve `compact` değerlerini destekler.

> [card] [CardFields](https://docs.whop.com/tr/elements/latest/payments/cardFields)
>
> Özel düzenler için ayrı ayrı bağlanabilen, PCI'dan yalıtılmış üç kart alanı: numara, son kullanma tarihi ve güvenlik kodu. `payments.create("cardFields")` ile oluşturun, her alanı yerleştirin, ödeme düğmenizi `onChange` üzerinden etkinleştirin ve `payments.createConfirmationToken()` ile onaylayın. Kart numaraları barındırılan alanlarda kalır. *(alt denetleyici, 3 element)*


## Related topics

- [Payments API](https://docs.whop.com/tr/api-reference/payments/payment.md)
- [Retrieve Payment](https://docs.whop.com/tr/api-reference/payments/retrieve-payment.md)
- [Retry Payment](https://docs.whop.com/tr/api-reference/payments/retry-payment.md)
