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

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 İstek - Json

{
    "FullName": "Test User",
    "Email": "[email protected]",
    "PhoneNumber": "[phone]",
    "OwnerType": 1, // 1: Individual | 2: Corporate
    "TaxNumber": "", // for Corporate
    "IdentityNumber": null, // for individual
    "Address": "address",
    "Country": "country",
    "City": "city",
    "DateOfBirth": "2030-10-15",
    "CompanyName": ""
}

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.0704931Z",
        "UpdatedAt": null
    }
}

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 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)

Parametre	Tip	Açıklama
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.
Email	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.