> ## 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 RFI'lerini Yönetme

> Whop daha fazla bilgiye (bir belge, vergi kimlik numarası veya işletme ayrıntısı) ihtiyaç duyduğunda yanıt verin.

Whop, bir kullanıcıdan ek bir şeye (bir belge, vergi kimlik numarası veya işletme ayrıntısı) ihtiyaç duyduğunda bir **Bilgi Talebi (RFI)** oluşturur. Her açık RFI, doğrulamanın `requested_information` dizisinde görünür. Kullanıcı her öğeyi yanıtlayana kadar doğrulamanın `status` değeri `action_required` olarak kalır.

Her öğe toplanacak bir şeyi temsil eder ve tek bir yazma işlemiyle yanıtlanır. `requirement` neyin gerektiğini adlandırır, girdi `type` değeri bunu nasıl toplayacağınızı söyler ve `label` kullanıcıya gösterilecek metni sağlar. Yanıt, bir öğe için geçerli olmayan anahtarları içermez. Tam katalog için [her gereksinim](#every-requirement) bölümüne bakın.

## RFI'ler nasıl çalışır

**1. Bilgi talep edilir**

Whop bir şeyin gerektiğini işaretler. Doğrulama durumu `action_required` olarak değişir ve bir `identity_profile.updated` webhook'u tetiklenir. (`identity_profile.needs_action` da bu geçiş için tetiklenir, ancak `identity_profile.updated` her durum değişikliğini kapsayan genel olaydır; ona abone olun ve neyin beklediğini görmek için doğrulamayı yeniden getirin.)

**2. Öğeleri okursunuz**

`GET /api/v1/verifications?account_id={biz_ tag}` çağrısını yapın. Her doğrulamadaki `requested_information` dizisi neyin gerektiğini ve ne tür bir yanıt toplanacağını listeler.

**3. Toplar ve gönderirsiniz**

Bilgiyi kullanıcınızdan alın ve bir `requested_information` dizisiyle `PATCH /api/v1/verifications/{id}` üzerinden geri gönderin. Whop her yanıtı doğru yere yönlendirir.

**4. İnceleme devam eder**

Yanıtlanan öğeler diziden çıkar. Dizi boşaldığında, yanıtlar incelenirken doğrulama `processing` durumuna geçer; bu durumda gönderilecek bir şey yoktur. Sonuç `approved` olur veya bir uyumluluk incelemesi açılırsa `manual_review` olur. Bir yanıt reddedilirse öğe, nedenini açıklayan `errors` ile `action_required` durumuna döner. Yeniden gönderin.

## RFI'leri okuma

```bash cURL theme={null}
curl "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

Bekleyen RFI'ler olduğunda doğrulama şöyle görünür:

```json theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "action_required",
  "requested_information": [
    {
      "id": "inrqi_xxxxxxxxxxxxx",
      "requirement": "date_of_birth",
      "type": "date",
      "label": "Date of Birth"
    },
    {
      "id": "inrqi_yyyyyyyyyyyyy",
      "requirement": "business_structure",
      "type": "select",
      "label": "Business Structure",
      "options": ["single_member_llc", "multi_member_llc", "sole_proprietorship", "private_corporation"]
    },
    {
      "id": "inrqi_zzzzzzzzzzzzz",
      "requirement": "bank_statement",
      "type": "files",
      "label": "Bank Statement for account ending in 4242"
    }
  ]
}
```

### Öğe alanları

| Alan | Açıklama |
| - | - |
| `id` | `inrqi_` önekli öğe tanımlayıcısı; bir yanıt gönderirken bunu ekleyin |
| `requirement` | Whop'un neye ihtiyaç duyduğu, örneğin `ssn` veya `bank_statement`; bkz. [her gereksinim](#every-requirement) |
| `type` | Ne geri gönderileceği: `files`, `id_document`, `text`, `date`, `phone`, `select` veya `address` |
| `label` | Kullanıcınıza ne gösterileceği. Varsa inceleyenin kendi notunu taşır |
| `options` | Bir `select` öğesi için izin verilen değerler veya bir `id_document` öğesinde kabul edilen kimlik türleri |
| `optional` | Kullanıcı öğeyi atlayabildiğinde `true` olarak görünür |
| `errors` | Reddedilen bir yanıttan sonra bulunur; her biri sabit bir `code` ve insan tarafından okunabilir bir `reason` içerir |

Yanıt yalnızca bir öğe için geçerli olan anahtarları döndürür; bu nedenle bir öğe hiçbir zaman kontrol etmeniz gereken boş bir dizi veya `null` taşımaz.

Yanıt yalnızca açık öğeleri döndürür; yanıtlanan öğeler diziden çıkar, bu nedenle dizide bulunan her şey kullanıcının hâlâ sağlaması gereken şeydir. Dizi boşalana kadar doğrulama `action_required` olarak kalır.

## RFI'leri yanıtlama

Doğrulamanın `idpf_` etiketine bir `requested_information` dizisiyle `PATCH` gönderin. Her girdi, öğe `id` değerini ve öğenin `type` değeriyle eşleşen tam olarak bir yanıt yükünü gerektirir:

| Öğe `type` | Yanıt yükü |
| - | - |
| `files` | `files`; sayfalarının listesi olarak tek bir belge |
| `id_document` | `documents`; yüklediğiniz kimlik için yuva anahtarları |
| `text`, `date`, `phone`, `select` | `value` |
| `address` | `address` nesnesi |

Yanıt öğeden başka hiçbir şeyi yansıtmaz; kategori veya belge türü yoktur. Öğe `id` değeri, Whop'a yanıtın nereye ait olduğunu söyler.

Tek bir istekte birden fazla öğeyi yanıtlayabilirsiniz:

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_xxxxxxxxxxxxx", "value": "1990-01-15" },
      { "id": "inrqi_yyyyyyyyyyyyy", "value": "single_member_llc" }
    ]
  }'
```

### Metin, tarih, telefon ve seçim değerleri

Yanıtı `value` olarak iletin. Tarihler `YYYY-MM-DD`, telefon numaraları E.164 biçimini (`+12125550123`) kullanır ve seçim değerleri öğenin `options` değerlerinden biri olmalıdır.

### Adresler

Bir `address` nesnesi iletin:

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      {
        "id": "inrqi_xxxxxxxxxxxxx",
        "address": {
          "line1": "123 Spring Street",
          "city": "New York",
          "state": "NY",
          "postal_code": "10012",
          "country": "US"
        }
      }
    ]
  }'
```

Kişisel veya işletme adresleri için posta kutuları kabul edilmez.

### Belgeler

[Önce dosyayı yükleyin](https://docs.whop.com/tr/developer/guides/upload-files.md), ardından kimliğini `files` içinde iletin:

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_zzzzzzzzzzzzz", "files": ["file_xxxxxxxxxxxxx"] }
    ]
  }'
```

Her girdi, [yükleme akışından](https://docs.whop.com/tr/developer/guides/upload-files.md) bir `file_` kimliği veya doğrudan bir yüklemeden bir `direct_upload_id` alır. Belgeler en fazla 32 MB boyutunda Joint Photographic Experts Group (JPEG), Portable Network Graphics (PNG) veya PDF dosyaları olmalıdır. Tek sayfalık bir belge, tek öğeli bir listedir; ayrı bir tek dosya alanı yoktur.

`requirement`, Whop'un ihtiyaç duyduğu belgeyi adlandırır ve gerisini Whop halleder; ne tür bir belge yüklediğinizi hiçbir zaman belirtmezsiniz.

#### Birden fazla sayfalı belgeler

Birden fazla sayfası olan bir belge, sayfa sırasına göre aynı `files` listesine girer:

```json theme={null}
{ "id": "inrqi_aaa", "requirement": "business_verification_document", "type": "files",
  "label": "Company Verification Document" }
```

```json theme={null}
{ "id": "inrqi_aaa", "files": ["file_page1xxxxxx", "file_page2xxxxxx"] }
```

#### Kimlik belgeleri

Bir `id_document` öğesi hangi kimlik olduğunu sorar. İncelemenin kabul ettiği kimlik türlerini listeleyen `options` taşır ve yanıt, her yuvayı [Create Verification](https://docs.whop.com/tr/api-reference/verifications/create-verification.md) ile aynı anahtarlarla adlandırır:

```json theme={null}
{
  "id": "inrqi_bbb",
  "requirement": "identity_document",
  "type": "id_document",
  "label": "Identity Document",
  "options": ["ID_CARD", "DRIVERS", "RESIDENCE_PERMIT", "PASSPORT"]
}
```

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      {
        "id": "inrqi_bbb",
        "documents": {
          "drivers_front": "file_frontxxxxxxx",
          "drivers_back": "file_backxxxxxxxx"
        }
      }
    ]
  }'
```

Anahtar hem belgeyi hem de yüzü aynı anda adlandırır; bu nedenle belgenin hangi kimliği temsil ettiği için ayrı bir alan yoktur, Whop bunu anahtarlardan çıkarır. Yüklediğiniz kimlik için her yuvayı gönderin:

| Kimlik türü | Yuvalar |
| - | - |
| `PASSPORT` | `passport_front` |
| `ID_CARD` | `id_card_front`, `id_card_back` |
| `DRIVERS` | `drivers_front`, `drivers_back` |
| `RESIDENCE_PERMIT` | `residence_permit_front`, `residence_permit_back` |

Whop, iki belgeden karışık yuvaları veya eksik bir belgeyi herhangi bir şey saklamadan önce reddeder. Öğedeki `options`, o incelemenin hangi kimlik türlerini kabul ettiğini belirtir.

Bir dosya öğesinin `options` değeri yoksa `value` gerektirmez.

### Hassas değerler

Vergi ve devlet kimlik numaralarını (`ssn`, `ein`, `company_tax_id`, `personal_id_number`) diğer değerler gibi gönderin. Whop bunları aktarım sırasında güvenli belirteçlerle değiştirir ve yalnızca güvenli referansı saklar:

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_xxxxxxxxxxxxx", "value": "123-45-6789" }
    ]
  }'
```

Değerleri zaten kendiniz tokenize ediyorsanız (Basis Theory), bunun yerine belirteç kimliğini `value_type: "vault_token"` ile iletin.

## Reddedilen yanıtlar

Whop gönderilen bir yanıtı reddederse, öğe `errors` ayarlanmış olarak `requested_information` içine geri döner:

```json theme={null}
{
  "id": "inrqi_xxxxxxxxxxxxx",
  "requirement": "business_website",
  "type": "text",
  "label": "Business website or social profile",
  "errors": [
    {
      "code": "invalid_url_website_inaccessible",
      "reason": "The website provided could not be reached."
    }
  ]
}
```

`reason` değerini kullanıcınıza gösterin ve gerekirse `code` değerine göre dallanın. Tanınmayan kodları genel bir ret olarak ele alın.

Temeldeki sorunu düzeltin ve aynı öğe `id` değeriyle yeniden gönderin. Whop düzeltilmiş yanıtı kabul edene kadar doğrulama `action_required` olarak kalır.

### Belge reddi kodları

Whop yüklenen bir belgeyi reddettiğinde, `code` belgede neyin yanlış olduğunu adlandırır. Alabileceğiniz kodlar şunlardır:

| Kod | Anlamı |
| - | - |
| `bad_proof_of_identity` | Whop kimlik kanıtını kabul etmiyor; devlet tarafından verilmiş fotoğraflı bir kimlik sağlayın |
| `expiration_date` | Belgenin süresi dolmuş |
| `unsatisfactory_photos` | Okunamayacak kadar belirsiz |
| `problematic_applicant_data` | Gönderilen ayrıntılar belgeyle eşleşmiyor |
| `screenshots` | Kullanıcı belgenin fotoğrafı yerine bir ekran görüntüsü yükledi |
| `graphic_editor` | Belge düzenlenmiş görünüyor |
| `digital_document` | Kullanıcı dijital bir kopya yükledi. Fiziksel belgenin bir fotoğrafını sağlayın |
| `document_damaged` | Hasarlı veya kısmen okunamaz |
| `document_page_missing` | Bir sayfa eksik |
| `document_missing` | Belge alınmadı |
| `not_document` | Dosya bir belge değil |
| `id_invalid` | Kimlik belgesi geçerli değil |
| `incompatible_language` | Desteklenmeyen dil. Onaylı bir çeviri sağlayın |
| `bad_selfie` | Selfie belirsizdi |
| `bad_face_matching` | Selfie, belgedeki fotoğrafla eşleşmedi |
| `bad_proof_of_address` | Kabul edilen bir adres kanıtı değil |
| `wrong_address` | Adres belgeyle eşleşmiyor |
| `incorrect_social_number` | Vergi kimlik numarası belgeyle eşleşmiyor |
| `company_incorrect_data` | Hesap ayrıntıları kayıt belgesiyle eşleşmiyor |
| `company_data_mismatch` | Hesap ayrıntıları Whop kayıtlarıyla eşleşmiyor |
| `company_inactive_entity` | Hesap sicilde etkin olarak listelenmiyor |
| `additional_document_required` | Whop'un başka bir belgeye ihtiyacı var |
| `more_documents_required` | Whop'un daha fazla belgeye ihtiyacı var |
| `db_data_mismatch` | Gönderilen ayrıntılar resmi kayıtlarla eşleşmiyor |
| `spam` | Whop gönderimi işleyemedi |

Buradaki her kod, yüklemeyle ilgili düzeltilebilir bir sorunu tanımlar. Whop'un bunlardan birine bağlayamadığı bir ret, kullanılamaz bir kod yerine hiç `errors` döndürmez. `errors` içermeyen bir öğeyi her zaman ele alın ve kullanıcıya gösterilecek metin için `reason` değerini tercih edin.

## Her gereksinim

Her öğenin `requirement` değeri aşağıdaki değerlerden biridir.

### Kişisel ayrıntılar

| Gereksinim | Tür | Ne gönderilmeli |
| - | - | - |
| `first_name` | `text` | Büyük harfle başlayan yasal ad (`Jane`) |
| `last_name` | `text` | Büyük harfle başlayan yasal soyad (`Doe`) |
| `creator_legal_name` | `text` | Resmi belgelerde göründüğü şekliyle tam yasal ad |
| `date_of_birth` | `date` | `YYYY-MM-DD` |
| `email` | `text` | E-posta adresi |
| `creator_email_address` | `text` | Whop'un kullanıcıya ulaşabileceği bir e-posta adresi |
| `phone_number` | `phone` | Ülke koduyla E.164 biçimi (`+12125550123`) |
| `personal_address` | `address` | Mevcut yerleşim adresi; posta kutusu olamaz |
| `occupation` | `text` | Standart Meslek Sınıflandırması kodu (`15-1132`) veya `SELFEMP`, `STUDENT`, `RETIRED`, `UNEMPLO`, `OTHERXX` |
| `annual_salary` | `text` | ABD doları cinsinden yaklaşık yıllık gelir, yalnızca rakam |

### Vergi ve devlet kimlik numaraları

Whop bu değerleri aktarım sırasında güvenli belirteçlerle değiştirir; bkz. [hassas değerler](#sensitive-values).

| Gereksinim | Tür | Ne gönderilmeli |
| - | - | - |
| `ssn` | `text` | ABD Sosyal Güvenlik Numarası, `XXX-XX-XXXX` |
| `ein` | `text` | ABD İşveren Kimlik Numarası, `XX-XXXXXXX` |
| `company_tax_id` | `text` | Veren ülkenin biçiminde hesap vergi kimlik numarası |
| `personal_id_number` | `text` | Devlet tarafından verilmiş kişisel kimlik numarası (pasaport, ehliyet, ulusal kimlik) |
| `personal_id_number_country` | `select` | Kimlik numarasını veren ülke; `options` içinden seçin |
| `country_of_issue` | `text` | Veren ülkenin iki harfli ülke kodu (`US`) |

### Kimlik belgeleri

| Gereksinim | Tür | Ne gönderilmeli |
| - | - | - |
| `identity_document` | `id_document` | Devlet tarafından verilmiş fotoğraflı kimlik. Kullanıcının yüklediği kimlik için yuva anahtarlarıyla `documents` gönderin |
| `selfie` | `files` | Kullanıcının kimliğini tutarken çekilmiş fotoğrafı |

### İşletme ayrıntıları

| Gereksinim | Tür | Ne gönderilmeli |
| - | - | - |
| `business_name` | `text` | İşletmenin kayıtlı yasal adı |
| `trade_name` | `text` | Yasal addan farklıysa kamuya açık ad (ticari unvan) |
| `company_title` | `text` | Hesabın adı |
| `business_structure` | `select` | Yasal yapı; `options` değerlerinden biri, ör. `single_member_llc`, `sole_proprietorship`, `private_corporation` |
| `account_type` | `select` | `individual`, `company` veya `non_profit` |
| `business_representative_title` | `select` | Temsilcinin unvanı; `options` değerlerinden biri, ör. `CEO`, `Owner`, `Manager` |
| `industry_type` | `text` | İşletmenin faaliyet gösterdiği sektör |
| `business_description` | `text` | 100–1000 karakter: ne satıldığı, müşterilerin ödemeden sonra ne aldığı ve buna nereden eriştikleri |
| `product_description` | `text` | Satılan ürün veya hizmet |
| `business_phone_number` | `phone` | Ülke koduyla E.164 biçimi |
| `business_address` | `address` | Kayıtlı işletme adresi; posta kutusu olamaz |
| `business_website` | `text` | İşletme web sitesi URL'si |
| `social_media_or_website` | `text` | Web sitesi veya satılanı temsil eden herkese açık bir sosyal medya profili |
| `store_page_url` | `text` | Mağaza veya ürün sayfasına bağlantı |
| `expected_monthly_volume` | `text` | ABD doları cinsinden beklenen aylık işlem hacmi, yalnızca rakam |
| `account_purpose` | `text` | Hesabın öncelikli olarak ne için kullanıldığı |

### İşletme belgeleri

| Gereksinim | Tür | Ne gönderilmeli |
| - | - | - |
| `business_verification_document` | `files` | Hesabın yasal kimliğini doğrulayan belge: Internal Revenue Service (IRS) Letter 147C, SS-4 veya Employer Identification Number (EIN) Assistance Letter |
| `business_incorporation_papers` | `files` | Resmi kuruluş belgeleri |
| `ownership_structure` | `files` | İşletmenin sahiplerini gösteren belgeler |
| `processing_statements` | `files` | Önceki bir ödeme işlemcisinden işlem geçmişini gösteren dökümler; banka hesap özetleri değil |
| `proof_of_fulfillment` | `files` | Müşterilerin satın aldıktan sonra ne aldığını gösteren ekran görüntüsü, kayıt veya dosya |
| `proof_of_funnel` | `text` veya `files` | Müşterilerin nereden geldiği: bir sosyal medya hesabı, web sitesi veya açılış sayfası |

### Ödeme hesabı belgeleri

Bir ödeme hedefini doğrulamak için talep edilen bir belge, belgenin kendisini adlandırır. Tek bir dosya yükleyin; `label`, kullanıcınıza belgenin hangi hesap için olduğunu söyler.

| Gereksinim | Tür | Ne gönderilmeli |
| - | - | - |
| `bank_statement` | `files` | Ödeme hesabı için yakın tarihli banka hesap özeti |
| `paper_check` | `files` | İptal edilmiş kâğıt çek |
| `wallet_screenshot` | `files` | Bir cüzdanın veya hesap bakiyesinin ekran görüntüsü |
| `government_id` | `files` | Devlet tarafından verilmiş kimlik |
| `proof_of_address` | `files` | Son 3 ay içinde düzenlenmiş adres kanıtı |
| `utility_bill` | `files` | Son 3 ay içinde düzenlenmiş fatura |
| `insurance_card` | `files` | Son 3 ay içinde düzenlenmiş sigorta kartı |
| `company_documents` | `files` | Hesap veya tüzel kişilik belgeleri |

### İnceleme soruları

| Gereksinim | Tür | Ne gönderilmeli |
| - | - | - |
| `anything_else` | `text` veya `files` | İnceleme ekibinin bilmesi gereken başka herhangi bir şey |
| `accept_tos` | `text` | Kullanıcının hizmet koşullarını kabul ettiğine dair onay |
| `signature` | `files` | Bir sözleşme için imza görüntüsü |


## Related topics

- [Doğrulama](https://docs.whop.com/tr/api-reference/legacy/verifications/verification.md)
- [RfiElement](https://docs.whop.com/tr/elements/latest/verifications/rfi.md)
- [Doğrulama Durumunu Kontrol Etme](https://docs.whop.com/tr/developer/verification/retrieve.md)
