> ## 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ı Kaydedin

> Platformunuzdaki işletmeler veya kişiler için alt hesaplar oluşturun ve kayıt sürecini tamamlamaları için onlara bir bağlantı gönderin.

Platformunuza bir alt hesap kaydetmek için platform hesabınızın altında onun için bir Account nesnesi oluşturun. Bu hesap daha sonra doğrudan ücretlendirmeleri kabul edebilir, transfer alabilir ve Whop para çekme akışlarını kullanabilir.

## Örnek

Alt hesap için bir hesap oluşturun:

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

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

const account = await client.accounts.create({
	email: "merchant@example.com",
	title: "Acme Merchant Store",
	external_id: "user_12345",
	metadata: {
		seller_tier: "gold",
	},
});

console.log(account.id);
```

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

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

account = client.accounts.create(
    email="merchant@example.com",
    title="Acme Merchant Store",
    external_id="user_12345",
    metadata={
        "seller_tier": "gold",
    },
)

print(account.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 account = client
    .accounts
    .create(
        &CreateAccountsRequest {
            email: Some("merchant@example.com".to_string()),
            title: "Acme Merchant Store".to_string(),
            external_id: Some("user_12345".to_string()),
            metadata: Some(HashMap::from([
                ("seller_tier".to_string(), json!("gold")),
            ])),
            ..Default::default()
        },
        None,
    )
    .await?;

println!("{}", account.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"))

account, err := client.Accounts.Create(context.TODO(), &whopsdk.CreateAccountsRequest{
    Email: whopsdk.String("merchant@example.com"),
    Title: "Acme Merchant Store",
    ExternalID: whopsdk.String("user_12345"),
    Metadata: map[string]any{
        "seller_tier": "gold",
    },
})
if err != nil {
    log.Fatal(err)
}

fmt.Println(account.ID)
```

Bu örnekte:

* `email`, alt hesabın e-posta adresidir. Whop bunu alt hesabı tanımlamak ve önemli bildirimler göndermek için kullanır.
* Account API anahtarı, alt hesabın hangi platform hesabına ait olduğunu belirler.
* `title`, alt hesap için zorunlu görünen addır.
* `external_id`, platformunuzun bu alt hesap için kullandığı kendi kimliğidir; örneğin mağaza kimliğiniz. Her kimlik tek bir alt hesaba karşılık gelir ve hesabı daha sonra bununla arayabilirsiniz.
* `metadata`, alt hesap için bir sınıflandırma veya seviye olan `seller_tier` gibi özel anahtar-değer çiftlerini içerir (ör. "bronze", "silver" veya "gold").
* Yanıt, gelecekteki API çağrılarında bu alt hesaba başvurmak için kullanabileceğiniz bir `account.id` içerir

> [!TIP]
>
> E-posta adresi, hesabı yönetecek olan alt hesaba (işletme veya
> birey) ait olmalıdır. Bu kişi hesap kurulumu ve ödeme
> bildirimlerini alır.

## Kendi kimliğinizle bir alt hesap bulun

Kayıtlarınızdan birine ait hesabı almak için alt hesaplarınızı `external_id` ile listeleyin. Kimliği, seçtiğiniz bir ad alanıyla (ör. `shopline:%`) başlayan tüm hesapları almak için değeri `%` ile bitirin. Eşleştirme büyük/küçük harfe duyarlıdır, `_` harfiyen eşleşir ve `%` yalnızca sonda çalışır; bu nedenle oluşturduğunuz kimlikler bunu içeremez.

```typescript TypeScript theme={null}
const accounts = await client.accounts.list({ external_id: "user_12345" });

console.log(accounts.data[0]?.id);
```

Update Account, mevcut bir alt hesapta `external_id` değerini ayarlar veya temizler. Bunu yalnızca platformunuz değiştirebilir. Alt hesap bunu okuyabilir ancak düzenleyemez.

## Bir e-posta adresini yeniden kullanma

Her birinin farklı bir `external_id` değeri olduğu sürece birden fazla alt hesap tek bir e-posta adresini paylaşabilir. Hesap oluşturma, e-posta ve `external_id` çifti üzerinde idempotent'tir:

* **Yeni `external_id`**: E-posta zaten kullanımda olsa bile Whop yeni bir alt hesap oluşturur.
* **Aynı e-posta ve `external_id`**: Whop bir kopya oluşturmak yerine mevcut alt hesabı döndürür; böylece yeniden denemeler güvenlidir.
* **`external_id` zaten başka bir e-postayla kullanılıyor**: Whop bu kimlikle ikinci bir hesap oluşturmak yerine `409` döndürür. Kimliği aynı istekte yeni hesaba taşımak için [Bir kimliğin arkasındaki hesabı değiştirin](#replace-the-account-behind-an-id) bölümüne bakın.
* **`external_id` yok**: Varsa, Whop o e-postaya ait `external_id` değeri olmayan mevcut alt hesabı döndürür.

Bir e-postayı paylaşan hesaplar aynı Whop kullanıcısı, yani o gelen kutusunu alan kişi tarafından yönetilir.

> [!NOTE]
>
> Bu kılavuzun önceki sürümleri `external_id` değerini `metadata` içine koyuyordu. Whop bunu her API sürümünde
> hâlâ orada kabul eder, `external_id` değerini buradan ayarlar ve `metadata` içinde döndürür. Başka bir alt hesapta zaten
> bulunduğunda verilen `409` dahil olmak üzere üst düzey alanla aynı kurallara uyar; bu nedenle birini yeniden kullanmak için `reassign_external_id: true` gönderin.
> `metadata.external_id` değerini sonradan değiştirmek `external_id` değerini değiştirmez. Değiştirmek için Update Account kullanın. Yeni
> entegrasyonlar üst düzey alanı göndermelidir.

## Bir kimliğin arkasındaki hesabı değiştirin

Kendi tarafınızda bir hesabı yeniden düzenlediğinizde, örneğin yeni bir sahibe geçen bir mağaza için, yeni alt hesabı aynı `external_id` ve `reassign_external_id: true` ile oluşturun. Whop `409` döndürmek yerine kimliği aynı istekte yeni alt hesaba taşır.

```typescript TypeScript theme={null}
const account = await client.accounts.create({
	email: "new-owner@example.com",
	external_id: "user_12345",
	reassign_external_id: true,
});
```

* Kimliğe sahip olan alt hesap silinmez veya başka hiçbir şekilde değiştirilmez. `external_id` değeri `null` olarak ayarlanmış şekilde etkin kalır, `metadata` değerini ve bakiyesini korur ve bir `account.updated` webhook'u gönderir. Artık ihtiyacınız yoksa kendiniz silin.
* Oluşturma başarısız olursa kimlik olduğu yerde kalır.
* Mevcut bir alt hesabı değiştirdiği için istek, platform hesabınızda `company:create_child` izninin yanı sıra `company:update` iznini de gerektirir.
* Mevcut bir alt hesapla aynı e-posta ve `external_id` değerine sahip bir istek, bayrağı ayarlasa bile o alt hesabı döndürür.
* Kimlik yalnızca kendi alt hesaplarınız arasında taşınır.

Bir kimliği zaten var olan iki alt hesap arasında taşımak için Update Account'u iki kez çağırın: eskisinde `external_id` değerini temizleyin, ardından diğerinde ayarlayın. Update Account'ta `reassign_external_id` yoktur ve kimliği temizlemeden önce ayarlamak `409` döndürür.

## Kayıt sürecini tamamlayın

Alıcının zaten bir Whop hesabı yoksa, hesabı oluşturduktan sonra ona bir hesap kayıt bağlantısı gönderin. Alıcı bu bağlantı üzerinden Know Your Customer (KYC) doğrulamasını tamamlar; ardından hesap transferleri ve diğer para çekme akışlarını alabilir.

```typescript TypeScript theme={null}
const accountLink = await client.accountLinks.create({
	account_id: account.id,
	refresh_url: "https://yourapp.com/onboarding/refresh",
	return_url: "https://yourapp.com/onboarding/complete",
	use_case: "account_onboarding",
});

console.log(accountLink.url);
```

```python Python theme={null}
account_link = client.account_links.create(
    account_id=account.id,
    refresh_url="https://yourapp.com/onboarding/refresh",
    return_url="https://yourapp.com/onboarding/complete",
    use_case="account_onboarding",
)

print(account_link.url)
```

```rust Rust theme={null}
let account_link = client
    .account_links
    .create(
        &CreateAccountLinksRequest {
            account_id: "biz_xxxxxxxxxxxxx".to_string(),
            refresh_url: "https://yourapp.com/onboarding/refresh".to_string(),
            return_url: "https://yourapp.com/onboarding/complete".to_string(),
            use_case: AccountLinkUseCases::AccountOnboarding,
        },
        None,
    )
    .await?;

println!("{}", account_link.url);
```

```go Go theme={null}
accountLink, err := client.AccountLinks.Create(context.TODO(), &whopsdk.CreateAccountLinksRequest{
    AccountID:  "biz_xxxxxxxxxxxxx",
    RefreshURL: "https://yourapp.com/onboarding/refresh",
    ReturnURL:  "https://yourapp.com/onboarding/complete",
    UseCase:    whopsdk.AccountLinkUseCasesAccountOnboarding,
})
if err != nil {
    log.Fatal(err)
}

fmt.Println(accountLink.URL)
```

Alıcı kayıt sürecini tamamladıktan sonra şunları yapabilirsiniz:

* onlar için uygulama ücretleriyle ödeme akışları oluşturabilirsiniz.
* hesap bakiyelerine para transfer edebilirsiniz.
* para çekme portalıyla para çekmelerine izin verebilirsiniz.

## Başlarken

Alt hesapları kaydedebilmeniz için önce platform hesabınızı kurmanız gerekir:

1. **Bir platform hesabına kaydolun**: [whop.com/dashboard](https://whop.com/dashboard) adresinde bir hesap oluşturun
2. **Bir Account API anahtarı oluşturun**: Geliştirici ayarları sayfanıza gidin ve bir Account API anahtarı oluşturun
3. **Kimlik doğrulama için API anahtarını kullanın**: Bu API anahtarı, Current API ile kimlik doğrulamanızı ve alt hesaplarınızı kontrol etmenizi sağlar

Account API anahtarı, platform hesabınız altında alt hesap oluşturmak ve yönetmek için gerekli izinleri sağlar.

## Özel meta veriler

Hesapları oluştururken onlara özel meta veriler ekleyebilirsiniz. Meta veriler, her alt hesap hakkında ek bilgileri anahtar-değer çiftleri olarak saklamanızı sağlar. Bu şunlar için kullanışlıdır:

* Alt hesap seviyelerini veya sınıflandırmalarını takip etme
* Platformunuzun veritabanı kayıtlarına bağlama

Whop meta verileri Account nesnesinde saklar ve her okumada döndürür, ancak hesapları buna göre filtreleyemezsiniz. Hesapları aramak için kullandığınız tanımlayıcıyı bunun yerine `external_id` alanına koyun.

## API referansı

> [card] [Create Account API](https://docs.whop.com/tr/api-reference/accounts/create-account.md)
>
> Hesap oluşturma ve tüm kullanılabilir parametreler için API referansının tamamına bakın

## Sonraki adımlar

Bir alt hesap için Account oluşturduktan sonra:

> [card] [Ödemeleri tahsil edin ve bölüştürün](https://docs.whop.com/tr/developer/platforms/collect-payments-for-subaccounts.md)
>
> Doğrudan ücretlendirmeler ile transferler arasında seçim yapın

> [card] [Para çekme portalını görüntüleyin](https://docs.whop.com/tr/developer/platforms/render-payout-portal.md)
>
> Alt hesapların paralarını çekmesine izin verin


## Related topics

- [Alt Hesaplar İçin Ödeme Tahsil Edin](https://docs.whop.com/tr/developer/platforms/collect-payments-for-subaccounts.md)
- [Kullanıcıları Gömülü Sohbetle Senkronize Edin](https://docs.whop.com/tr/developer/guides/chat/sync-users.md)
- [Pazar Yerleri ve Platformlar](https://docs.whop.com/tr/developer/marketplaces/overview.md)
