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

# Kullanıcı Kimliklerini KYC ile Doğrulayın

> Kullanıcılarınızın ödeme alabilmesinden önce kimliklerini doğrulayın. Tek bir API çağrısı Müşterini Tanı (KYC) doğrulamasını başlatır, gerisini Whop halleder.

## Nasıl çalışır

**1. Bir doğrulama başlatın**

Doğrulamak istediğiniz hesapla `POST /api/v1/verifications` çağrısını yapın. Karşılığında bir `session_url` alırsınız.

**2. Kullanıcıyı KYC'yi tamamlamaya yönlendirin**

Kullanıcınızı `session_url` adresine yönlendirin. Kullanıcı barındırılan bir sayfada kimliğini yükler, bir selfie çeker ve kimliğini doğrular. Bunun için herhangi bir arayüz oluşturmanız gerekmez.

**3. Sonucu dinleyin**

`identity_profile.updated` webhook'una abone olun; profildeki her değişiklikte tetiklenir (onaylandı, reddedildi, işlem gerekiyor veya bir incelemenin açılması ya da kapanması). Webhook size profilin yeni durumunu değil, *hangi* profilin değiştiğini söyler; bu nedenle mevcut durumu ve doğrulanmış kimlik verilerini okumak için `GET /api/v1/verifications?account_id={biz_ tag}` çağrısını yapın.

## Hızlı örnek

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "individual"}'
```

```json Response theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "pending",
  "session_url": "https://in.sumsub.com/websdk/p/sbx_xxxxxxxxxxxxx",
  "created_at": "2026-06-03T22:15:00Z",
  "updated_at": "2026-06-03T22:15:00Z"
}
```

> [!NOTE]
>
> `identity:write` kapsamına sahip bir Account API anahtarına ihtiyacınız var. Kimlik bilgisi türleri ve bunların nasıl kapsamlandırılacağı için [Kimlik doğrulama ve API anahtarları](https://docs.whop.com/tr/developer/guides/auth-scoping.md) sayfasına bakın. Bir anahtar oluşturmak için [kontrol panelinizde](https://whop.com/dashboard) Settings → API Keys bölümüne gidin.

## Kimlik doğrulama formunu önceden doldurun

Kullanıcınız için adımları atlamak üzere kimlik alanlarını iletin. Bunlar doğrulama formunu önceden doldurur, böylece kullanıcının adını ve adresini yeniden yazması gerekmez:

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "individual",
    "first_name": "Jane",
    "last_name": "Doe",
    "date_of_birth": "1995-01-15",
    "country": "US",
    "tax_identification_number": "123-45-6789",
    "address": {
      "line1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105"
    }
  }'
```

> [!NOTE]
>
> `tax_identification_number`, kişinin vergi kimlik numarasıdır (ABD'deki bireyler için SSN) ve
> **`country` değeri `US` olduğunda zorunludur**: ödeme hesabı onsuz
> oluşturulamaz. Olduğu gibi gönderin. Aktarım sırasında tokenize edilir ve
> ham değer hiçbir zaman Whop sistemlerinde saklanmaz.

> [!WARNING]
>
> Whop, [yaptırım uygulanan bir ülke veya bölgedeki](https://docs.whop.com/tr/trust-and-safety/trust-safety-overview/sanctioned-countries.md) kullanıcıları destekleyemez.
> İstek `400` ve `address_country_sanctioned` hata koduyla başarısız olur.

## Mevcut bir doğrulamayı yeniden kullanın

Bu kişiyi zaten Sumsub ile doğruladıysanız, onu ikinci kez KYC'den geçirmek yerine paylaşım belirtecini
gönderin. Whop, Sumsub hesabınızın onayladığı kimliği içe aktarır ve bunu Whop'un kendi
gereksinimlerine göre kontrol eder:

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "individual", "share_token": "_act-sbx-jwt-eyJhbGciOiJub25l"}'
```

```json Response theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "approved",
  "first_name": "Jane",
  "last_name": "Doe",
  "created_at": "2026-06-03T22:15:00Z",
  "updated_at": "2026-06-03T22:15:00Z"
}
```

**1. Whop ile Reusable KYC konusunda anlaşın**

Sumsub, başvuru sahibi verilerini yalnızca Reusable KYC anlaşması olan istemciler arasında paylaşır. Bu
anlaşma yürürlüğe girdiğinde Whop size paylaşım yapılacak istemci kimliğini verir.

**2. Başvuru sahibi için bir paylaşım belirteci oluşturun**

Kendi Sumsub hesabınızda, başvuru sahibinin kimliği ve `forClientId` olarak Whop'un istemci kimliğiyle
`POST https://api.sumsub.com/resources/accessTokens/shareToken` çağrısını yapın.

**3. Belirteci Whop'a gönderin**

Belirteci `share_token` olarak iletin. Her belirteç bir kez çalışır.

Yanıt, sonucun nereye vardığını söyler. `approved`, doğrulamanızın Whop'un ihtiyaç duyduğu her şeyi
kapsadığı ve yapacak bir şey kalmadığı anlamına gelir. `session_url` ile birlikte `pending`, bir kısmını kapsadığı anlamına gelir;
yalnızca hâlâ eksik olanı tamamlaması için kullanıcıyı o URL'ye gönderin. Whop, verileri gereksinimlerin
hiçbirini karşılamayan bir belirteci `400` ile reddeder.

> [!NOTE]
>
> `share_token`, `documents` veya `document_type` ile birleştirilemez; her biri barındırılan akışa
> eksiksiz bir alternatiftir.

## İki doğrulama türü

| Tür | `kind` | Neyi doğrular | Ne zaman kullanılır |
| - | - | - | - |
| Bireysel (KYC) | `individual` | Bir kişinin kimliğini | Kullanıcı para çekmek istiyor |
| İşletme (KYB) | `business` | Bir işletme tüzel kişiliğini | Hesabın yasal tüzel kişiliğini doğrulaması gerekiyor |

Bir hesap her birinden bir tane olabilir: bir bireysel KYC ve bir işletme KYB.

## Sırada ne var

> [card] [Durumu kontrol edin](https://docs.whop.com/tr/developer/verification/retrieve.md)
>
> Doğrulama durumunu kontrol edin ve doğrulanmış kimlik verilerini okuyun.

> [card] [RFI'leri yönetin](https://docs.whop.com/tr/developer/verification/rfis.md)
>
> Whop banka hesap özeti gibi ek bilgilere ihtiyaç duyduğunda yanıt verin.

> [card] [Güncelleme ve silme](https://docs.whop.com/tr/developer/verification/manage.md)
>
> Kimlik alanlarını güncelleyin veya bir doğrulamayı kaldırın.

> [card] [API Referansı](https://docs.whop.com/tr/api-reference/verifications/verification)
>
> Doğrulama nesnesi için tam alan referansı.


## Related topics

- [Whop Uygulamalarında Kullanıcıların Kimliğini Doğrulayın](https://docs.whop.com/tr/developer/guides/authentication.md)
- [Doğrulama Durumunu Kontrol Etme](https://docs.whop.com/tr/developer/verification/retrieve.md)
- [KycElement](https://docs.whop.com/tr/elements/latest/verifications/kyc.md)
