4. Oluştur

Sisteme yeni bir veri eklemek için bu servis çağrılmalıdır.

Cüzdan Oluştur

POST {{WalletUrl}}/api/v1/wallet

Not: Servis çağrısından önce apikeypublic ve apiclientpublic bilgilerinin Header alanına eklenmiş olması şarttır.

WalletAPI Adresi

Servise gönderilmesi gereken parametreler şu şekildedir

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	API isteklerinde kimlik doğrulaması için kullanılan genel erişim anahtarıdır.
apiclientpublic	string	Evet	API'yi çağıran istemcinin kimliğini belirten açık anahtar değeridir.

Servis İstek - Json

{
  "WalletOwnerId": "9edb23f2-7362-42a8-8eb4-0c89ffb397b0",
  "Name": "{{$randomFirstName}}",
  "RegionId": 1,
  "CurrencyCode": "try", // usd, eur, all
  "Alias": "1234567890", // 10 digit number
  "Description": "Cüzdanım",
  "AllowOverdraft": false,
  "OverdraftLimit": 0
}

Servis İstek

Parametre	Tip	Açıklama
WalletOwnerId	Guid	Cüzdan sahibinin kimlik bilgisi
Name	string	Cüzdan hesabına verilecek olan isim
RegionId	int	Cüzdan'a ait ülkenin kimlik bilgisi Bkz: Bölgeler
CurrencyCode	string	Para birimi Bkz: Para birimi
Alias	string	Tekil cüzdan numarası
Description	string	Cüzdan hesabına verilecek açıklama

Servis Cevap - Json

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "e75df134-185a-4b2b-b501-719dba2129c4",
        "WalletOwnerId": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
        "Name": "External Test Wallet",
        "Alias": "5746347646",
        "RegionId": 1,
        "CurrencyCode": "TRY",
        "Balance": 0,
        "AvailableBalance": 0,
        "TotalGiftBalance": 0,
        "BlockedBalance": 0,
        "CreatedAt": "2025-08-20T10:04:01.3659489Z",
        "AllowOverdraft": false,
        "OverdraftLimit": 0
    }
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	Yapılan API çağrısının başarısız sonuçlanıp sonuçlanmadığını gösteren alan.
IsSuccess	bool	Servis çağrısının başarılı şekilde tamamlanıp tamamlanmadığını belirten değerdir.
Errors	Array	İstek sırasında oluşan hata bilgilerini listeleyen veri yapısıdır.
Value	Array<Items>	Servisten dönen asıl veri nesnesini temsil eden liste yapısıdır.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	Sistemde kaydedilen varlığın benzersiz kimlik numarasıdır.
WalletOwnerId	Guid	Cüzdan sahibine ait eşsiz kimlik bilgisidir.
Name	string	Cüzdan sahibinin adı veya ticari unvanı bilgisidir.
Alias	string	Cüzdan için atanmış alternatif ad veya kısa isimdir.
MerchantId	Guid	Cüzdanın ilişkili olduğu üye iş yerinin kimlik numarasıdır.
RegionId	string	Cüzdan sahibinin kayıtlı olduğu coğrafi bölgeyi temsil eden koddur.
CurrencyCode	string	Kullanılan para biriminin uluslararası kod bilgisidir (örneğin: TRY, USD).
Balance	decimal	Cüzdanın toplam mevcut bakiyesi bilgisidir.
AvailableBalance	decimal	Kullanılabilir durumdaki bakiye miktarını ifade eder.
TotalGiftBalance	decimal	Cüzdanda bulunan toplam hediye bakiyesi miktarıdır.
BlockedBalance	decimal	Kullanılamayan bloke edilmiş bakiye miktarıdır.
FrozenUntil	DateTime	Cüzdanın dondurulmuş olduğu süre sonuna kadar geçerli olan tarih bilgisidir.
IsFrozen	bool	Cüzdanın şu anda dondurulmuş olup olmadığını gösteren durum bilgisidir.
IsDeleted	bool	Cüzdanın sistemde silinmiş durumda olup olmadığını belirten alandır.
CreatedAt	DateTime	Kaydın sistemde oluşturulduğu tarih ve saat bilgisidir.
UpdatedAt	DateTime	Kaydın sistemde en son güncellendiği zaman bilgisidir.
TransactionId	Guid	Cüzdan hesabından yapılan son işleme ait kimlik bilgisi