5. Güncelleme
Mevcut bir cüzdan sahibi kaydını güncellemek için bu sayfadaki servis, gerekli parametrelerle birlikte kullanılmalıdır.
Last updated
Mevcut bir cüzdan sahibi kaydını güncellemek için bu sayfadaki servis, gerekli parametrelerle birlikte kullanılmalıdır.
Last updated
PUT
{{WalletUrl}}/api/v1/walletowner
Servise gönderilmesi gereken parametreler şu şekildedir:
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.
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.
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.
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.