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

# Alt Hesaplar İçin Ödeme Tahsil Edin

> Alt hesaplar için doğrudan ücretlendirmeler ve bir uygulama ücretiyle ya da platform hesabınızdan transferlerle ödeme tahsil edin; sınırlamalar ve hatalar da dahil.

Alt hesaplar için ödeme tahsil etmenin iki yolu vardır:

1. **Doğrudan ücretlendirmeler**: Alt hesap için bir ödeme sayfası oluşturun ve bir uygulama ücreti tahsil edin.
2. **Transferler**: Ödemeyi platform hesabınıza tahsil edin ve parayı daha sonra alt hesaplara transfer edin.

## Doğrudan ücretlendirmeler

Müşterilerden doğrudan alt hesap üzerinden ücret almak için bir alt hesabın kimliğiyle bir ödeme yapılandırması oluşturun. Whop ücretlerinden, iadelerden ve itirazlardan alt hesap sorumludur.

### Nasıl çalışır

1. Alt hesabınız için `application_fee_amount` içeren bir ödeme yapılandırması oluşturun
2. Bir müşteri satın aldığında Whop ücretlendirmeyi doğrudan alt hesap üzerinde oluşturur
3. Platformunuz uygulama ücretini tahsil eder ve kalan tutar alt hesaba gider
4. İşlemle ilgili tüm itirazları veya iadeleri alt hesap ele alır

### Örnek

`plan` adlı uyumluluk girdisini kullanarak satır içi bir varyant oluşturun.

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({
	token: "Account API Key",
});

const checkoutConfig = await client.checkoutConfigurations.create({
	account_id: "biz_xxxxxxxxxxxxx", // Subaccount's ID
	variant: {
		initial_price: 10.0,
		billing_type: "one_time",
		application_fee_amount: 1.23,
	},
});

console.log(checkoutConfig.purchase_url);
```

```python Python theme={null}
from whop_sdk import Whop

client = Whop(
    token="Account API Key",
)

checkout_config = client.checkout_configurations.create(
    account_id="biz_xxxxxxxxxxxxx",  # Subaccount's ID
    variant={
        "initial_price": 10.0,
        "billing_type": "one_time",
        "application_fee_amount": 1.23,
    },
)

print(checkout_config.purchase_url)
```

```rust Rust theme={null}
use whop_sdk::prelude::*;

let config = ClientConfig {
    token: Some("Account API Key".to_string()),
    ..Default::default()
};
let client = Whop::new(config).expect("Failed to build client");

let checkout_config = client
    .checkout_configurations
    .create(
        &CreateCheckoutConfigurationsRequest {
            account_id: Some("biz_xxxxxxxxxxxxx".to_string()), // Subaccount's ID
            variant: Some(CreateCheckoutConfigurationsRequestVariant {
                initial_price: Some(10.0),
                billing_type: Some(CreateCheckoutConfigurationsRequestVariantBillingType::OneTime),
                application_fee_amount: Some(1.23),
                ..Default::default()
            }),
            ..Default::default()
        },
        None,
    )
    .await?;

println!("{}", checkout_config.purchase_url.unwrap());
```

```go Go theme={null}
import (
    "context"
    "fmt"
    "log"

    whopsdk "github.com/whopio/whopsdk-go/v2"
    "github.com/whopio/whopsdk-go/v2/client"
    "github.com/whopio/whopsdk-go/v2/option"
)

client := client.NewWhop(option.WithToken("Account API Key"))

checkoutConfig, err := client.CheckoutConfigurations.Create(context.TODO(), &whopsdk.CreateCheckoutConfigurationsRequest{
    AccountID: whopsdk.String("biz_xxxxxxxxxxxxx"), // Subaccount's ID
    Variant: &whopsdk.CreateCheckoutConfigurationsRequestVariant{
        InitialPrice:         whopsdk.Float64(10.0),
        BillingType:          whopsdk.CreateCheckoutConfigurationsRequestVariantBillingTypeOneTime.Ptr(),
        ApplicationFeeAmount: whopsdk.Float64(1.23),
    },
})
if err != nil {
    log.Fatal(err)
}

fmt.Println(*checkoutConfig.PurchaseURL)
```

Bu örnekte:

* `account_id`, Whop'un ücretlendirmeyi oluşturacağı alt hesabın kimliğidir
* `variant.initial_price`, varyantın toplam ödeme tutarıdır (10,00 ABD doları)
* `variant.application_fee_amount`, platformunuzun tahsil ettiği ücrettir (1,23 ABD doları)
* Alt hesap 8,77 ABD doları alır (10,00 - 1,23)

### Sınırlamalar

* `application_fee_amount` pozitif olmalı ve toplam ödeme tutarından az olmalıdır
* Uygulama ücreti, tahsil edilen ödeme tutarını aşamaz

## Transferler

Platformunuz ödemeyi önce tahsil ettiğinde veya her alt hesaba ne kadar ve ne zaman ödeme yapılacağına arka ucunuz karar verdiğinde transferleri kullanın.

### Transfer etmeden önce

* **Kaynak hesap**: parayı gönderen hesap Know Your Customer (KYC) doğrulamasını tamamlamış olmalı ve transfer için yeterli bakiyeye sahip olmalıdır. Bakiyeyi kontrol panelinden veya [Bakiyenize para ekleyin](https://docs.whop.com/tr/developer/platforms/add-funds-to-your-balance.md) yoluyla yükleyebilirsiniz.
* **Hedef hesap**: alıcının zaten bir Whop hesabı olmalıdır. Yoksa önce [Alt hesapları kaydedin](https://docs.whop.com/tr/developer/platforms/enroll-subaccounts.md) ile sisteme dahil edin.
* **Mutabakat sahipliği**: transferlerde orijinal ödemenin kayıtlı satıcısı (merchant of record) platformunuzdur. Bu ödemedeki ücretleri, itirazları ve iadeleri platformunuz ele alır.

### Örnek

Ödemeyi platform hesabınıza tahsil edin, ardından alt hesabın payını transfer edin:

```typescript TypeScript theme={null}
import { WhopClient } from "@whop/sdk";

const client = new WhopClient({
	token: "Account API Key",
});

const transfer = await client.transfers.create({
	type: "balance",
	amount: 90.0,
	currency: "usd",
	origin_id: "biz_yyyyyyyyyyyyy", // Platform's account ID
	destination_id: "biz_xxxxxxxxxxxxx", // Subaccount's ID
	metadata: {
		order_id: "order_12345",
	},
});

if (transfer.object === "transfer") {
	console.log(transfer.id);
}
```

```python Python theme={null}
from whop_sdk import Whop

client = Whop(
    token="Account API Key",
)

transfer = client.transfers.create(
    type="balance",
    amount=90.0,
    currency="usd",
    origin_id="biz_yyyyyyyyyyyyy",  # Platform's account ID
    destination_id="biz_xxxxxxxxxxxxx",  # Subaccount's ID
    metadata={
        "order_id": "order_12345",
    },
)

if transfer.object == "transfer":
    print(transfer.id)
```

```rust Rust theme={null}
use whop_sdk::prelude::*;

let config = ClientConfig {
    token: Some("Account API Key".to_string()),
    ..Default::default()
};
let client = Whop::new(config).expect("Failed to build client");

let transfer = client
    .transfers
    .create(
        &CreateTransfersRequest {
            amount: 90.0,
            currency: Some("usd".to_string()),
            origin_id: "biz_yyyyyyyyyyyyy".to_string(), // Platform's account ID
            destination_id: Some("biz_xxxxxxxxxxxxx".to_string()), // Subaccount's ID
            metadata: Some(HashMap::from([("order_id".to_string(), json!("order_12345"))])),
            ..Default::default()
        },
        None,
    )
    .await?;

if let CreateTransfersResponse::Transfer { id, .. } = &transfer {
    println!("{id}");
}
```

```go Go theme={null}
import (
    "context"
    "fmt"
    "log"

    whopsdk "github.com/whopio/whopsdk-go/v2"
    "github.com/whopio/whopsdk-go/v2/client"
    "github.com/whopio/whopsdk-go/v2/option"
)

client := client.NewWhop(option.WithToken("Account API Key"))

transfer, err := client.Transfers.Create(context.TODO(), &whopsdk.CreateTransfersRequest{
    Amount:        90.0,
    Currency:      whopsdk.String("usd"),
    OriginID:      "biz_yyyyyyyyyyyyy",                 // Platform's account ID
    DestinationID: whopsdk.String("biz_xxxxxxxxxxxxx"), // Subaccount's ID
    Metadata:      map[string]any{"order_id": "order_12345"},
})
if err != nil {
    log.Fatal(err)
}

if transfer.Object == "transfer" {
    fmt.Println(transfer.Transfer.ID)
}
```

Bu örnekte:

* `origin_id`, platformunuzun hesap kimliğidir (Whop'un parayı düştüğü yer)
* `destination_id`, alt hesabın kimliğidir (Whop'un parayı yatırdığı yer)
* `amount`, transfer edilecek tutardır
* `metadata`, referansınız için özel verileri saklar

### Transfer hatalarını ele alın

Kaynak hesap doğrulanmamışsa, kaynak bakiye çok düşükse veya hedef hesap henüz para alamıyorsa transferler başarısız olur. Yeniden denemeden önce asıl nedeni düzeltin. Başarısız transferleri nedenini incelemeden yeniden denemeyin.

### Yaygın kullanımlar

* Zamanlanmış içerik üreticisi ödemeleri
* Satış ortağı ödemeleri
* Bir siparişin mutabakatı yapıldıktan sonra pazar yeri paylaşımları

## Bir ödeme akışı seçin

| | Doğrudan ücretlendirmeler | Transferler |
| - | - | - |
| **Ücretler** | Whop ücretlerini alt hesap öder | Whop ücretlerini platform öder |
| **İtirazlar** | İtirazları alt hesap ele alır | İtirazları platform ele alır |
| **İadeler** | İadeleri alt hesap ele alır | İadeleri platform ele alır |

Ödeme zamanlamasını ve tutarını arka ucunuz kontrol ediyorsa transferleri kullanın. Orijinal satın almadan kaynaklanan ücretler, itirazlar ve iadeler alt hesaba ait olacaksa doğrudan ücretlendirmeleri kullanın.

## API referansı

> [card] [Ödeme Yapılandırması Oluştur](https://docs.whop.com/tr/api-reference/legacy/checkout-configurations/create-checkout-configuration.md)
>
> Uygulama ücretleriyle ödeme yapılandırmaları oluşturun

> [card] [Transfer Oluştur](https://docs.whop.com/tr/api-reference/transfers/create-transfer.md)
>
> Hesaplar arasında para transfer edin

## İlgili kaynaklar

> [card] [Ödeme kabul edin](https://docs.whop.com/tr/developer/guides/accept-payments.md)
>
> Ödeme bağlantıları ve Checkout öğesi hakkında bilgi edinin

> [card] [Alt hesapları kaydedin](https://docs.whop.com/tr/developer/platforms/enroll-subaccounts.md)
>
> Alıcı hesapları oluşturun ve onlara ödeme yapmadan önce kayıt sürecini tamamlayın


## Related topics

- [Bakiyenize Para Ekleyin](https://docs.whop.com/tr/developer/platforms/add-funds-to-your-balance.md)
- [Alt Hesapları Kaydedin](https://docs.whop.com/tr/developer/platforms/enroll-subaccounts.md)
- [Alt Hesaplara Manuel Ödemeler](https://docs.whop.com/tr/developer/platforms/manual-payouts.md)
