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

# Payouts API

> Payout'lar, bir hesap veya kullanıcı bakiyesinden banka hesabı, cüzdan veya kayıtlı başka bir ödeme alma yöntemi gibi harici bir hedefe gönderilen parayı temsil eder.

Payout'ları oluşturmak ve takip etmek, kayıtlı ödeme alma yöntemlerini yönetmek ve Whop'tan çıkan fonlar için beklenen varış ayrıntılarını göstermek üzere Payouts API'yi kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [List Payouts](https://docs.whop.com/tr/api-reference/payouts/list-payouts.md) | GET `/payouts` |
| [Retrieve Payout](https://docs.whop.com/tr/api-reference/payouts/retrieve-payout.md) | GET `/payouts/{id}` |
| [List Saved Payout Methods](https://docs.whop.com/tr/api-reference/payouts/list-saved-payout-methods.md) | GET `/payouts/methods` |
| [List Supported Payout Methods](https://docs.whop.com/tr/api-reference/payouts/list-supported-payout-methods.md) | GET `/payouts/supported_methods` |
| [Create Payout](https://docs.whop.com/tr/api-reference/payouts/create-payout.md) | POST `/payouts` |
| [Cancel Payout](https://docs.whop.com/tr/api-reference/payouts/cancel-payout.md) | POST `/payouts/{id}/cancel` |
| [Create Saved Payout Method](https://docs.whop.com/tr/api-reference/payouts/create-saved-payout-method.md) | POST `/payouts/methods` |
| [Create PayPal Link Session](https://docs.whop.com/tr/api-reference/payouts/create-paypal-link-session.md) | POST `/payouts/paypal_link_sessions` |
| [Create Payout Quote](https://docs.whop.com/tr/api-reference/payouts/create-payout-quote.md) | POST `/payouts/quotes` |
| [Update Saved Payout Method](https://docs.whop.com/tr/api-reference/payouts/update-saved-payout-method.md) | PATCH `/payouts/methods/{id}` |
| [Delete Saved Payout Method](https://docs.whop.com/tr/api-reference/payouts/delete-saved-payout-method.md) | DELETE `/payouts/methods/{id}` |

## Özellikler

**id** `string` *required*

`wdrl_` önekli payout kimliği.

**amount** `string` *required*

Tam para birimi cinsinden payout tutarı, ondalık dize olarak.

**cancelable** `boolean` *required*

`POST /payouts/\{id}/cancel` isteğinin şu anda bu payout üzerinde işlem yapıp yapmayacağı: `in_review` durumundayken, ödeme sağlayıcısına henüz hiçbir şey gönderilmemiş şekilde `processing` durumundayken veya gönderilmiş bir payout'un sağlayıcıda hâlâ iptal edilmesi istenebildiği sürece `true`. Para ulaştığında veya payout zaten sona erdiğinde `false`.

**conversion** `object | null` *required*

Payout gönderilmeden önce bakiyenin payout para birimine nasıl dönüştürüldüğü. Payout kendi para birimindeki bir bakiyeden gönderildiğinde `null`.

> [accordion] Özellikler
>
> **from\_amount** `string` *required*
>
> Dönüştürmenin bakiyeden aldığı tutar, ondalık dize olarak.
>
> **from\_currency** `string` *required*
>
> Dönüştürmenin tutarı aldığı bakiyenin para birimi.
>
> **rate** `number` *required*
>
> Her bir `from_currency` birimi için payout para birimi cinsinden dönüştürme oranı. Herhangi bir dönüştürme ücreti bu orana dahildir.

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

Payout'un oluşturulma zamanı.

**currency** `string` *required*

Payout para birimi.

**destination\_amount** `string | null` *required*

Hedef para birimi cinsinden teslim edilen tutar, ondalık dize olarak. Payout işlendiğinde atanır, bu nedenle o zamandan önce ve kayıtlı dönüştürmesi olmayan payout'larda `null`.

**destination\_currency** `string | null` *required*

Fonların teslim edildiği para birimi; payout oluşturulduğunda payout yönteminden alınır. Bir dönüştürme talebiyle finanse edilen bir payout'ta, yanında oluşturulan kesinleşme payout'unu izler — bu payout'un kimliğini `payout_request_id` olarak taşıyan `GET /payouts` satırı — ve yalnızca kesinleşme payout'u olmadığında `null` olur.

**estimated\_arrival** `string | null` *required*

Fonların hedef hesapta kullanılabilir hale geleceği tahmini zaman.

**exchange\_rate** `number | null` *required*

Payout para biriminden hedef para birimine döviz kuru. Payout işlendiğinde atanır, bu nedenle o zamandan önce ve kayıtlı kuru olmayan payout'larda `null`.

**failure** `object | null` *required*

Payout'un neden ödeme yapmadan sona erdiği veya kesinleşmeden sonra neden geri çevrildiği. Başarısız, iptal edilmiş, reddedilmiş ve geri çevrilmiş payout'larda bulunur; aksi halde `null`.

> [accordion] Özellikler
>
> **code** `string | null` *required*
>
> Bakımı yapılan hata kataloğundan sınıflandırılmış hata kodu.
>
> **funds\_returned\_at** `string | null` *required*
>
> Fonları bakiyeye geri koyan geri çevirmenin geçerlilik zamanı — fonlar hiç çıkmadıysa veya henüz geri dönmediyse `null`. Yalnızca dönüş defterde onaylandığında ayarlanır; defter kaydının kendisi bu zamandan birkaç dakika sonra gerçekleşebilir.
>
> **message** `string | null` *required*
>
> Hatanın insan tarafından okunabilir açıklaması. `payout:destination:read` iznine sahip çağıranlar hedefe göre kişiselleştirilmiş metin alabilir; diğer çağıranlar genel katalog mesajını alır.

**fee\_amount** `string` *required*

Payout için alınan ücret, payout para birimi cinsinden, ondalık dize olarak.

**fee\_paid\_by** `string` *required*

Payout ücretini kimin üstlendiği: hesabın kendisi veya üst platformu.

Kullanılabilir seçenekler: `self`, `platform`

**markup\_fee** `string` *required*

Whop'un sağlayıcı ücreti üzerindeki marjı, payout para birimi cinsinden, ondalık dize olarak. Hiçbiri uygulanmadığında `"0.0"`.

**metadata** `object` *required*

Oluşturma sırasında eklenen ve her okumada geri döndürülen anahtar-değer verileri. En fazla 50 anahtar, en fazla 40 karakterlik anahtar adları, en fazla 500 karakterlik dize değerleri.

**net\_amount** `string` *required*

Payout para birimi cinsinden hedef için planlanan net tutar: fee\_paid\_by `self` olduğunda amount eksi fee\_amount eksi markup\_fee; platform ücretleri karşıladığında amount değerine eşit. Reddedilmiş, iptal edilmiş veya başarısız olarak sona eren bir payout hiçbir şey teslim etmemiştir — çoğu planlanan rakamı korur ve `failure` fonların nerede olduğunu söyler, ancak bir dönüştürme talebiyle finanse edilen iptal edilmiş bir payout bunun yerine kesinleşmiş sonucu bildirebilir: `amount` bakiyede kalanı taşır, hiçbiri alınmadığı için ücretler sıfırdır ve hiçbir şey teslim edilmediği için `net_amount` 0'dır.

**notes** `string | null` *required*

Payout'u oluşturanın eklediği serbest biçimli notlar veya hiçbiri sağlanmadığında `null`. En fazla 255 karakter.

**object** `string` *required*

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

Payout'u işleyen kuruluşun adı.

**payout\_method** `object | null` *required*

Kullanılan kayıtlı payout yöntemi. payout:destination:read gerektirir; bu izin olmadan null.

> [accordion] Özellikler
>
> **nickname** `string | null` *required*
>
> Kayıtlı payout yöntemi takma adı.
>
> **supported\_payout\_method** `object | null` *required*
>
> Desteklenen payout yöntemi görüntüleme ayrıntıları.
>
> > [accordion] Özellikler
> >
> > **delivery\_type** `string` *required*
> >
> > Fonların alıcıya nasıl teslim edildiği.
> >
> > Kullanılabilir seçenekler: `cash_pickup`, `bank_deposit`, `home_delivery`, `mobile_wallet`, `card`, `check`, `bill`, `cryptocurrency`, `unknown`
> >
> > **icon\_url** `string | null` *required*
> >
> > Desteklenen payout yöntemi simge URL'si.
> >
> > **payer\_name** `string | null` *required*
> >
> > Desteklenen payout yöntemi görünen adı.
>
> **type** `string` *required*
>
> Payout'un kullandığı payout yöntemi türü. `external` fonları Whop dışına gönderdi. `whop_card` fonları hesabın kendi Whop Card'ına aktardı.
>
> Kullanılabilir seçenekler: `external`, `whop_card`

**payout\_request\_id** `string | null` *required*

`POST /payouts` tarafından döndürülen `cofr_` önekli payout talebi kimliği. `GET /payouts` içindeki kesinleşmiş payout ile eşleştirin. `POST /payouts` ile oluşturulmamış payout'lar için `null` döndürür.

**source** `string | null` *required*

Payout'un nasıl oluşturulduğu. `automatic` planlanmış bir otomatik payout anlamına gelir. Payout'un kayıtlı bir kaynağı olmadığında `null`.

Kullanılabilir seçenekler: `api`, `dashboard`, `automatic`

**speed** `string` *required*

Payout teslimat hızı.

Kullanılabilir seçenekler: `standard`, `instant`

**statement\_descriptor** `string | null` *required*

Payout ile gönderilen ödeme açıklaması veya hiçbir tanımlayıcı ayarlanmadıysa `null`. Ayarlandığında 5-80 yazdırılabilir ASCII karakteri.

**status** `string` *required*

Güncel payout durumu.

Kullanılabilir seçenekler: `requested`, `in_review`, `processing`, `completed`, `reversed`, `canceled`, `failed`, `denied`

**status\_detail** `string` *required*

`status` altındaki en ayrıntılı makine aşaması — örneğin `processing` altında `awaiting_provider_acceptance` ile `in_transit` karşılaştırması veya `requested` altındaki dönüştürme aşaması. Bilgilendirici sözcük dağarcığı: değerler sürüm artışı olmadan eklenebilir; sürümlü sözleşme `status` değeridir.

**trace\_code** `string | null` *required*

Bu payout için ödeme ağı referansı, örneğin bir ACH izleme numarası, bir RTP veya FedNow uçtan uca kimliği, bir havale IMAD'ı veya bir SWIFT UETR. Referans kullanılabilir olana kadar ve referansı olmayan payout'larda `null`.

```json Payout theme={null}
{
	"id": "wdrl_xxxxxxxxxxxxx",
	"amount": "125.5",
	"cancelable": false,
	"conversion": null,
	"created_at": "2026-06-01T12:00:00Z",
	"currency": "usd",
	"destination_amount": "115.89",
	"destination_currency": "eur",
	"estimated_arrival": "2026-06-03T12:00:00Z",
	"exchange_rate": 0.9234,
	"failure": null,
	"fee_amount": "1.25",
	"fee_paid_by": "self",
	"markup_fee": "0.0",
	"metadata": {
		"batch_id": "2026-06-01"
	},
	"net_amount": "124.25",
	"notes": "March affiliate commissions",
	"object": "payout",
	"payer_name": "Whop Payments",
	"payout_request_id": "cofr_xxxxxxxxxxxxx",
	"payout_method": {
		"nickname": "Operating account",
		"type": "external",
		"supported_payout_method": {
			"delivery_type": "bank_deposit",
			"icon_url": "https://cdn.whop.com/bank.png",
			"payer_name": "Whop Payments"
		}
	},
	"source": "api",
	"speed": "standard",
	"status": "completed",
	"status_detail": "completed",
	"statement_descriptor": "MYCOMPANY",
	"trace_code": "021000021234567"
}
```
