3. Getir

Belirli bir cüzdan sahibinin detaylarını almak için bu sayfa üzerindeki servis, uygun parametrelerle kullanılmalıdır

Cüzdan Sahibi Detayını Getir

GET {{WalletUrl}}/api/v1/walletowner/by/id/529a2e8a-fd42-43d5-a87f-49b3c6a5c145

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

WalletAPI Adresi

Servise gönderilmesi gereken parametreler şu şekildedir:

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	Üye işyeri paneli üzerinden oluşturulan ve API çağrılarında kimlik doğrulama amacıyla kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	Üye işyeri paneli üzerinden oluşturulan ve API erişiminde istemci bilgisini tanımlayan genel istemci anahtarıdır.

Servis Cevap - Json

{
    "Value": {
        "Id": "529a2e8a-fd42-43d5-a87f-49b3c6a5c145",
        "Fullname": "yiğit",
        "Email": "[e-mail]",
        "PhoneNumber": "[phone]",
        "TaxNumber": "",
        "IdentityNumber": "11111111110",
        "OwnerType": "Individual",
        "CompanyName": "Gutkowski - Turcotte",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "MerchantId": 2071,
        "CreatedAt": "2025-04-21T20:11:59.611512Z",
        "UpdatedAt": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	API yanıtının başarısızlık içerip içermediğini belirtir. True dönerse işlem olumsuz şekilde sonuçlanmış demektir. Kontrol mekanizmalarında dikkate alınmalıdır.
IsSuccess	bool	İşlemin sistem tarafından başarıyla tamamlandığını gösteren mantıksal bir değerdir. Başarılı işlemlerde true olarak geri döner. Doğrulama süreçlerinde kullanılır.
Errors	Array	Servis çağrısı sırasında oluşabilecek hataların detaylarını barındırır. Hata açıklamaları genellikle hata kodlarıyla birlikte döner. Yanıttaki problem kaynağını gösterir.
Value	Array<Items>	API çağrısına ait asıl veri çıktısını temsil eder. Dönen yanıt bu alan üzerinden sunulur. İçerdiği veri türü kullanılan endpoint’e bağlıdır.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	Cüzdan sahibine özel sistem tarafından atanmış tanımlayıcı numaradır. Diğer işlemlerde referans olarak kullanılır.
Fullname	string	Kullanıcının isim ve soyisim bilgisini birleştiren tam ad alanıdır. Arayüzlerde gösterim için kullanılır.
Email	string	Cüzdan sahibinin kayıtlı e-posta adresidir. İletişim ve bildirim servisleri bu alan üzerinden çalışır.
PhoneNumber	string	Kullanıcının cep telefonu bilgisini içerir. Giriş ve doğrulama adımlarında işleme alınır.
TaxNumber	string	Vergisel sorumluluğu olan kullanıcılar için kullanılan vergi kimlik numarası bilgisidir. İşlem kısıtlamalarında kontrol edilir.
IdentityNumber	string	Gerçek kişilere özel tanımlanan ulusal kimlik numarasıdır. Kimlik teyidi gerektiren işlemlerde kullanıma sunulur.
OwnerType	string	Sistemde tanımlı cüzdan sahibinin türünü belirtir. MERCHANT ya da SUB_MERCHANT olarak değer alabilir.
CompanyName	string	Tüzel kişi kullanıcıların şirket adı bu alanda tutulur. Kurumsal profillerde görüntülenir.
Address	string	Cüzdan sahibinin beyan ettiği açık adres bilgisidir. Fiziksel işlemler veya raporlamada ihtiyaç duyulur.
Country	string	Kullanıcının kayıt sırasında belirttiği ülke bilgisidir. Hizmet kapsamı bu alana göre filtrelenebilir.
City	string	Cüzdan sahibinin bulunduğu şehir bilgisidir. Lokasyon bazlı analizlerde kullanıma uygundur.
DateOfBirth	Date	Gerçek kişi kullanıcıların doğum tarihidir. Yaşa bağlı işlemlerde kontrol amacıyla sorgulanır.
MerchantId	int	Cüzdan sahibinin bağlı bulunduğu üye iş yerine ait sistem kimliğidir. Alt ilişkili kayıtlar bu ID ile bağlanır.
CreatedAt	DateTime	Kullanıcı kaydının oluşturulduğu tarih ve saat bilgisi bu alanda tutulur. Sistemsel izleme süreçlerinde kullanılır.
UpdatedAt	DateTime	Cüzdan sahibine ait verilerin en son ne zaman güncellendiğini ifade eder. Değişim takibi bu alanla yapılır.