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

# Payment Rules API

> Payment Rule, bir hesabın kendi ödemeleri bankaya ulaşmadan önce onlar üzerinde işlem yapmasını sağlar: onları engellemek, geçmelerine izin vermek, incelemeye göndermek veya alıcıdan 3D Secure istemek.

Her kural küçük bir ödeme özellikleri kümesiyle eşleşir ve uygulanması için her koşulun sağlanması gerekir.

Bir kuralın tanımı oluşturulduktan sonra sabittir, böylece karar verdiği ödemeler, onlara karar veren kuralı adlandırmaya devam eder. Birini değiştirmek için [Replace](https://docs.whop.com/tr/api-reference/payment-rules/replace-a-payment-rule.md), bir koşulun kullanabileceği özellikler, operatörler ve değerler için [List fields](https://docs.whop.com/tr/api-reference/payment-rules/list-fields.md) kullanın.

Dolandırıcılığı azaltmak için ödeme işlemlerini engelleme, inceleme, doğrulama isteme ve bunlara izin verme konusunda adım adım bir anlatım için [Manage Fraud](https://docs.whop.com/tr/developer/guides/manage-fraud.md) kılavuzunu okuyun.

> [!WARNING]
>
> Bir `review` kuralı, eski gömülü yerleşimleri tahsilata kadar **Processing** durumunda bırakabilir. Otomatik tahsilat, yetkilendirmeden 48 saat sonrasına planlanır, ancak tamamlanması daha uzun sürebilir veya başarısız olabilir. İnceleme kuralları hesap genelindedir ve eski gömülü yerleşimlere de uygulanır. Bunları etkinleştirmeden önce [inceleme bekletme uygunluğu ve ödeme sayfası sınırlamalarına](https://docs.whop.com/tr/developer/guides/manage-fraud.md#review-a-payment-before-charging-it) bakın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [List payment rules](https://docs.whop.com/tr/api-reference/payment-rules/list-payment-rules.md) | GET `/payment_rules` |
| [Retrieve a payment rule](https://docs.whop.com/tr/api-reference/payment-rules/retrieve-a-payment-rule.md) | GET `/payment_rules/{id}` |
| [List fields](https://docs.whop.com/tr/api-reference/payment-rules/list-fields.md) | GET `/payment_rules/fields` |
| [Create a payment rule](https://docs.whop.com/tr/api-reference/payment-rules/create-a-payment-rule.md) | POST `/payment_rules` |
| [Activate a payment rule](https://docs.whop.com/tr/api-reference/payment-rules/activate-a-payment-rule.md) | POST `/payment_rules/{id}/activate` |
| [Deactivate a payment rule](https://docs.whop.com/tr/api-reference/payment-rules/deactivate-a-payment-rule.md) | POST `/payment_rules/{id}/deactivate` |
| [Replace a payment rule](https://docs.whop.com/tr/api-reference/payment-rules/replace-a-payment-rule.md) | POST `/payment_rules/{id}/replace` |
| [Update a payment rule](https://docs.whop.com/tr/api-reference/payment-rules/update-a-payment-rule.md) | PATCH `/payment_rules/{id}` |
| [Delete a payment rule](https://docs.whop.com/tr/api-reference/payment-rules/delete-a-payment-rule.md) | DELETE `/payment_rules/{id}` |

## Özellikler

**id** `string` *required*

`prule_` önekli ödeme kuralı kimliği.

**account\_id** `string` *required*

`biz_` önekli hesap kimliği.

**action** `string` *required*

Her koşul eşleştiğinde bu hesabın kuralının talep ettiği şey. Uygulanabilir tek bir hesap kuralı eylemi şu sırayla kazanır: `allow`, `block`, `review`, `enforce_3ds`. Bir `allow`, bu hesabın diğer kurallarını geçersiz kılar, ancak Whop'un kendi dolandırıcılık kontrollerini asla geçersiz kılmaz. Bir `review`, Whop Payments üzerinden uygun bir oturum içi kart ödemesi için tahsilat olmadan yetkilendirme talep eder. Otomatik tahsilat, yetkilendirmeden 48 saat sonrasına planlanır; daha erken karar vermek için ödemeyi bundan önce tahsil edin veya iptal edin. Tahsilat daha sonra tamamlanabilir veya başarısız olabilir. İnceleme; desteklenmeyen yöntemler, oturum dışı ödemeler ve zaten manuel tahsilat için yapılandırılmış ödemeler için atlanır. Hesap kuralı bir doğrulama uygulayamadığında `enforce_3ds` atlanır. Diğer 3DS gereksinimleri yine de geçerlidir.

Kullanılabilir seçenekler: `allow`, `block`, `review`, `enforce_3ds`

**conditions** `object` *required*

Bir ödemenin karşılaştırıldığı koşullar. En fazla 10 koşul ve serileştirildiğinde 8 KiB.

> [accordion] Özellikler
>
> **all** `object[]` *required*
>
> Kuralın uygulanması için hepsinin eşleşmesi gereken koşullar. Kuralın okuyamadığı bir ödeme özelliği eşleşmez.
>
> > [accordion] Özellikler
> >
> > **field** `string` *required*
> >
> > Bu koşulun okuduğu ödeme özelliği.
> >
> > Kullanılabilir seçenekler: `risk_score`, `amount_in_usd`, `card_country`, `card_brand`, `card_funding`, `card_bin`, `billing_country`, `billing_postal_code`, `billing_city`, `customer_email`, `email_domain`, `ip_address`, `ip_country`
> >
> > **operator** `string` *required*
> >
> > Ödeme özelliğinin değerle nasıl karşılaştırıldığı.
> >
> > Kullanılabilir seçenekler: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `in`, `not_in`, `starts_with`, `contains`, `ends_with`, `in_cidr`
> >
> > **value** `number or string or string[]` *required*
> >
> > Karşılaştırılacak değer.

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

Kuralın oluşturulma zamanı, ISO 8601 zaman damgası olarak.

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

Kuralın silinme zamanı, ISO 8601 zaman damgası olarak. `status` değeri `deleted` olmadıkça `null`.

**metadata** `object` *required*

Entegrasyonunuz için özel dizeden dizeye değerler. En fazla 50 anahtar, anahtar başına 40 karakter, değer başına 500 karakter.

**name** `string` *required*

Bu kural için bir ad. En fazla 255 karakter.

**status** `string` *required*

Kuralın ödemelere uygulanıp uygulanmadığı. `deleted` bir kural, zaten karar verdiği ödemeler onu adlandırmaya devam etsin diye saklanır.

Kullanılabilir seçenekler: `active`, `inactive`, `deleted`

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

Kuralın son değiştiği zaman, ISO 8601 zaman damgası olarak.

```json PaymentRule theme={null}
{
	"id": "prule_xxxxxxxxxxxxx",
	"account_id": "biz_xxxxxxxxxxxxxx",
	"name": "Block high-risk cards from outside the US",
	"status": "active",
	"action": "block",
	"conditions": {
		"all": [
			{
				"field": "risk_score",
				"operator": "gte",
				"value": 85
			},
			{
				"field": "card_country",
				"operator": "neq",
				"value": "US"
			}
		]
	},
	"metadata": {},
	"created_at": "2026-09-01T12:00:00.000Z",
	"updated_at": "2026-09-01T12:00:00.000Z",
	"deleted_at": null
}
```


## Related topics

- [Delete a Payment Rule](https://docs.whop.com/tr/api-reference/payment-rules/delete-a-payment-rule.md)
- [Update a Payment Rule](https://docs.whop.com/tr/api-reference/payment-rules/update-a-payment-rule.md)
- [Activate a Payment Rule](https://docs.whop.com/tr/api-reference/payment-rules/activate-a-payment-rule.md)
