5. Sorgula (Alias)

Tanımlanan hediye bakiyeyi, tanımlandığı alias bilgisiyle sorgulamak için bu servisi kullanabilirsiniz

Hediye Bakiye 'Alias' ile Kayıt Sorgulama

GET{{WalletUrl}}/api/v1/balance/gift/by/alias/{alias}

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şiminde doğrulama için kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	İsteğin hangi istemciden geldiğini gösteren genel istemci anahtarıdır.
Alias	string	Evet	Hediye bakiyeleri listelenecek cüzdanın alias'ı
IncludeExpired	bool	Hayır	Süresi dolmuş hediye bakiyelerin listeye dahil edilip edilmeyeceğini belirtir. Varsayılan: false
IncludeFullyUsed	bool	Hayır	Tamamen kullanılmış hediye bakiyelerin listeye dahil edilip edilmeyeceğini belirtir. null ise filtre uygulanmaz

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
IsFailure	bool	İşlem başarısızsa false, değilse true döner.
IsSuccess	bool	İşlem başarılıysa true, aksi halde false döner.
Errors	Array	Oluşan hata detaylarını içeren dizi yapısıdır.
TotalAmount	int	Cüzdandaki tüm bakiye kayıtlarının başlangıç tutarlarının toplamıdır. Kullanılmış veya kalan tutardan bağımsız olarak tanımlanan toplam bakiyeyi ifade eder.
TotalRemainingAmount	int	Cüzdandaki tüm bakiye kayıtlarında henüz kullanılmamış (harcanabilir) tutarların toplamıdır.
Items	Array	Sonuç verilerini içeren öğe listesini barındırır.
Id	Guid	Sistemde bu varlığı benzersiz şekilde tanımlayan kimliktir.
WalletId	Guid	Kaydın bağlı olduğu cüzdanın eşsiz ID bilgisidir.
Amount	string	Tanımlanan toplam bakiye bilgisini metinsel olarak tutar.
RemainingAmount	decimal	Mevcut bakiye içerisinden harcanmamış kalan kısmı ifade eder.
ExpirationDate	decimal	Bakiyenin sona ereceği tarihi timestamp formatında temsil eder.
IsUnlimited	string	Hediye bakiyenin süresiz olup olmadığını belirtir. ExpirationDate değeri null ise true döner ve hediye bakiyenin son kullanma tarihi olmadığını ifade eder.
Description	string	Bakiye veya işlemin açıklamasıdır, kullanıcıya bilgi verir.
IsUsed	bool	Hediye bakiye kullanıldı mı?
IsFullyUsed	bool	Hediye bakiye tamamen kullanıldı mı?
IsPartiallyUsed	bool	Hediye bakiye kısmi kullanıldı mı?
LastTransactionId	Guid	Bu bakiyeyi kullanan son işlemin kimliğidir.
CreatedAt	Guid	Hediye bakiyenin oluşturulma tarihi
UpdatedAt	int	Hediye bakiyenin güncellenme tarihi

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "totalAmount": 200.00,
    "totalRemainingAmount": 200.00,
    "Items": [
        {
            "Id": "29bddd16-16d1-4b16-bca9-906f9ef80725",
            "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
            "Amount": 100.00,
            "RemainingAmount": 100.00,
            "ExpirationDate": "2025-11-10T21:00:00Z",
            "IsUnlimited": false,
            "Description": "External Gift Balance",
            "IsUsed": false,
            "IsFullyUsed": false,
            "IsPartiallyUsed": false,
            "LastTransactionId": null,
            "CreatedAt": "2025-08-20T14:32:16.468416Z",
            "UpdatedAt": null
        },
        {
            "Id": "47c4ec69-58d2-415c-841e-c1144542181b",
            "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
            "Amount": 100.00,
            "RemainingAmount": 100.00,
            "ExpirationDate": null,
            "IsUnlimited": true,
            "Description": "External Gift Balance",
            "IsUsed": false,
            "IsFullyUsed": false,
            "IsPartiallyUsed": false,
            "LastTransactionId": null,
            "CreatedAt": "2025-08-20T14:33:15.741943Z",
            "UpdatedAt": null
        }
    ]
}