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

# Nakit İade Kuralları API'si

> Nakit İade Kuralı, bir platformun doğrudan alt hesaplarına kart harcamalarının bir payını geri öder; bu ödeme platform tarafından finanse edilir.

Her kural bir oran, bir uygunluk penceresi ve isteğe bağlı satıcı filtreleri belirler ve tek bir alt hesapla sınırlandırılabilir.

Nakit İade Kuralları API'sini platformunuzun finanse ettiği kuralları oluşturmak, güncellemek ve listelemek, ardından kullanılabilir USD bakiyenizden isteğe bağlı olarak nakit iade ödemesi yapmak için kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Nakit İade Kurallarını Listele](https://docs.whop.com/tr/api-reference/cashback-rules/list-cashback-rules.md) | GET `/cashback_rules` |
| [Nakit İade Kuralı Oluştur](https://docs.whop.com/tr/api-reference/cashback-rules/create-cashback-rule.md) | POST `/cashback_rule` |
| [Nakit İadesi Öde](https://docs.whop.com/tr/api-reference/cashback-rules/pay-out-cashback.md) | POST `/cashback_rules/payout` |
| [Nakit İade Kuralını Güncelle](https://docs.whop.com/tr/api-reference/cashback-rules/update-cashback-rule.md) | PATCH `/cashback_rules/{id}` |

## Nakit iadesi ödeme

Uygun tüm nakit iadelerini dağıtmak için `POST /cashback_rules/payout` adresine boş bir nesne gönderin. Tek bir kuralı dağıtmak için `cashback_rule_id`, tek bir alt hesaba ödeme yapmak için `account_id` veya tek bir kart işlemine ödeme yapmak için `transaction_id` ayarlayın. Birden fazla filtrenin tümü eşleşmelidir.

```json theme={null}
{
	"cashback_rule_id": "cicbr_7kR2m9Qx4L",
	"account_id": "biz_connectedDemo",
	"transaction_id": "citx_8jF6w3Nv2B"
}
```

Ödeme talep ederken bir `Idempotency-Key` başlığı kullanın. `status: "processing"` içeren bir `202` yanıtı, işlemenin kuyruğa alındığını onaylar ve sağlanan filtreleri geri yansıtır. `status: "failed"` içeren bir `200` yanıtı, kuyruğun isteği reddettiği anlamına gelir. Bu durumlar ödemenin tamamlanmasını değil, zamanlamayı açıklar. İşlem görevleri hataları otomatik olarak yeniden dener. Fonlama cüzdanında yeterli bakiye yoksa cüzdana USD ekleyin. Tekrarlanan istekler zaten kaydedilmiş ödemeleri atlar ve defter idempotency'si yinelenen alacak kayıtlarını önler.

Yanıt:

```json theme={null}
{
	"status": "processing",
	"cashback_rule_id": "cicbr_7kR2m9Qx4L",
	"account_id": "biz_connectedDemo",
	"transaction_id": "citx_8jF6w3Nv2B"
}
```

## Öznitelikler

**id** `string` *required*

`cicbr_` önekli nakit iade kuralı kimliği.

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

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

**description** `string | null` *required*

Nakit iade kuralının isteğe bağlı açıklaması.

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

Kuralın kaldırıldığı zaman, ISO 8601 zaman damgası olarak. Null, kaldırılmadığı anlamına gelir.

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

Uygunluk penceresinin hariç tutulan bitişi, ISO 8601 zaman damgası olarak. Null, sona erme olmadığı anlamına gelir.

**funding\_account\_id** `string` *required*

Nakit iadesini finanse etmek üzere belirlenen `biz_` önekli platform hesabı. Kimliği doğrulanmış kimlik bilgisinden türetilir.

**merchant\_category\_code** `string | null` *required*

Dört haneli satıcı kategori kodu. Null her MCC ile eşleşir. Her iki satıcı filtresi de null olduğunda scoped\_account\_id zorunludur.

**merchant\_name** `string | null` *required*

Kart sağlayıcısı tarafından bildirilen ham satıcı adı. Null her satıcı adıyla eşleşir. Ayarlandığında herhangi bir MCC filtresiyle birlikte eşleşir; alt dize veya zenginleştirilmiş görünen ad eşleşmesi değildir.

**rate\_bps** `integer` *required*

Baz puan cinsinden nakit iade oranı. 100, %1 ve 10000, %100 anlamına gelir.

**scoped\_account\_id** `string | null` *required*

`biz_` önekli alt hesap kimliği. Null, fonlayan platformun tüm doğrudan alt hesaplarını belirtir.

**starts\_at** `string` *required*

Kuralın uygunluk penceresinin dahil edilen başlangıcı, ISO 8601 zaman damgası olarak.

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

Kuralın son güncellendiği zaman, ISO 8601 zaman damgası olarak.

```json CashbackRule theme={null}
{
	"id": "cicbr_a1B2c3D4e5F6g",
	"merchant_name": "ACME SOFTWARE",
	"merchant_category_code": "5734",
	"rate_bps": 500,
	"description": "Software cashback",
	"funding_account_id": "biz_a1B2c3D4e5F6g",
	"scoped_account_id": "biz_h7I8j9K0l1M2n",
	"starts_at": "2026-10-01T00:00:00.000Z",
	"expires_at": "2026-11-01T00:00:00.000Z",
	"discarded_at": null,
	"created_at": "2026-09-10T08:00:00.000Z",
	"updated_at": "2026-09-10T08:00:00.000Z"
}
```


## Related topics

- [API Kararlılığı](https://docs.whop.com/tr/api-reference/stability.md)
- [İadeler API'si](https://docs.whop.com/tr/api-reference/refunds/refund.md)
- [İtiraz Uyarıları API'si](https://docs.whop.com/tr/api-reference/dispute-alerts/dispute-alert.md)
