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

# Tercih Edilen Mutabakat Para Birimi

> Her yeni satışı USD, EUR, GBP, CAD veya AUD'ye dönüştürün. Hangi satışların dönüştürüldüğünü ve iadelerin, itirazların ve platform ücretlerinin nasıl mutabakata girdiğini görün.

Tüm yeni gelirleri tek bir bakiyede toplamak için tercih edilen bir mutabakat para birimi ayarlayın. Whop, alıcı ödeme yaptığında her yeni satışı bu para birimine dönüştürür; böylece bir para çekmeden önce küçük bakiyeleri dönüştürmeniz gerekmez.

| | Orijinal para birimi (varsayılan) | Tercih edilen mutabakat para birimi |
| - | - | - |
| **Satışın mutabakata girdiği yer** | Planın para birimindeki bir bakiye | Seçtiğiniz para birimindeki bir bakiye |
| **Yönetilecek bakiyeler** | Her plan para birimi için bir tane | Bir tane |
| **Ek ücret** | Yok | Dönüştürülen her satışta %0,5 |

## Bir para birimi seçin

> [tab] Kontrol paneli
>
> 1. Kontrol paneli ayarlarınızda **Payments** seçeneğini seçin.
> 2. **Preferred settlement currency** altında, **Settle every new sale in** alanından bir para birimi seçin.
> 3. **Save changes** seçeneğini seçin.

> [tab] API
>
> [Hesap Tercihlerini Güncelle](https://docs.whop.com/tr/api-reference/accounts/update-account-preferences.md) uç noktasına küçük harfli bir para birimi kodu gönderin. Ayarı kapatmak için `null` gönderin.
>
> ```typescript TypeScript theme={null}
> import { WhopClient } from "@whop/sdk";
>
> const client = new WhopClient({ token: process.env.WHOP_API_KEY });
>
> const preferences = await client.accounts.preferences.update({
> 	account_id: "biz_xxxxxxxxxxxxx",
> 	preferred_settlement_currency: "usd",
> });
>
> console.log(preferences.preferred_settlement_currency_changeable_at);
> ```
>
> ```python Python theme={null}
> import os
>
> from whop_sdk import Whop
>
> client = Whop(token=os.environ["WHOP_API_KEY"])
>
> preferences = client.accounts.preferences.update(
>     account_id="biz_xxxxxxxxxxxxx",
>     preferred_settlement_currency="usd",
> )
>
> print(preferences.preferred_settlement_currency_changeable_at)
> ```
>
> ```ruby Ruby theme={null}
> require "whop_sdk"
>
> client = Whop_sdk::Client.new(token: ENV.fetch("WHOP_API_KEY"))
>
> preferences = client.accounts.preferences.update(
>   account_id: "biz_xxxxxxxxxxxxx",
>   preferred_settlement_currency: "usd"
> )
>
> puts preferences.preferred_settlement_currency_changeable_at
> ```
>
> ```bash cURL theme={null}
> curl -X PATCH "https://api.whop.com/api/v1/accounts/biz_xxxxxxxxxxxxx/preferences" \
>   -H "Authorization: Bearer $WHOP_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "preferred_settlement_currency": "usd" }'
> ```
>
> Yanıt, hesabın tercihlerini döndürür:
>
> ```json theme={null}
> {
> 	"preferred_settlement_currency": "usd",
> 	"preferred_settlement_currency_changeable_at": "2026-10-22T14:03:11.000Z"
> }
> ```

Bir değişiklik yalnızca yeni satışlara uygulanır. Bakiyelerinizde zaten bulunan para kendi para biriminde kalır.

## Hangi satışların dönüştürüldüğünü bilin

Bir satış, planının para birimi tercih ettiğiniz para birimi olmadığında dönüştürülür. Alıcının ödeme yaptığı para birimi bunu değiştirmez.

Şu satışlar hiçbir zaman dönüştürülmez:

* Zaten tercih ettiğiniz para biriminde olan planlardaki satışlar.
* App Store satın almaları. Apple bunları USD olarak öder.
* Bağladığınız bir Stripe hesabı üzerinden yapılan satışlar gibi Whop bakiyeniz dışında mutabakata giren satışlar.

Whop, döviz kurunu alıcı ödeme yaptığında belirler ve ödemenin üzerinde saklar. Ayarın alıcı üzerinde hiçbir etkisi yoktur. Alıcı ödeme sayfasında gösterilen fiyatı öder ve makbuz bu tutarı gösterir.

## Ücret yapısı

Dönüştürülen her satış için %0,5 ücret alınır. Olağan ücretleriniz de geçerlidir. Ödeme, %0,5'i **Currency conversion** satırında gösterir.

Alıcı planın para biriminden farklı bir para biriminde ödeme yaptığında Whop %0,5 ücret almaz. [Uyarlanabilir fiyatlandırma](https://docs.whop.com/tr/payments-and-billing/fees/adaptive-pricing.md) bu dönüşüm için ödeme sayfasında zaten ücret alır.

Bu örnekler tercih edilen para birimi olarak USD kullanır:

| Plan para birimi | Alıcının ödediği | Mutabakat para birimi | %0,5 ücret |
| - | - | - | - |
| USD | USD veya EUR | USD | Hayır. Plan zaten USD cinsinden. |
| GBP | GBP | USD | Evet |
| GBP | EUR veya USD | USD | Hayır. Alıcı başka bir para biriminde ödedi. |
| MXN | MXN | USD | Evet |
| GBP, App Store | GBP | USD | Hayır. Apple USD olarak öder. |

## İadeler ve itirazlar

Bir iade veya itiraz, satışın mutabakata girdiği bakiyeden düşülür.

* **İadeler** ödemenin üzerinde saklanan döviz kurunu kullanır. Satıştan sonraki bir kur değişikliği tutarı değiştirmez.
* **İtirazlar** itirazın açıldığı gündeki döviz kurunu kullanır. Tutar, dönüştürülen satıştan farklı olabilir.

## Platformlar ve alt hesaplar

Ayar yalnızca onu belirleyen hesaba uygulanır. Bir alt hesap platformunun ayarını almaz, bir platform da alt hesaplarının ayarlarını almaz.

Uygulama ücretleriniz sizin ayarınızı izler. Whop her ücreti, satış günündeki döviz kurundan sizin para biriminize dönüştürür. Alt hesabın payı alt hesabın ayarını izler.

Whop, dönüştürülen bir uygulama ücreti için sizden %0,5 alır. Satışın planı zaten sizin para biriminizdeyse Whop %0,5 ücret almaz.

## Bir ödemedeki tutarları okuyun

Bir [ödeme](https://docs.whop.com/tr/api-reference/payments/payment), tutarları iki para biriminde verir. Her tutar kendi `currency` değerini içerir.

| Alanlar | Para birimi | Kullanım amacı |
| - | - | - |
| `total`, `subtotal`, `tax_amount`, `refunded_amount`, `amount_after_fees` | Mutabakat para birimi | Bakiyeler, para çekmeler ve defter mutabakatı |
| `presentment_total`, `presentment_tax_amount`, `presentment_refunded_amount` | Alıcının ödeme yaptığı para birimi | Sipariş toplamları, makbuzlar ve müşteri e-postaları |

Bir ödemeyi sisteminizdeki bir siparişle eşleştirmek için `presentment_total` değerini karşılaştırın. Ayar bunu değiştirmez. `presentment_total` alıcı ücretlerini içermez. [Ödeme webhook'ları](https://docs.whop.com/tr/developer/guides/webhooks.md) aynı alanları gönderir.

## Sonraki adımlar

> [card] [Hesap Tercihleri referansı](https://docs.whop.com/tr/api-reference/accounts/update-account-preferences.md)
>
> Her tercih alanı ve her birinin gerektirdiği kapsam.

> [card] [Uyarlanabilir fiyatlandırma](https://docs.whop.com/tr/payments-and-billing/fees/adaptive-pricing.md)
>
> Alıcılara ödeme sayfasında fiyatları kendi yerel para birimlerinde gösterin.


## Related topics

- [Para Çekmeler ve Para Hareketi](https://docs.whop.com/tr/developer/payouts/overview.md)
- [Transferler API'si](https://docs.whop.com/tr/api-reference/transfers/transfer.md)
- [İstatistikler API Referansı](https://docs.whop.com/tr/api-reference/stats/stats.md)
