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

# Kurulum Amaçları API'si

> Kurulum Amacı, şimdi para almadan bir alıcının ödeme yöntemini daha sonra kullanmak üzere kaydeder.

Ödeme öğelerinin kurulum modunda topladığı bir onay token'ından veya yeniden doğrulamak için zaten kayıtlı bir ödeme yönteminden bir tane oluşturun. Bir ödemeyle aynı toplama akışını çalıştırır, bu yüzden alıcının hâlâ bir adımı tamamlaması gerekebilir: kartta 3D Secure, barındırılan bir kayıt veya bir banka hesabını bağlama.

Oluşturma yanıtı, sonucu değil, oluşturulduğu hâliyle kurulum amacıdır. `client_secret` değerini öğelerin `handleNextAction` işlevine verin veya kurulumun ne kadar ilerlediğini ve neyin beklemede olduğunu öğrenmek için [Durumu al](https://docs.whop.com/tr/api-reference/setup-intents/retrieve-setup-status.md) ile yoklama yapın. `succeeded` durumuna ulaştığında, `payment_method_id` kayıtlı yöntemi belirtir ve Ödeme Oluştur ondan tahsilat yapar.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Kurulum Amaçlarını Listele](https://docs.whop.com/tr/api-reference/setup-intents/list-setup-intents.md) | GET `/setup_intents` |
| [Kurulum Amacını Al](https://docs.whop.com/tr/api-reference/setup-intents/retrieve-setup-intent.md) | GET `/setup_intents/{id}` |
| [Kurulum durumunu al](https://docs.whop.com/tr/api-reference/setup-intents/retrieve-setup-status.md) | GET `/setup_intents/{setup_intent_id}/status` |
| [Kurulum Amacı Oluştur](https://docs.whop.com/tr/api-reference/setup-intents/create-setup-intent.md) | POST `/setup_intents` |
| [Kurulum dönüş URL'sini güncelle](https://docs.whop.com/tr/api-reference/setup-intents/update-setup-return-url.md) | PATCH `/setup_intents/{setup_intent_id}/return_url` |

## Öznitelikler

**id** `string` *required*

`sint_` önekli kurulum amacı kimliği.

**account\_id** `string | null` *required*

Ödeme yönteminin kaydedildiği `biz_` önekli hesap.

**checkout\_configuration\_id** `string | null` *required*

Bu kurulumun oluşturulduğu `ch_` önekli ödeme yapılandırması. Barındırılan
bir ödeme sayfası yerine bu API aracılığıyla oluşturulan bir kurulum için null.

**client\_secret** `string | null` *required*

Alıcının arayüzünün bu kurulumu yoklamak ve dönüş URL'sini ayarlamak için
sunduğu kimlik bilgisi — bunu öğelerin `handleNextAction` işlevine verin.
Yalnızca bu API aracılığıyla oluşturulan kurulumlarda bulunur ve listeleme
yanıtlarında her zaman null'dır — bunun için kurulum amacını alın.

**created\_at** `string` *required*

Kurulum amacının oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**last\_setup\_error** `object | null` *required*

Kurulumun neden olduğu yerde sona erdiği veya hiçbir şey başarısız olmadıysa `null`. `canceled` durumunda bulunur — vazgeçen bir alıcı kod taşımaz, sağlayıcı tarafından reddedilen ise taşır. Kurulum başarılı olduğunda kaldırılır.

> [accordion] Özellikler
>
> **code** `string | null` *required*
>
> Başarısızlığın makine tarafından okunabilir sınıflandırması, ör.
> `enrollment_declined`. Alıcı yalnızca kurulumdan vazgeçtiyse bulunmaz.
>
> **message** `string | null` *required*
>
> Başarısızlığın insan tarafından okunabilir açıklaması.

**member\_id** `string | null` *required*

Alıcının hesaptaki `mber_` önekli üye kaydı. Çağıran alıcı değilse,
member:basic:read izni olmadan null.

**metadata** `object | null` *required*

Kurulum amacı oluşturulurken eklenen kendi anahtar-değer verileriniz.

**payment\_instrument** `object | null` *required*

Bu kurulumun arkasındaki yöntem, görüntüleme için biçimlendirilmiş: alıcıya yönelik bir ad, standart simge seti ve kartsa kartın markası, son dört hanesi, kart veren kuruluş kimlik numarası, son kullanma tarihi ve ağ işlem kimliği. Bir yöntem toplanana kadar null.

> [accordion] Özellikler
>
> **card** `object | null` *required*
>
> Yalnızca kart, Apple Pay ve Google Pay ödemeleri: kartın ağı, son dört hanesi, kart veren kuruluş kimlik numarası, son kullanma tarihi ve ağ işlem kimliği.
>
> > [accordion] Özellikler
> >
> > **brand** `string | null` *required*
> >
> > `card.networks` girdileri ve kayıtlı kart ödeme yöntemleriyle eşleşen ağ
> > tanımlayıcısı (`visa`, `amex`, …). Kasa ağı kaydetmediyse null.
> >
> > **exp\_month** `number | null` *required*
> >
> > Kartın son kullanma ayı, 1 ile 12 arası. Kasa bunu kaydetmediyse null.
> >
> > **exp\_year** `number | null` *required*
> >
> > Kartın dört haneli son kullanma yılı. Kasa bunu kaydetmediyse null.
> >
> > **issuer\_identification\_number** `string | null` *required*
> >
> > BIN olarak da adlandırılan kart veren kuruluş kimlik numarası: kartı veren
> > bankayı tanımlayan kartın ilk altı veya sekiz hanesi. İşlemci bildirmediyse
> > null.
> >
> > **last4** `string | null` *required*
> >
> > Yakalandığında kartın son dört hanesi.
> >
> > **network\_transaction\_id** `string | null` *required*
> >
> > Bu hesabın kart için kullandığı ağ işlem kimliği. Whop'ta varsa, kart üzerindeki ilk müşteri huzurundaki tahsilatından veya doğrulamasından gelen bu hesabın kendi kimliğidir. Aksi takdirde bu kart için daha önceki bir ağ işlem kimliğidir; başka bir hesabın işleminden gelebilir veya kartla birlikte getirilmiş olabilir. Bu hesapta bu kartın daha sonraki satıcı tarafından başlatılan bir tahsilatında önceki işlem olarak bunu belirtin. Bir tane olana kadar null. Bir ödeme ilk kaydedilirken gönderilen bir webhook `null` taşıyabilir, bu yüzden okumak için ödemeyi alın.
>
> **display\_name** `string` *required*
>
> Alıcıya yönelik araç adı — kart göründüğünde "Visa •••• 4242", aksi takdirde
> yöntemin kendi adı ("Klarna").
>
> **icons** `object` *required*
>
> Standart simge seti: kare ve kart şekilleri, her biri açık ve koyu renk düzenlerinde.
>
> > [accordion] Özellikler
> >
> > **card** `object` *required*
> >
> > Kredi kartı oranlarında karo (48x30).
> >
> > > [accordion] Özellikler
> > >
> > > **dark** `object` *required*
> > >
> > > Koyu yüzeyler için renk düzeni.
> > >
> > > > [accordion] Özellikler
> > > >
> > > > **png\_1x** `string` *required*
> > > >
> > > > Şeklin doğal boyutunda raster yedeği.
> > > >
> > > > **png\_2x** `string` *required*
> > > >
> > > > Çift yoğunlukta raster yedeği.
> > > >
> > > > **png\_4x** `string` *required*
> > > >
> > > > Dört kat yoğunlukta raster yedeği.
> > > >
> > > > **svg** `string` *required*
> > > >
> > > > Vektör dosyası. SVG'nin görüntülendiği her yerde bunu tercih edin.
> > >
> > > **light** `object` *required*
> > >
> > > Açık yüzeyler için renk düzeni.
> > >
> > > > [accordion] Özellikler
> > > >
> > > > **png\_1x** `string` *required*
> > > >
> > > > Şeklin doğal boyutunda raster yedeği.
> > > >
> > > > **png\_2x** `string` *required*
> > > >
> > > > Çift yoğunlukta raster yedeği.
> > > >
> > > > **png\_4x** `string` *required*
> > > >
> > > > Dört kat yoğunlukta raster yedeği.
> > > >
> > > > **svg** `string` *required*
> > > >
> > > > Vektör dosyası. SVG'nin görüntülendiği her yerde bunu tercih edin.
> >
> > **square** `object` *required*
> >
> > Kare karo (32x32).
> >
> > > [accordion] Özellikler
> > >
> > > **dark** `object` *required*
> > >
> > > Koyu yüzeyler için renk düzeni.
> > >
> > > > [accordion] Özellikler
> > > >
> > > > **png\_1x** `string` *required*
> > > >
> > > > Şeklin doğal boyutunda raster yedeği.
> > > >
> > > > **png\_2x** `string` *required*
> > > >
> > > > Çift yoğunlukta raster yedeği.
> > > >
> > > > **png\_4x** `string` *required*
> > > >
> > > > Dört kat yoğunlukta raster yedeği.
> > > >
> > > > **svg** `string` *required*
> > > >
> > > > Vektör dosyası. SVG'nin görüntülendiği her yerde bunu tercih edin.
> > >
> > > **light** `object` *required*
> > >
> > > Açık yüzeyler için renk düzeni.
> > >
> > > > [accordion] Özellikler
> > > >
> > > > **png\_1x** `string` *required*
> > > >
> > > > Şeklin doğal boyutunda raster yedeği.
> > > >
> > > > **png\_2x** `string` *required*
> > > >
> > > > Çift yoğunlukta raster yedeği.
> > > >
> > > > **png\_4x** `string` *required*
> > > >
> > > > Dört kat yoğunlukta raster yedeği.
> > > >
> > > > **svg** `string` *required*
> > > >
> > > > Vektör dosyası. SVG'nin görüntülendiği her yerde bunu tercih edin.
>
> **installment\_count** `number | null` *required*
>
> Yalnızca taksitli yöntemler: tahsilatın kaç ödemeye bölündüğü. Metin değil,
> veridir — etiketi istemci tarafında oluşturun ve çevirin.
>
> **payment\_method\_type** `string` *required*
>
> Ödeme yöntemi türü tanımlayıcısı, ör. `card`, `klarna`, `apple_pay`.

**payment\_method\_id** `string | null` *required*

Ödeme Oluştur ile tahsilata hazır, `payt_` önekli kayıtlı ödeme yöntemi.
Kurulum `succeeded` olana kadar null.

**payment\_method\_type** `string | null` *required*

Kaydedilen aracın türü, örneğin `card` veya `us_bank_account`.

**return\_url** `string | null` *required*

Alıcının site dışı bir adımı tamamladıktan sonra ulaştığı yer veya onları
oldukları yerde bırakmak için `null`.

**status** `string` *required*

Kurulumun ne kadar ilerlediği. **201 veya 200, yöntemin kaydedildiği değil, yanıt verdiğimiz anlamına gelir — her zaman buna göre dallanın.** `requires_action` — alıcının bekleyen bir adımı var; `client_secret` değerini öğelere verin veya Kurulum durumunu al ile yoklama yapın. `processing` — işlemci karar veriyor. `succeeded` — yöntem kaydedildi ve yalnızca bu durum kaydedildi anlamına gelir. `canceled` — vazgeçildi veya reddedildi; `last_setup_error` alanına bakın.

Kullanılabilir seçenekler: `processing`, `succeeded`, `canceled`, `requires_action`

**three\_ds\_level** `string | null` *required*

Desteklenen oturum içi kart ödemeleri için 3D Secure davranışı. `mandate_challenge`, ödeme işlenmeden önce bir 3DS doğrulaması gerektirir; `mandate_if_required`, yalnızca ödeme işlemcisi gerektirdiğinde doğrulamayı zorunlu kılar; `frictionless_if_required`, normal sürtünmesiz 3DS akışını kullanır. 1.000 \$ veya üzeri ödemeler, `mandate_challenge` seçilmedikçe `mandate_if_required` kullanır. Risk ve kimlik doğrulama kurtarma gereksinimleri tercihi geçersiz kılabilir. Bu kurulum için istenen ayar veya ayarlanmamışsa `null`.

Kullanılabilir seçenekler: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

**three\_ds\_verified** `boolean` *required*

Alıcı bu ödeme yöntemini kaydederken 3D Secure'u tamamladığında true.

**updated\_at** `string` *required*

Kurulum amacının en son güncellendiği zaman, ISO 8601 zaman damgası olarak.

**user** `object | null` *required*

Ödeme yöntemini kaydeden kullanıcı. Alıcı kullanıcı yerine bir hesap olduğunda null.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `user_` önekli kullanıcı kimliği.
>
> **name** `string | null` *required*
>
> Görünen ad.
>
> **profile\_picture** `object` *required*
>
> Avatar sarmalayıcısı. `url` değeri her zaman mevcuttur ve kullanıcı resim ayarlamadıysa oluşturulmuş bir yer tutucudur.
>
> > [accordion] Özellikler
> >
> > **url** `string` *required*
> >
> > Avatar görsel URL'si. Her zaman mevcuttur. Kullanıcı resim ayarlamadıysa oluşturulmuş bir yer tutucudur.
>
> **username** `string` *required*
>
> Herkese açık kullanıcı adı.

```json SetupIntent theme={null}
{
	"id": "sint_xxxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"checkout_configuration_id": null,
	"client_secret": null,
	"created_at": "2026-09-22T12:00:00.000Z",
	"last_setup_error": null,
	"member_id": "mber_xxxxxxxxxxxxxx",
	"metadata": {
		"customer_id": "cus_4417"
	},
	"payment_method_id": "payt_xxxxxxxxxxxxxx",
	"payment_method_type": "card",
	"return_url": "https://shinetime.example/billing/saved",
	"status": "succeeded",
	"three_ds_verified": false,
	"three_ds_level": "mandate_challenge",
	"updated_at": "2026-09-22T12:00:00.000Z",
	"user": {
		"id": "user_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"profile_picture": {
			"url": "https://ui-avatars.com/api/"
		},
		"username": "danawhitfield"
	},
	"payment_instrument": {
		"card": {
			"brand": "visa",
			"issuer_identification_number": "41111111",
			"last4": "4242",
			"exp_month": 11,
			"exp_year": 2030,
			"network_transaction_id": "016153570198200"
		},
		"display_name": "Visa •••• 4242",
		"icons": {
			"card": {
				"dark": {
					"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
					"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
					"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
					"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
				},
				"light": {
					"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
					"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
					"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
					"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
				}
			},
			"square": {
				"dark": {
					"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
					"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
					"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
					"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
				},
				"light": {
					"png_1x": "https://content.whop.com/payment_methods/visa/icons/card_dark_30.png",
					"png_2x": "https://content.whop.com/payment_methods/visa/icons/card_dark_60.png",
					"png_4x": "https://content.whop.com/payment_methods/visa/icons/card_dark_120.png",
					"svg": "https://content.whop.com/payment_methods/visa/icons/card_dark.svg"
				}
			}
		},
		"installment_count": null,
		"payment_method_type": "card"
	}
}
```


## Related topics

- [Olaylar API'si](https://docs.whop.com/tr/api-reference/events/event.md)
- [API Kararlılığı](https://docs.whop.com/tr/api-reference/stability.md)
- [Deneyler API'si](https://docs.whop.com/tr/api-reference/experiments/experiment.md)
