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

# Doğrulama

> Ödeme aktarım hesabı uygunluğu için bir kişinin veya kuruluşun kimliğini teyit etmekte kullanılan kimlik doğrulama oturumu.

> [!NOTE]
>
> Bu kaynağın, yeni entegrasyonların üzerine inşa edilmesi gereken sürümlü API olan [Whop API](https://docs.whop.com/tr/api-reference/legacy/verifications/verification.md) içinde bir halefi vardır. Bu sayfa tam olarak desteklenmeye devam eder.

Doğrulama (Verification), bir hesabın ödeme aktarımı alabilmesi için gereken kimlik kontrollerinde bir kişiyi veya işletmeyi yönlendirir. Bireyler Müşterini Tanı (KYC) kontrollerini, işletmeler ise İşletmeni Tanı (KYB) kontrollerini tamamlar. Örneğin, bir kullanıcının ilk ödeme aktarımından önce bir Doğrulama oluşturun. Adını ve adresini önceden doldurabilirsiniz; böylece özel bir doğrulama arayüzüne gerek kalmadan barındırılan formu tamamlayabilirler. Daha sonra aynı Doğrulamayı, doğrulanmış kimlik verilerini almak ve alt akıştaki ödeme aktarım sağlayıcılarından gelen [RFI'lara](https://docs.whop.com/tr/developer/verification/rfis.md) yanıt vermek için kullanın.

Bir hesabın işlem yapmadan önce — genellikle ilk [ödeme aktarımından](https://docs.whop.com/tr/api-reference/payouts/payout) önce — doğrulanması gerektiğinde bir Doğrulama oluşturun. Oluşturmadan önce, bir defter hesabına sahip bir [hesabınız](https://docs.whop.com/tr/api-reference/accounts/account) olduğundan emin olun (defter hesabı, hesabı oluşturduğunuzda otomatik olarak oluşturulur). Aynı hesapta aynı `kind` türünden birden fazla Doğrulama oluşturmayın — her hesap en fazla bir aktif bireysel (KYC) ve bir işletme (KYB) profilini destekler. Kullanıcı süreci tamamladıkça Doğrulama birden fazla durumdan geçer: KYC sürecindeyken `pending`, kimlik onaylandığında `approved`, sağlayıcı reddederse `rejected` ve bir ödeme aktarım sağlayıcısı banka ekstresi veya vergi kimlik numarası gibi ek bilgilere ihtiyaç duyduğunda `action_required`.

Başarılı Doğrulamalar; adı, doğum tarihi, ülkesi ve adresi onaylanmış, tamamen doğrulanmış bir kimlikle sonuçlanır — bu da hesabın [ödeme aktarımları](https://docs.whop.com/tr/api-reference/legacy/payout-accounts/payout-account.md) için kilidini açar. Ön doldurma alanlarıyla (`first_name`, `address` vb.) bir Doğrulama oluşturursanız, hem doğrulama hem de barındırılan KYC formu otomatik olarak doldurulur; böylece kullanıcı zaten sahip olduğunuz bilgileri yeniden girmez. Durum değişikliklerine gerçek zamanlı tepki vermek için yoklama yapmak yerine `identity_profile.approved` ve `identity_profile.rejected` [webhook'larını](https://docs.whop.com/tr/api-reference/legacy/webhooks/webhook.md) dinlemenizi öneririz. Doğrulamaları kullanarak, temel KYC sağlayıcıları ve uyumluluk gereksinimleri zaman içinde değişse bile kullanıcıları tek bir API entegrasyonuyla ödeme aktarımları için sisteme dahil edebilirsiniz.

## Uç noktalar

| Yöntem | Yol | Açıklama |
| - | - | - |
| `GET` | `/verifications?account_id={biz_ tag}` | Bir hesap için [doğrulamaları listeleyin](https://docs.whop.com/tr/developer/verification/retrieve.md) |
| `GET` | `/verifications/{verification_id}` | `idpf_` etiketiyle [tek bir doğrulamayı alın](https://docs.whop.com/tr/developer/verification/retrieve.md) |
| `POST` | `/verifications` | [Bir doğrulama oluşturun](https://docs.whop.com/tr/developer/verification/overview.md) ve bir KYC/KYB oturumu başlatın |
| `PATCH` | `/verifications/{verification_id}` | [Kimlik alanlarını güncelleyin veya RFI'lara yanıt verin](https://docs.whop.com/tr/developer/verification/manage.md) |
| `DELETE` | `/verifications/{verification_id}` | [Geçici olarak silin](https://docs.whop.com/tr/developer/verification/manage.md) ve hesaptan bağlantısını kaldırın |

## Durumlar

| Durum | Açıklama | Sonraki adım |
| - | - | - |
| `not_started` | Doğrulama mevcut ancak henüz KYC oturumu başlatılmadı | Başlatmak için `POST /verifications` çağrısı yapın |
| `pending` | Kullanıcının `session_url` adresinde KYC'yi tamamlaması gerekiyor | Kullanıcıyı `session_url` adresine yönlendirin |
| `approved` | KYC başarılı — hesap işlem yapabilir | İşlem gerekmez |
| `rejected` | KYC sağlayıcı tarafından reddedildi | `restart: true` ile `POST /verifications` çağrısı yapın |
| `action_required` | Bir ödeme aktarım sağlayıcısı ek bilgiye ihtiyaç duyuyor | `rfis` dizisini kontrol edin ve [yanıt verin](https://docs.whop.com/tr/developer/verification/rfis.md) |

```json Example theme={null}
{
	"id": "verf_xxxxxxxxxxxxx",
	"last_error_code": "abandoned",
	"last_error_reason": "Document image was too blurry to read.",
	"status": "requires_input"
}
```

**id** `string` *required*

Doğrulama kaydının sayısal kimliği.

Örnek: `verf_xxxxxxxxxxxxx`

**last\_error\_code** `VerificationErrorCodes | null` *required*

Doğrulama sırasında döndürülen en son hata kodu. Hata oluşmadıysa null olur.

Kullanılabilir seçenekler: `abandoned`, `consent_declined`, `country_not_supported`, `device_not_supported`, `document_expired`, `document_type_not_supported`, `document_unverified_other`, `email_unverified_other`, `email_verification_declined`, `id_number_insufficient_document_data`, `id_number_mismatch`, `id_number_unverified_other`, `phone_unverified_other`, `phone_verification_declined`, `selfie_document_missing_photo`, `selfie_face_mismatch`, `selfie_manipulated`, `selfie_unverified_other`, `under_supported_age`

**last\_error\_reason** `string | null` *required*

En son doğrulama hatasının insan tarafından okunabilir açıklaması. Hata oluşmadıysa null olur.

Örnek: `Document image was too blurry to read.`

**status** `VerificationStatuses` *required*

Bu doğrulama oturumunun mevcut durumu.

Kullanılabilir seçenekler: `requires_input`, `processing`, `verified`, `canceled`, `created`, `started`, `submitted`, `approved`, `declined`, `resubmission_requested`, `expired`, `abandoned`, `review`, `action_required`, `manual_review`


## Related topics

- [Doğrulama Durumunu Kontrol Etme](https://docs.whop.com/tr/developer/verification/retrieve.md)
- [Doğrulama RFI'lerini Yönetme](https://docs.whop.com/tr/developer/verification/rfis.md)
- [Kimlik Doğrulama ve API Anahtarları](https://docs.whop.com/tr/developer/guides/auth-scoping.md)
