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

# Transferler API'si

> Transfer, Whop bakiyeleri arasında para taşır: bir hesaptan veya kullanıcıdan diğerine, bir hesabın cüzdanından bir kişiye ya da adrese veya URL'ye sahip herkesin kullanabileceği bir talep bağlantısına.

Transferler API'sini para göndermek, ödeme yapabileceğiniz alıcıları bulmak, para hareketlerini mutabakat ederken transferleri listelemek ve almak ve talep bağlantılarını önizlemek veya kullanmak için kullanın.

Sonuçlar için yoklama yapmak yerine `transfer.completed` ve `transfer.failed` olaylarına abone olun. Katılan her hesap bu olaylara abone olabilir. `transfer.created` da işleme başladığında değil, başarı durumunda yayınlanır. Başarısız bir transfer aynı kimlikle yeniden denenebilir ve daha sonra başarılı olabilir; mevcut durumunu mutabakat etmek için transferi alın.

Başarılı bir bakiye transferi, bir serbest bırakma tarihi geçerli olmadıkça alıcının kullanılabilir bakiyesine yatırılır. Bekleyen bakiyeden finanse edilen transferler bir serbest bırakma tarihini korur ve bekleyen bakiyeye yatırılır; geçerli alıcı rezervleri veya dolandırıcılık blokajları fonları kullanılamaz durumda tutabilir. `succeeded`, tüm fonların çekilebilir olduğunu değil, transferin tamamlandığını onaylar.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [Talep Bağlantısını Al](https://docs.whop.com/tr/api-reference/transfers/retrieve-claim-link.md) | GET `/claim_links/{id}` |
| [Transferleri Listele](https://docs.whop.com/tr/api-reference/transfers/list-transfers.md) | GET `/transfers` |
| [Transferi Al](https://docs.whop.com/tr/api-reference/transfers/retrieve-transfer.md) | GET `/transfers/{id}` |
| [Transfer Alıcılarını Listele](https://docs.whop.com/tr/api-reference/transfers/list-transfer-recipients.md) | GET `/transfers/recipients` |
| [Talep Et](https://docs.whop.com/tr/api-reference/transfers/claim.md) | POST `/claim_links/{id}/claim` |
| [Transfer Oluştur](https://docs.whop.com/tr/api-reference/transfers/create-transfer.md) | POST `/transfers` |

## Öznitelikler

**id** `string` *required*

Transfer kimliği.

**amount** `object | null` *required*

Alıcıya yatırılan tutar. Transfer başarılı olmadığı sürece null.

> [accordion] Özellikler
>
> **amount** `string` *required*
>
> Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"`
> on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için dizedir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı
> hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` ile eşittir, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

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

Transferin oluşturulduğu zaman.

**destination** `object | null` *required*

Transferi alan işletme hesabı veya kullanıcı.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Hesap veya kullanıcı kimliği.
>
> **logo\_url** `string | null` *required*
>
> İşletme logosu veya kullanıcı avatarı URL'si. Görsel mevcut değilse null.
>
> **name** `string | null` *required*
>
> İşletmenin veya kullanıcının görünen adı.
>
> **object** `string` *required*
>
> Profilin bir işletme hesabı mı yoksa kullanıcı mı olduğu.
>
> Kullanılabilir seçenekler: `account`, `user`

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

Kaydedilen başarısızlık zamanı. Transfer başarısız olmadıkça null.

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

Makine tarafından okunabilir başarısızlık kodu. Transfer başarısız olmadıkça null.

**failure\_reason** `string | null` *required*

Başarısızlık açıklaması. Transfer başarısız olmadıkça null.

**fee** `object | null` *required*

Platform ek ücreti dahil tüm geçerli transfer ücretleri. Kesin toplam mevcut değilse null.

> [accordion] Özellikler
>
> **amount** `string` *required*
>
> Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin `"10.00"`
> on dolardır. Aktarım sırasında hiçbir kayan nokta sayısının onu yuvarlamaması için dizedir.
>
> **currency** `string` *required*
>
> Küçük harfli, üç harfli ISO 4217 para birimi kodu.
>
> **decimals** `integer` *required*
>
> Tutarın kaç ondalık basamak taşıdığı. Bu, tahsilatın kendisinin çalıştığı
> hassasiyettir.
>
> **display\_decimals** `integer` *required*
>
> Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle `decimals` ile eşittir, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu yüzden `2` ve `0` olur. Sayıyı bunu kullanarak kendi yerel ayarınızda biçimlendirin.

**metadata** `object` *required*

Transfere eklenen özel meta veriler.

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

Transfer notu.

**object** `string` *required*

Nesne türü.

**origin** `object | null` *required*

Transferi gönderen işletme hesabı veya kullanıcı.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Hesap veya kullanıcı kimliği.
>
> **logo\_url** `string | null` *required*
>
> İşletme logosu veya kullanıcı avatarı URL'si. Görsel mevcut değilse null.
>
> **name** `string | null` *required*
>
> İşletmenin veya kullanıcının görünen adı.
>
> **object** `string` *required*
>
> Profilin bir işletme hesabı mı yoksa kullanıcı mı olduğu.
>
> Kullanılabilir seçenekler: `account`, `user`

**status** `string` *required*

Mevcut transfer durumu. Bir transfer `processing` olarak oluşturulup birkaç saniye sonra sonuçlanabilir; oluşturma yanıtını nihai kabul etmek yerine Transferi Al ile yoklama yapın veya `transfer.completed` ve `transfer.failed` webhook'larını dinleyin. `succeeded` ve `failed` nihai durumlardır.

Kullanılabilir seçenekler: `processing`, `succeeded`, `failed`

**status\_changed\_at** `string | null` *required*

Mevcut geçişin kaydedilen zamanı. Geçmiş geçiş zamanı bilinmiyorsa null.

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

Kaydedilen başarı zamanı. Bilinmiyorsa null.

**tracking\_url** `string` *required*

Transferin takip sayfası. Görüntülemek için oturum açmak ve transfere erişim
gerekir.

```json Transfer theme={null}
{
	"id": "ctt_xxxxxxxxxxxxxx",
	"object": "transfer",
	"status": "succeeded",
	"origin": {
		"id": "biz_xxxxxxxxxxxxxx",
		"object": "account",
		"name": "Pickaxe",
		"logo_url": null
	},
	"destination": {
		"id": "user_xxxxxxxxxxxxx",
		"object": "user",
		"name": "Alex Rivera",
		"logo_url": null
	},
	"amount": {
		"amount": "50.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"fee": {
		"amount": "1.00",
		"currency": "usd",
		"decimals": 2,
		"display_decimals": 2
	},
	"created_at": "2026-06-01T12:00:00.000Z",
	"status_changed_at": null,
	"succeeded_at": null,
	"failed_at": null,
	"failure_code": null,
	"failure_reason": null,
	"notes": "Creator bonus",
	"metadata": {
		"external_transfer_id": "transfer_123"
	},
	"tracking_url": "https://whop.com/ctt_xxxxxxxxxxxxxx/"
}
```


## Related topics

- [Deneyler API'si](https://docs.whop.com/tr/api-reference/experiments/experiment.md)
- [Kartlar API'si](https://docs.whop.com/tr/api-reference/cards/card.md)
- [Kanallar API'si](https://docs.whop.com/tr/api-reference/channels/channel.md)
