16. Bakiye Sorgula (Wallet)

Belirli bir cüzdana ait bakiye sorgulamasını bu servis aracılığıyla sorgulayabilirsiniz

Cüzdan 'Id' ile Bakiye Sorgula

GET{{WalletUrl}}/api/v1/wallet/balance/by/id/{id:guid}

Not: Bu servisin kullanılabilmesi için apikeypublic ve apiclientpublic parametrelerinin Header alanına eklenmiş olması zorunludur.

WalletAPI Adresi

Gerekli header ve istek parametreleri:

Parametreler ve Açıklamaları

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	API erişimi için kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	API'ye bağlanan istemcinin kimliğini tanımlayan bilgidir.

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
IsFailure	bool	İşlemin başarısız olup olmadığını belirtir.
IsSuccess	bool	İşlemin başarılı olup olmadığını belirtir.
Errors	Array	İşlem sırasında oluşan hata bilgilerini listeler.
Value	Array<Items>	İşlem sonucu dönen veri listesidir.
Id	Guid	Cüzdanın benzersiz kimlik numarasıdır.
Name	String	Cüzdan sahibinin ad bilgisidir.
Alias	String	Cüzdan için tanımlanan alternatif ad bilgisidir.
WalletBalance	Decimal	Cüzdandaki toplam bakiyeyi döner. * GiftBalance içermez
GiftBalances	List	Cüzdana tanımlanmış hediye bakiyelerin listesini dönmektedir
GiftBalances > Id	Guid	Hediye bakiye kaydının benzersiz tanımlayıcısı.
GiftBalances > Amount	Decimal	Hediye bakiyenin tanımlandığı andaki toplam tutarı.
GiftBalances > RemainingAmount	Decimal	Hediye bakiyenin kalan kullanılabilir tutarı.
GiftBalances > ExpirationDate	DateTime	Hediye bakiyenin son kullanma tarihi. null ise süresizdir.
GiftBalances > IsUnlimited	bool	ExpirationDate değeri null ise true döner, hediye bakiyenin süresiz olduğunu belirtir.
GiftBalances > Description	String	Hediye bakiyeye ait açıklama veya not.
GiftBalances > CreatedAt	DateTime	Hediye bakiye kaydının oluşturulma tarihi ve saati (UTC).
TotalGiftBalance	Decimal	Cüzdandaki toplam hediye bakiyesini döner
BlockedBalance	Decimal	Kullanılamayan (bloke edilmiş) bakiyeyi döner
TotalBalance	Decimal	Cüzdan içerisindeki toplam bakiye Formül: WalletBalance + TotalGiftBalance
AvailableBalance	Decimal	Cüzdan içerisindeki kullanılabilir bakiye. Bu bakiye hediye bakiyeleri de kapsamaktadır. Ek olarak bloklu bakiye varsa kullanılabilir bakiye miktarı bloklu bakiye kadar düşmektedir Formül: (WalletBalance + TotalGiftBalance) - BlockedBalance
AllowOverdraft	bool	Cüzdanın eksi bakiyeye düşmesine izin verilip verilmediğini belirtir. true ise bakiye sıfırın altına inebilir.
OverdraftLimit	Decimal	Cüzdanın düşebileceği maksimum eksi bakiye limitini belirtir. AllowOverdraft = true olduğunda geçerlidir. null ise limit tanımlanmamış demektir.

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Name": "External Test Wallet",
        "Alias": "2816220769",
        "WalletBalance": 0.80,
        "GiftBalances": [
            {
                "Id": "aa230ce5-127d-44a0-b480-7f9c4a24a9fd",
                "Amount": 10.00,
                "RemainingAmount": 7.50,
                "ExpirationDate": "2025-12-31T23:59:59Z",
                "IsUnlimited": false,
                "Description": "Hoşgeldin bonusu",
                "CreatedAt": "2025-08-20T10:09:37.007Z"
            }
        ],
        "TotalGiftBalance": 7.50,
        "BlockedBalance": 0,
        "TotalBalance": 8.30,
        "AvailableBalance": 8.30,
        "AllowOverdraft": false,
        "OverdraftLimit": null
    }
}