# 1. Liste

## Cüzdan Sahibi Listesi

<mark style="color:blue;">`GET`</mark> `{{Base Adres}}/api/v1/walletowner?OwnerType=1&PageNumber=1&PageSize=10`

{% 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>](https://developer.paywall.one/ortam)
{% endhint %}

**Servise gönderilmesi gereken (Header) 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 panelinden temin etmiş olduğunuz Public Key.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>Üye işyeri panelinden temin etmiş olduğunuz Public Client.</td></tr></tbody></table>

**Servise gönderilmesi gereken (QueryString) parametreler şu şekildedir:**

<table><thead><tr><th width="162">Parametre</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>OwnerType</td><td>Listelenmek istenen cüzdan sahip tipleri<br><br>Bkz: <a href="../sistem-verileri/cuzdan-sahip-tipleri">Cüzdan Sahip Tipleri</a></td></tr><tr><td>PageNumber</td><td>Kaçıncı sayfayı listelemek istiyorsunuz</td></tr><tr><td>PageSize</td><td>Sayfada kaç adet kayıt istiyorsunuz</td></tr></tbody></table>

{% tabs fullWidth="false" %}
{% tab title="Servis Cevap - Json" %}
{% code overflow="wrap" lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Items": [
            {
                "Id": "e9e1ba5f-a713-450e-8689-1e1d7945d5d8",
                "Fullname": "John Doe",
                "Email": "Merlin23@hotmail.com",
                "PhoneNumber": "+905359119854",
                "TaxNumber": "6597439626",
                "IdentityNumber": null,
                "OwnerType": "Corporate",
                "CompanyName": "test",
                "Address": "address",
                "Country": "country",
                "City": "city",
                "DateOfBirth": "2030-10-15",
                "CreatedAt": "2025-08-20T09:58:38.199108Z",
                "UpdatedAt": null
            },
            {
                "Id": "25beac63-5d86-4cb7-92b9-3c93a95471e1",
                "Fullname": "John Doe",
                "Email": "Aubree.Crist@hotmail.com",
                "PhoneNumber": "+905314234411",
                "TaxNumber": "9377336901",
                "IdentityNumber": null,
                "OwnerType": "Corporate",
                "CompanyName": "test",
                "Address": "address",
                "Country": "country",
                "City": "city",
                "DateOfBirth": "2030-10-15",
                "CreatedAt": "2025-08-20T09:58:31.095775Z",
                "UpdatedAt": null
            },
            {
                "Id": "ee66c4a2-51f9-4a5b-857f-1c4173e30dad",
                "Fullname": "John Doe",
                "Email": "Cortney84@yahoo.com",
                "PhoneNumber": "+905367788091",
                "TaxNumber": "7060114232",
                "IdentityNumber": null,
                "OwnerType": "Corporate",
                "CompanyName": "test",
                "Address": "address",
                "Country": "country",
                "City": "city",
                "DateOfBirth": "2030-10-15",
                "CreatedAt": "2025-08-20T09:30:08.083961Z",
                "UpdatedAt": null
            },
            {
                "Id": "eabcc886-c88d-4ee1-890e-ff9ad7ae7baa",
                "Fullname": "John Doe",
                "Email": "Bertha11@hotmail.com",
                "PhoneNumber": "+905349273063",
                "TaxNumber": "3885333885",
                "IdentityNumber": null,
                "OwnerType": "Corporate",
                "CompanyName": "test",
                "Address": "address",
                "Country": "country",
                "City": "city",
                "DateOfBirth": "2030-10-15",
                "CreatedAt": "2025-08-20T09:30:07.405989Z",
                "UpdatedAt": null
            },
            {
                "Id": "df45ab83-c90c-43a6-85fc-eb2cac959834",
                "Fullname": "John Doe",
                "Email": "Jasen.Runte69@hotmail.com",
                "PhoneNumber": "+905300898250",
                "TaxNumber": "4764691204",
                "IdentityNumber": null,
                "OwnerType": "Corporate",
                "CompanyName": "test",
                "Address": "address",
                "Country": "country",
                "City": "city",
                "DateOfBirth": "2030-10-15",
                "CreatedAt": "2025-08-20T09:30:06.064815Z",
                "UpdatedAt": null
            },
            {
                "Id": "0dfa685a-5806-4dba-aafb-677d26112e0e",
                "Fullname": "John Doe",
                "Email": "Philip.Satterfield@yahoo.com",
                "PhoneNumber": "+905378381444",
                "TaxNumber": "4765514878",
                "IdentityNumber": null,
                "OwnerType": "Corporate",
                "CompanyName": "test",
                "Address": "address",
                "Country": "country",
                "City": "city",
                "DateOfBirth": "2030-10-15",
                "CreatedAt": "2025-08-20T09:30:02.903152Z",
                "UpdatedAt": null
            },
            {
                "Id": "b82a1c22-3af6-40e1-9494-7b5f31f6d94f",
                "Fullname": "John Doe",
                "Email": "Lavonne_Hoppe@hotmail.com",
                "PhoneNumber": "+905314265844",
                "TaxNumber": "2944765722",
                "IdentityNumber": null,
                "OwnerType": "Corporate",
                "CompanyName": "test",
                "Address": "address",
                "Country": "country",
                "City": "city",
                "DateOfBirth": "2030-10-15",
                "CreatedAt": "2025-08-20T09:20:42.427165Z",
                "UpdatedAt": null
            },
            {
                "Id": "1223f471-ae54-493d-a7ba-8b138949e962",
                "Fullname": "John Doe",
                "Email": "Litzy_Zboncak@gmail.com",
                "PhoneNumber": "+9052323230004",
                "TaxNumber": "",
                "IdentityNumber": "43276603742",
                "OwnerType": "Individual",
                "CompanyName": "test",
                "Address": "address",
                "Country": "country",
                "City": "city",
                "DateOfBirth": "2030-10-15",
                "CreatedAt": "2025-08-16T19:16:08.211642Z",
                "UpdatedAt": null
            }
        ],
        "PageNumber": 1,
        "TotalPages": 1,
        "TotalCount": 8,
        "HasPreviousPage": false,
        "HasNextPage": false
    }
}
```

{% 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>İşlemin başarısız olup olmadığını belirtir. True değeri dönerse işlem geçersiz sayılır. Gerekli güncellemeler yapıldı.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlemin başarılı şekilde tamamlandığını ifade eder. Başarılı sonuçlar için true değeri alınmalıdır. Versiyon kontrolü sağlandı.</td></tr><tr><td>Errors</td><td>Array</td><td>Hata durumlarında sistemin ürettiği mesajları içerir. Doğru hata yönetimi için kullanılır. Test senaryoları doğrultusunda güncellendi.</td></tr><tr><td>HasNextPage</td><td>bool</td><td>Sonraki sayfanın olup olmadığını gösterir. Sayfalama işlemleri için kullanılır. Ek geliştirmeler uygulandı.</td></tr><tr><td>HasPreviousPage</td><td>bool</td><td>Önceki sayfanın mevcut olup olmadığını bildirir. Sayfa geçişi kurgusunda önemlidir. Yapı optimize edildi.</td></tr><tr><td>TotalCount</td><td>int</td><td>Tüm filtrelenmiş sonuçların toplam adedini verir. Listeleme işlemlerinin temel referansıdır. Arka plan servisi ile entegre edilmiştir. </td></tr><tr><td> TotalPages</td><td>int</td><td>Sayfalama sonucunda oluşan toplam sayfa sayısını belirtir. Dinamik sonuç yapılarında önemlidir. Parametre standardına uygun tanımlanmıştır.</td></tr><tr><td>Items</td><td>Array&#x3C;Items></td><td>O anki sayfada dönen veri kümesini içerir. Genellikle liste formatında sunulur. Veri modeliyle eşleşecek şekilde tanımlanmıştır.</td></tr></tbody></table>

## Servis Cevap (Items)

<table><thead><tr><th>Parametre</th><th>Tip</th><th width="330.10546875">Açıklama</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>Her cüzdan sahibine sistem tarafından atanmış benzersiz kimliktir. İç süreçlerle senkronize edilmiştir.</td></tr><tr><td>Fullname</td><td>string</td><td>Cüzdan sahibinin tam ad bilgisidir. Hem bireysel hem de tüzel kullanımlarda gereklidir.</td></tr><tr><td>Email</td><td>string</td><td>Kullanıcının sistemde tanımlı e-posta adresidir. Bildirim ve iletişim için kullanılır.</td></tr><tr><td>PhoneNumber</td><td>string</td><td>Cüzdan sahibinin kayıtlı cep telefonu numarasıdır. Doğrulama süreçlerinde aktif rol oynar.</td></tr><tr><td>TaxNumber</td><td>string</td><td>Vergi mükellefi olan kullanıcılar için geçerli vergi kimlik numarasıdır. Kontrol sistemiyle ilişkilendirilmiştir.</td></tr><tr><td>IdentityNumber</td><td>string</td><td>Gerçek kişiler için zorunlu olan kimlik numarasıdır. Kimlik doğrulama servislerine bağlanır.</td></tr><tr><td>OwnerType</td><td>string</td><td>Cüzdanın ait olduğu kullanıcı tipini belirtir (MERCHANT, SUB_MERCHANT). Sorgu yapılarında ayrıştırıcı olarak kullanılır.</td></tr><tr><td>CompanyName</td><td>string</td><td>Tüzel kişi cüzdan sahipleri için geçerli şirket adıdır. Kurumsal işlem akışlarına göre alınır.</td></tr><tr><td>Address</td><td>string</td><td>Kullanıcının kayıtlı açık adres bilgisidir. Gönderim ve raporlama gibi ihtiyaçlarda gereklidir.</td></tr><tr><td>Country</td><td>string</td><td>Cüzdan sahibinin bulunduğu ülke bilgisidir. Bölgesel hizmetlerde referans alınır.</td></tr><tr><td>City</td><td>string</td><td>Kayıt sırasında belirtilen şehir bilgisidir. Lokasyon bazlı filtrelerde kullanılır.</td></tr><tr><td>DateOfBirth</td><td>Date</td><td>Gerçek kişi cüzdan sahiplerinin doğum tarihidir. Kullanıcı profili tamamlayıcısıdır.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Cüzdan sahibinin sisteme ilk kaydedildiği tarih ve zaman bilgisidir. Takip açısından önem taşır.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>İlgili kullanıcıya ait bilgilerin en son güncellendiği zamanı belirtir. Versiyonlama açısından dikkate alınır.</td></tr></tbody></table>