1. Liste

Cüzdan sahipleri (kullanıcılar) listesine bu sayfadaki servisle erişebilirsiniz

Cüzdan Sahibi Listesi

GET {{Base Adres}}/api/v1/walletowner?OwnerType=1&PageNumber=1&PageSize=10

Not: Bu servisi çağırmadan önce, apikeypublic ve apiclientpublic parametrelerini Header kısmına eklemeniz gereklidir.

WalletAPI Adresi

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

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Public Key.
apiclientpublic	string	Evet	Üye işyeri panelinden temin etmiş olduğunuz Public Client.

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

Parametre	Açıklama
OwnerType	Listelenmek istenen cüzdan sahip tipleri Bkz: Cüzdan Sahip Tipleri
PageNumber	Kaçıncı sayfayı listelemek istiyorsunuz
PageSize	Sayfada kaç adet kayıt istiyorsunuz

Servis Cevap - Json

{
    "Items": [
        {
            "Id": "59cba0b2-6c2a-43b0-a560-2f795ea6dea8",
            "Fullname": "yiğit",
            "Email": "[e-mail]",
            "PhoneNumber": "[phone]",
            "TaxNumber": "",
            "IdentityNumber": null,
            "OwnerType": "Individual",
            "CompanyName": "Jones, Kerluke and Abshire",
            "Address": "address",
            "Country": "country",
            "City": "city",
            "DateOfBirth": "2030-10-15",
            "MerchantId": 2071,
            "CreatedAt": "2025-04-09T10:29:00.452264Z",
            "UpdatedAt": null
        }
    ],
    "PageNumber": 1,
    "TotalPages": 1,
    "TotalCount": 1,
    "HasPreviousPage": false,
    "HasNextPage": false,
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	İş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ı.
IsSuccess	bool	İş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ı.
Errors	Array	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.
HasNextPage	bool	Sonraki sayfanın olup olmadığını gösterir. Sayfalama işlemleri için kullanılır. Ek geliştirmeler uygulandı.
HasPreviousPage	bool	Önceki sayfanın mevcut olup olmadığını bildirir. Sayfa geçişi kurgusunda önemlidir. Yapı optimize edildi.
TotalCount	int	Tüm filtrelenmiş sonuçların toplam adedini verir. Listeleme işlemlerinin temel referansıdır. Arka plan servisi ile entegre edilmiştir.
TotalPages	int	Sayfalama sonucunda oluşan toplam sayfa sayısını belirtir. Dinamik sonuç yapılarında önemlidir. Parametre standardına uygun tanımlanmıştır.
Items	Array<Items>	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.

Servis Cevap (Items)

Parametre	Tip	Açıklama
Id	Guid	Her cüzdan sahibine sistem tarafından atanmış benzersiz kimliktir. İç süreçlerle senkronize edilmiştir.
Fullname	string	Cüzdan sahibinin tam ad bilgisidir. Hem bireysel hem de tüzel kullanımlarda gereklidir.
Email	string	Kullanıcının sistemde tanımlı e-posta adresidir. Bildirim ve iletişim için kullanılır.
PhoneNumber	string	Cüzdan sahibinin kayıtlı cep telefonu numarasıdır. Doğrulama süreçlerinde aktif rol oynar.
TaxNumber	string	Vergi mükellefi olan kullanıcılar için geçerli vergi kimlik numarasıdır. Kontrol sistemiyle ilişkilendirilmiştir.
IdentityNumber	string	Gerçek kişiler için zorunlu olan kimlik numarasıdır. Kimlik doğrulama servislerine bağlanır.
OwnerType	string	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.
CompanyName	string	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.
Address	string	Kullanıcının kayıtlı açık adres bilgisidir. Gönderim ve raporlama gibi ihtiyaçlarda gereklidir.
Country	string	Cüzdan sahibinin bulunduğu ülke bilgisidir. Bölgesel hizmetlerde referans alınır.
City	string	Kayıt sırasında belirtilen şehir bilgisidir. Lokasyon bazlı filtrelerde kullanılır.
DateOfBirth	Date	Gerçek kişi cüzdan sahiplerinin doğum tarihidir. Kullanıcı profili tamamlayıcısıdır.
MerchantId	int	Cüzdan sahibinin bağlı olduğu üye işyeri kimliğidir. Sistem içi bağlantıyı temsil eder.
CreatedAt	DateTime	Cüzdan sahibinin sisteme ilk kaydedildiği tarih ve zaman bilgisidir. Takip açısından önem taşır.
UpdatedAt	DateTime	İlgili kullanıcıya ait bilgilerin en son güncellendiği zamanı belirtir. Versiyonlama açısından dikkate alınır.