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

# Onay Belirteçleri API'si

> Onay Belirteci, bir alıcıdan toplanan ödeme yöntemine ve fatura bilgilerine yönelik tek kullanımlık, kısa ömürlü bir referanstır.

Yanıtı hiçbir zaman temeldeki ödeme kimlik bilgisini döndürmez.

Whop Elements, alıcıya yönelik toplama akışınızda belirteci oluşturur ve sunucunuzdan Payments API'sine göndermeniz için size `ctok_` kimliğini verir. Ödeme yöntemini ve fatura önizlemesini görüntülemek veya hâlâ kullanılabilir olup olmadığını kontrol etmek için bir belirteci alın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Onay Belirtecini Al](https://docs.whop.com/tr/api-reference/confirmation-tokens/retrieve-confirmation-token.md) | GET `/confirmation_tokens/{id}` |

## Öznitelikler

**id** `string` *required*

**billing\_address** `object | null` *required*

Adres üzerindeki ad dahil, toplanan fatura adresi. Toplanmadıysa veya belirtecin hesabında payment:basic:read yetkisine sahip bearer kimlik doğrulaması olmadan null.

> [accordion] Özellikler
>
> **city** `string | null` *required*
>
> Şehir.
>
> **country** `string | null` *required*
>
> ISO 3166-1 alpha-2 ülke kodu.
>
> **line1** `string | null` *required*
>
> Birinci sokak adresi satırı.
>
> **line2** `string | null` *required*
>
> İkinci sokak adresi satırı.
>
> **name** `string | null` *required*
>
> Adres üzerindeki ad.
>
> **postal\_code** `string | null` *required*
>
> Posta kodu.
>
> **state** `string | null` *required*
>
> Eyalet, il veya bölge.

**billing\_details** `object | null` *required*

Toplama sırasında sağlanan fatura önizlemesi: e-posta, ad, ülke ve posta kodu.

> [accordion] Özellikler
>
> **country** `string | null` *required*
>
> ISO 3166-1 alpha-2 ülke kodu.
>
> **email** `string | null` *required*
>
> Yöntem toplanırken sağlanan e-posta.
>
> **name** `string | null` *required*
>
> Ödeme yöntemi üzerindeki ad.
>
> **postal\_code** `string | null` *required*
>
> Posta kodu.

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

Belirtecin oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**expires\_at** `string` *required*

Belirtecin süresinin dolduğu zaman, ISO 8601 zaman damgası olarak. Belirteçler tek kullanımlık ve kısa ömürlüdür.

**object** `string` *required*

Her zaman `confirmation_token`.

**payment\_method\_preview** `object` *required*

Toplanan yöntemin yalnızca görüntüleme amaçlı önizlemesi — asla temeldeki belirteç değildir.

> [accordion] Özellikler
>
> **id** `string | null` *required*
>
> Bu önizlemenin geldiği kayıtlı ödeme yöntemi veya alıcı yeni bir yöntem sağladıysa `null`.
>
> **bank\_debit** `object`
>
> Kategori `bank_debit` olduğunda bulunur. Hesaptan ücret alınana kadar boştur.
>
> > [accordion] Özellikler
> >
> > **brand** `string`
> >
> > Küçük harfli kart markası, örneğin `visa` veya `mastercard`.
> >
> > **fingerprint** `string`
> >
> > Bu belirli kart numarasını benzersiz şekilde tanımlar. Bu belirteçten kaydedilen herhangi bir ödeme yöntemindeki `fingerprint` ile eşleşir, böylece bir kartı denemeler arasında tanıyabilirsiniz. Bir cüzdan için temeldeki kartı değil, ağ belirtecini tanımlar.
> >
> > **last4** `string`
> >
> > Kartın son dört hanesi.
>
> **card** `object`
>
> Kategori `card` olduğunda kartın ayrıntıları.
>
> > [accordion] Özellikler
> >
> > **brand** `string`
> >
> > Küçük harfli kart markası, örneğin `visa` veya `mastercard`.
> >
> > **fingerprint** `string`
> >
> > Bu belirli kart numarasını benzersiz şekilde tanımlar. Bu belirteçten kaydedilen herhangi bir ödeme yöntemindeki `fingerprint` ile eşleşir, böylece bir kartı denemeler arasında tanıyabilirsiniz. Bir cüzdan için temeldeki kartı değil, ağ belirtecini tanımlar.
> >
> > **last4** `string`
> >
> > Kartın son dört hanesi.
>
> **category** `string` *required*
>
> Türün ait olduğu aile.
>
> Kullanılabilir seçenekler: `card`, `wallet`, `bank_debit`, `bank_transfer`, `voucher`, `redirect`, `crypto`, `balance`, `in_app_purchase`, `card_present`, `saved`
>
> **display\_name** `string` *required*
>
> Yöntem için insan tarafından okunabilir etiket, örneğin `Visa •••• 4242`.
>
> **saved** `object`
>
> Kategori `saved` olduğunda kayıtlı kartın ayrıntıları. Bakiye için bulunmaz.
>
> > [accordion] Özellikler
> >
> > **brand** `string`
> >
> > Küçük harfli kart markası, örneğin `visa` veya `mastercard`.
> >
> > **fingerprint** `string`
> >
> > Bu belirli kart numarasını benzersiz şekilde tanımlar. Bu belirteçten kaydedilen herhangi bir ödeme yöntemindeki `fingerprint` ile eşleşir, böylece bir kartı denemeler arasında tanıyabilirsiniz. Bir cüzdan için temeldeki kartı değil, ağ belirtecini tanımlar.
> >
> > **last4** `string`
> >
> > Kartın son dört hanesi.
>
> **type** `string` *required*
>
> Ödeme yöntemi türü, örneğin `card`, `apple_pay`, `klarna`.
>
> **wallet** `object`
>
> Kategori `wallet` olduğunda cüzdanın sağladığı ağ belirtecinin ayrıntıları.
>
> > [accordion] Özellikler
> >
> > **brand** `string`
> >
> > Küçük harfli kart markası, örneğin `visa` veya `mastercard`.
> >
> > **fingerprint** `string`
> >
> > Bu belirli kart numarasını benzersiz şekilde tanımlar. Bu belirteçten kaydedilen herhangi bir ödeme yöntemindeki `fingerprint` ile eşleşir, böylece bir kartı denemeler arasında tanıyabilirsiniz. Bir cüzdan için temeldeki kartı değil, ağ belirtecini tanımlar.
> >
> > **last4** `string`
> >
> > Kartın son dört hanesi.

**setup\_future\_usage** `string | null` *required*

Öğenin toplama sırasında gösterdiği kaydetme onayı durumu: `off_session`, `on_session` veya `null`. Onaylama, yalnızca burada onaylanmışsa kasaya kaydedebilir.

**status** `string` *required*

Kullanılana kadar `pending`, ardından `consumed`; kısa ömrü dolduğunda `expired`. Yalnızca `pending` durumundaki bir belirteçle ücret alınabilir.

Kullanılabilir seçenekler: `pending`, `consumed`, `expired`

```json ConfirmationToken theme={null}
{
	"id": "ctok_xxxxxxxxxxxxxx",
	"object": "confirmation_token",
	"status": "pending",
	"payment_method_preview": {
		"id": null,
		"type": "card",
		"category": "card",
		"display_name": "Visa •••• 4242",
		"card": {
			"brand": "visa",
			"fingerprint": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
			"last4": "4242"
		}
	},
	"setup_future_usage": "off_session",
	"billing_details": {
		"email": "buyer@example.com",
		"name": "Buyer Name",
		"country": "US",
		"postal_code": "78701"
	},
	"billing_address": null,
	"created_at": "2026-08-28T12:00:00.000Z",
	"expires_at": "2026-08-28T12:15:00.000Z"
}
```


## Related topics

- [Takaslar API'si](https://docs.whop.com/tr/api-reference/swaps/swap.md)
- [Kurulum Amaçları API'si](https://docs.whop.com/tr/api-reference/setup-intents/setup-intent.md)
- [Deneyler API'si](https://docs.whop.com/tr/api-reference/experiments/experiment.md)
