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

# Kartlar API'si

> Kartlar, bir hesap veya kullanıcı bakiyesinden harcama yapan sanal ödeme kartlarını temsil eder.

Kartlar kart sahiplerine atanabilir ve kontrollü harcama için harcama limitleriyle yapılandırılabilir.

Kartlar API'sini kart çıkarmak, bir hesap veya kullanıcı için kartları listelemek, kart numarası ve CVC gibi etkin kart ayrıntılarını almak ve kartlarla yapılan işlemleri listelemek için kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Kart İşlemlerini Listele](https://docs.whop.com/tr/api-reference/cards/list-card-transactions.md) | GET `/card_transactions` |
| [Kart İşlemini Al](https://docs.whop.com/tr/api-reference/cards/retrieve-card-transaction.md) | GET `/card_transactions/{id}` |
| [Kartları Listele](https://docs.whop.com/tr/api-reference/cards/list-cards.md) | GET `/cards` |
| [Kartı Al](https://docs.whop.com/tr/api-reference/cards/retrieve-card.md) | GET `/cards/{id}` |
| [Kart Oluştur](https://docs.whop.com/tr/api-reference/cards/create-card.md) | POST `/cards` |
| [Kartı Güncelle](https://docs.whop.com/tr/api-reference/cards/update-card.md) | PATCH `/cards/{id}` |

## Öznitelikler

**id** `string` *required*

`icrd_` önekli kart kimliği.

**billing** `object | null` *required*

Fatura adresi.

> [accordion] Özellikler
>
> **city** `string | null` *required*
>
> Fatura şehri.
>
> **country\_code** `string | null` *required*
>
> Fatura ülke kodu.
>
> **line1** `string | null` *required*
>
> Sokak adresi satır 1.
>
> **line2** `string | null` *required*
>
> Sokak adresi satır 2.
>
> **postal\_code** `string | null` *required*
>
> Fatura posta kodu.
>
> **region** `string | null` *required*
>
> Fatura bölgesi veya eyaleti.

**canceled\_at** `string | null` *required*

Kartın iptal edildiği zaman.

**created\_at** `string | null` *required*

Kartın oluşturulduğu zaman.

**digital\_wallets** `string[] | null` *required*

Kartın eklendiği dijital cüzdanlar. Kartları Listele, Kartı Güncelle ve webhook yükleri `null` döndürür; cüzdanlar alınamadığında Kartı Al da aynısını yapar.

Kullanılabilir seçenekler: `apple_pay`, `google_pay`

**expiration\_month** `string | null` *required*

Kartın son kullanma ayı.

**expiration\_year** `string | null` *required*

Kartın son kullanma yılı.

**issued** `boolean` *required*

Kartı çıkaran kuruluş kartı çıkardığında `true`. Kart sahibinin kayıt veya inceleme sürecini hâlâ bekleyen davet edilmiş bir kart ya da kartı çıkaran kuruluşun reddettiği bir kart için `false`; kart çıkarılana kadar kart numarası yoktur.

**last4** `string | null` *required*

Kart numarasının son dört hanesi. Bekleyen davet kartları için `null`.

**limit** `object | null` *required*

Harcama limiti yapılandırması.

> [accordion] Özellikler
>
> **amount** `number` *required*
>
> Dolar cinsinden limit tutarı.
>
> **frequency** `string` *required*
>
> Limit tutarının uygulandığı zaman aralığı. `per_transaction` her bir yetkilendirmeyi ayrı ayrı sınırlar ve `transaction_limit` ile ayarlanan bir limitin bildirdiği değerdir.
>
> Kullanılabilir seçenekler: `daily`, `weekly`, `monthly`, `one_time`, `per_transaction`

**name** `string | null` *required*

Kartın görünen adı.

**object** `string` *required*

**secrets** `object | null`

Hassas kart ayrıntıları. Yalnızca etkin kartlar için `GET /cards/:id` üzerinde bulunur; kart etkin değilse veya ayrıntılar alınamazsa `null`.

> [accordion] Özellikler
>
> **card\_number** `string` *required*
>
> Tam kart numarası.
>
> **cvc** `string` *required*
>
> Kart doğrulama kodu.
>
> **name\_on\_card** `string | null` *required*
>
> Kartın üzerinde basılı kart sahibi adı.
>
> **pin** `string | null` *required*
>
> Kart PIN'i. Yalnızca istek, kartın atandığı kullanıcı olarak kimlik doğrulaması yapıldığında döndürülür; hesap API anahtarları dahil diğer tüm çağıranlar için `null`.

**spent\_last\_month** `integer | null` *required*

Son 30 gündeki toplam harcama, sent cinsinden.

**status** `string | null` *required*

Kart durumu. `denied`, kartı çıkaran kuruluşun kart sahibini reddettiği ve dolayısıyla kartın hiçbir zaman çıkarılmayacağı anlamına gelir.

Kullanılabilir seçenekler: `active`, `frozen`, `canceled`, `invited`, `denied`

**type** `string | null` *required*

Kart türü.

Kullanılabilir seçenekler: `virtual`, `physical`

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

Atandığında, `user_` önekli kart sahibi kullanıcı kimliği.

```json Card theme={null}
{
	"id": "icrd_xxxxxxxxxxxxx",
	"billing": {
		"city": "New York",
		"country_code": "US",
		"line1": "123 Spring Street",
		"line2": "Suite 4",
		"postal_code": "10012",
		"region": "NY"
	},
	"canceled_at": null,
	"created_at": "2026-06-01T12:00:00Z",
	"digital_wallets": ["apple_pay"],
	"expiration_month": "12",
	"expiration_year": "2029",
	"issued": true,
	"last4": "4242",
	"limit": {
		"amount": 500,
		"frequency": "daily"
	},
	"name": "Operations Card",
	"object": "card",
	"secrets": {
		"card_number": "4242424242424242",
		"cvc": "123",
		"name_on_card": "Pickaxe Operations",
		"pin": "1234"
	},
	"spent_last_month": 12500,
	"status": "active",
	"type": "virtual",
	"user_id": "user_xxxxxxxxxxxxx"
}
```


## Related topics

- [Deneyler API'si](https://docs.whop.com/tr/api-reference/experiments/experiment.md)
- [Kanallar API'si](https://docs.whop.com/tr/api-reference/channels/channel.md)
- [İşlemler API'si](https://docs.whop.com/tr/api-reference/trades/trade.md)
