2. Oluştur
Yeni bir cüzdan sahibi kaydı oluşturmak için bu sayfadaki servis üzerinden gerekli parametrelerle birlikte API çağrısı yapılmalıdır
Cüzdan Sahibi Oluşturma
POST {{Base Adres}}/api/v1/walletowner
Servise gönderilmesi gereken parametreler şu şekildedir:
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.
{
"FullName": "Test User",
"Email": "[email protected]",
"PhoneNumber": "+9052323200000",
"OwnerType": 1, // 1: Individual | 2: Corporate
"TaxNumber": "", // for Corporate
"IdentityNumber": null, // for individual
"Address": "address",
"Country": "country",
"City": "city",
"DateOfBirth": "2030-10-15",
"CompanyName": ""
}{
"IsSuccess": true,
"IsFailure": false,
"Value": {
"Id": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
"Fullname": "Enes Selman",
"Email": "[email protected]",
"PhoneNumber": "+905359023987",
"TaxNumber": "8430816988",
"IdentityNumber": null,
"OwnerType": "Corporate",
"CompanyName": "test",
"Address": "address",
"Country": "country",
"City": "city",
"DateOfBirth": "2030-10-15",
"CreatedAt": "2025-08-20T09:59:58.0704931Z",
"UpdatedAt": null
}
}Servis Cevap
IsFailure
bool
API yanıtının başarısızlık içerip içermediğini belirtir. True ise işlem olumsuz sonuçlanmıştır. İşlem akışında bu değer kontrol edilmelidir.
IsSuccess
bool
API çağrısının başarılı tamamlanıp tamamlanmadığını gösterir. True dönerse sonuç geçerli kabul edilir. Durum analizlerinde bu alan esas alınır.
Errors
Array
İşlem sırasında oluşan hatalara ilişkin detaylı mesaj listesidir. Sorunlu durumların raporlanmasında kullanılır. Geribildirim mekanizmasına katkı sağlar.
Value
Array<Items>
İşlemin sonucunda dönen veri nesnesidir. İçerdiği veri tipi endpoint'e göre farklılık gösterebilir. Geri dönen içeriğin ana taşıyıcısıdır.
Servis Cevap (Value)
Id
Guid
Sistem tarafından tanımlanan, her kullanıcıya özel benzersiz kimlik değeridir. Uygulama içi referans olarak kullanılır.
Fullname
string
Cüzdan sahibinin ad ve soyad bilgisini bir arada tutar. Kimlik bilgisi olarak gösterimlerde yer alır.
string
Kullanıcının kayıtlı e-posta adresidir. Bildirimler, uyarılar ve iletişim kanalları bu adres üzerinden yürütülür.
PhoneNumber
string
Kullanıcıya ait telefon numarası bilgisidir. Gerekli durumlarda doğrulama süreçlerinde işleme alınır.
TaxNumber
string
Vergi mükellefi kullanıcılar için tanımlanmış vergi numarası bilgisidir. Vergisel işlemlerde aktif olarak kullanılır.
IdentityNumber
string
Gerçek kişilere özel tanımlanan kimlik numarasıdır. Kimlik doğrulama ve KYC süreçlerinde başvuru kaynağıdır.
OwnerType
string
Cüzdan sahibinin türünü belirtir. Geçerli değerler: MERCHANT, SUB_MERCHANT. Kapsam belirleyici bir parametredir.
CompanyName
string
Tüzel kullanıcılar için geçerli olan firma adını belirtir. Şirket bazlı işlemlerde görüntülenir.
Address
string
Kullanıcının kayıt sırasında sağladığı adres bilgisidir. Lojistik ve yerelleştirme ihtiyaçlarında kullanıma açıktır.
Country
string
Cüzdan sahibinin ülke konumunu ifade eder. Bölgesel kısıtlamalarda ve kampanya hedeflemelerinde baz alınır.
City
string
Adresin şehir bilgisidir. Bölge bazlı filtrelemelerde kullanılabilir.
DateOfBirth
Date
Kullanıcının doğum tarihini belirtir. Gerçek kişilere özel kayıt sürecinin parçasıdır.
CreatedAt
DateTime
Kullanıcının sistemde oluşturulduğu tarih ve saat bilgisidir. Log analizlerinde temel izleme alanıdır.
UpdatedAt
DateTime
Kullanıcıya ait bilgilerin son güncellendiği zamanı gösterir. Değişiklik takibinde esas alınır.
Last updated