5. Güncelleme

Mevcut bir cüzdan sahibi kaydını güncellemek için bu sayfadaki servis, gerekli parametrelerle birlikte kullanılmalıdır.

Cüzdan Sahibi Bilgilerini Güncelle

PUT {{WalletUrl}}/api/v1/walletowner

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	API erişimi sırasında kimlik doğrulaması sağlamak amacıyla gönderilen genel anahtardır. Güvenlik kontrolü bu değer üzerinden yapılır.
apiclientpublic	string	Evet	İstek yapan uygulamayı tanımlayan istemci anahtarıdır. API çağrılarının yetkilendirilmesinde kullanılır.

Servis İstek - Json

{
  "Id": "0000-0000-0000-0000-0000",
  "Name": "{{$randomFullName}}",
  "Email": "{{$randomEmail}}",
  "PhoneNumber": "[phone]",
  "Address": "{{$randomStreetAddress}}",
  "Country": "{{$randomCountry}}",
  "City": "{{$randomCity}}",
  "DateOfBirth": "2001-03-03",
  "CompanyName": "{{$randomCompanyName}}"
}

Servis Cevap - Json

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
        "Fullname": "Enes Selman",
        "Email": "[email protected]",
        "PhoneNumber": "[phone]",
        "TaxNumber": "8430816988",
        "IdentityNumber": null,
        "OwnerType": "Corporate",
        "CompanyName": "test",
        "Address": "address",
        "Country": "country",
        "City": "city",
        "DateOfBirth": "2030-10-15",
        "CreatedAt": "2025-08-20T09:59:58.070493Z",
        "UpdatedAt": "2025-08-20T10:01:07.7344151Z"
    }
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	Servis yanıtında bir hata olup olmadığını belirtir. true olması, işlemin hatalı sonuçlandığını gösterir. Değerlendirme yapılırken dikkate alınmalıdır.
IsSuccess	bool	İşlemin beklenildiği şekilde tamamlanıp tamamlanmadığını bildirir. true değeri başarılı yürütmeyi işaret eder. Sonuç kontrolünde referans alınır.
Errors	Array	Servis çağrısı sırasında oluşan hata bilgilerini içerir. Hatalar çoğunlukla hata kodu ve açıklama ile birlikte sunulur. Sorun tespitinde kullanılır.
Value	Array<Items>	Servisin döndürdüğü temel veri içeriğini temsil eder. Sonuçlar bu alan üzerinden kullanıcıya aktarılır. Dönüş tipi yapılan işleme göre değişkenlik gösterebilir.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	Cüzdan sahibine sistem tarafından atanan benzersiz tanımlayıcı (UUID) değerdir. Veri bütünlüğünü sağlamak amacıyla kullanılır.
Fullname	string	Kullanıcının ad ve soyad bilgisini içeren metinsel ifadedir. Kimlik doğrulama ve temsil amaçlı kullanılır.
Email	string	Kullanıcının sistemde tanımlı e-posta adresidir. Bildirim, yetkilendirme ve iletişim işlemlerinde referans alınır.
PhoneNumber	string	Cüzdan sahibine ait GSM numarasıdır. Doğrulama kodları ve iki faktörlü kimlik doğrulama süreçlerinde kullanılır.
TaxNumber	string	Kurumsal kullanıcılar için geçerli olan Vergi Kimlik Numarası’dır (VKN). Vergisel yükümlülüklerde sistemsel kontrol sağlar.
IdentityNumber	string	Gerçek kişiler için geçerli olan Türkiye Cumhuriyeti Kimlik Numarası’dır (TCKN). KYC süreçlerinde sorgulama için gereklidir.
OwnerType	string	Cüzdan sahibinin sistemdeki rol tipini belirtir. Kabul edilen değerler: MERCHANT, SUB_MERCHANT. Veri modeli hiyerarşisini tanımlar.
CompanyName	string	Tüzel kullanıcılar için kayıtlı ticari unvandır. Fatura, işlem geçmişi ve kullanıcı arayüzü gösterimlerinde kullanılır.
Address	string	Kullanıcının sistemde kayıtlı tam adres bilgisidir. Kurye, belge gönderimi ve faturalama işlemleriyle ilişkilidir.
Country	string	Kullanıcının bulunduğu ülkenin ISO 3166-1 alpha-2 formatındaki ülke kodudur. Lokasyon bazlı servis kısıtlarında kullanılır.
City	string	Kullanıcının adresine ait şehir bilgisidir. Bölgesel ayrım ve analizlerde referans alınır.
DateOfBirth	Date	Gerçek kişi kullanıcılar için geçerli doğum tarihidir. Format: YYYY-MM-DD. Yaş sınırlı işlemlerde doğrulama kriteridir.
MerchantId	int	Cüzdan sahibinin bağlı olduğu üye işyeri (merchant) kimliğidir. Alt kullanıcı ilişkileri bu ID üzerinden kurulmaktadır.
CreatedAt	DateTime	İlgili kaydın sistem üzerinde ilk oluşturulduğu tarih-saat bilgisidir. Zaman damgası (timestamp) formatında tutulur.
UpdatedAt	DateTime	En son yapılan güncellemeye ait zaman bilgisidir. Değişiklik takibi ve senkronizasyon işlemlerinde kullanılır.