# 2. Oluştur

## Cüzdan Sahibi Oluşturma

<mark style="color:yellow;">`POST`</mark> `{{Base Adres}}/api/v1/walletowner`

{% hint style="info" %}
**Not**: Bu servisi çağırmadan önce, **apikeypublic** ve **apiclientpublic** parametrelerini **Header** kısmına eklemeniz gereklidir.

[<mark style="color:green;">**WalletAPI Adresi**</mark>](/ortam.md)
{% endhint %}

**Servise gönderilmesi gereken parametreler şu şekildedir:**

<table><thead><tr><th width="162">Parametre</th><th width="79">Tip</th><th width="107">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Evet</td><td>Üye işyeri paneli üzerinden oluşturulan ve API çağrılarında kimlik doğrulama amacıyla kullanılan genel anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>Üye işyeri paneli üzerinden oluşturulan ve API erişiminde istemci bilgisini tanımlayan genel istemci anahtarıdır.</td></tr></tbody></table>

{% tabs %}
{% tab title="Servis İstek - Json" %}

```json
{
    "FullName": "Test User",
    "Email": "user@gmail.com",
    "PhoneNumber": "+9052323200000",
    "OwnerType": 1, // 1: Individual | 2: Corporate
    "TaxNumber": "", // for Corporate
    "IdentityNumber": null, // for individual
    "Address": "address",
    "Country": "country",
    "City": "city",
    "DateOfBirth": "2030-10-15",
    "CompanyName": ""
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Servis Cevap - Json" %}
{% code lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
        "Fullname": "Enes Selman",
        "Email": "Sienna.Johnson9@yahoo.com",
        "PhoneNumber": "+905359023987",
        "TaxNumber": "8430816988",
        "IdentityNumber": null,
        "OwnerType": "Corporate",
        "CompanyName": "test",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "CreatedAt": "2025-08-20T09:59:58.0704931Z",
        "UpdatedAt": null
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Servis Cevap

<table><thead><tr><th width="192">Parametre</th><th width="147.89192708333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>API yanıtının başarısızlık içerip içermediğini belirtir. True ise işlem olumsuz sonuçlanmıştır. İşlem akışında bu değer kontrol edilmelidir.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>API çağrısının başarılı tamamlanıp tamamlanmadığını gösterir. True dönerse sonuç geçerli kabul edilir. Durum analizlerinde bu alan esas alınır.</td></tr><tr><td>Errors</td><td>Array</td><td>İşlem sırasında oluşan hatalara ilişkin detaylı mesaj listesidir. Sorunlu durumların raporlanmasında kullanılır. Geribildirim mekanizmasına katkı sağlar.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>İşlemin sonucunda dönen veri nesnesidir. İçerdiği veri tipi endpoint'e göre farklılık gösterebilir. Geri dönen içeriğin ana taşıyıcısıdır.</td></tr></tbody></table>

## Servis Cevap (Value)

| Parametre      | Tip      | Açıklama                                                                                                                |
| -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| Id             | Guid     | Sistem tarafından tanımlanan, her kullanıcıya özel benzersiz kimlik değeridir. Uygulama içi referans olarak kullanılır. |
| Fullname       | string   | Cüzdan sahibinin ad ve soyad bilgisini bir arada tutar. Kimlik bilgisi olarak gösterimlerde yer alır.                   |
| Email          | string   | Kullanıcının kayıtlı e-posta adresidir. Bildirimler, uyarılar ve iletişim kanalları bu adres üzerinden yürütülür.       |
| PhoneNumber    | string   | Kullanıcıya ait telefon numarası bilgisidir. Gerekli durumlarda doğrulama süreçlerinde işleme alınır.                   |
| TaxNumber      | string   | Vergi mükellefi kullanıcılar için tanımlanmış vergi numarası bilgisidir. Vergisel işlemlerde aktif olarak kullanılır.   |
| IdentityNumber | string   | Gerçek kişilere özel tanımlanan kimlik numarasıdır. Kimlik doğrulama ve KYC süreçlerinde başvuru kaynağıdır.            |
| OwnerType      | string   | Cüzdan sahibinin türünü belirtir. Geçerli değerler: MERCHANT, SUB\_MERCHANT. Kapsam belirleyici bir parametredir.       |
| CompanyName    | string   | Tüzel kullanıcılar için geçerli olan firma adını belirtir. Şirket bazlı işlemlerde görüntülenir.                        |
| Address        | string   | Kullanıcının kayıt sırasında sağladığı adres bilgisidir. Lojistik ve yerelleştirme ihtiyaçlarında kullanıma açıktır.    |
| Country        | string   | Cüzdan sahibinin ülke konumunu ifade eder. Bölgesel kısıtlamalarda ve kampanya hedeflemelerinde baz alınır.             |
| City           | string   | Adresin şehir bilgisidir. Bölge bazlı filtrelemelerde kullanılabilir.                                                   |
| DateOfBirth    | Date     | Kullanıcının doğum tarihini belirtir. Gerçek kişilere özel kayıt sürecinin parçasıdır.                                  |
| CreatedAt      | DateTime | Kullanıcının sistemde oluşturulduğu tarih ve saat bilgisidir. Log analizlerinde temel izleme alanıdır.                  |
| UpdatedAt      | DateTime | Kullanıcıya ait bilgilerin son güncellendiği zamanı gösterir. Değişiklik takibinde esas alınır.                         |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.paywall.one/cuzdan-servisleri/1.-cuzdan-sahipleri/2.-olustur.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.