3. Sorgula (Id)

Tanımlanan hediye bakiyeyi, bakiyenin kimlik (Id) bilgisiyle sorgulamak için bu servisi kullanabilirsiniz

Hediye Bakiye 'Id' ile Kayıt Sorgulama

GET{{WalletUrl}}/api/v1/balance/gift/:id

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.
Id	guid	Evet	Tanımlanan hediye bakiyesinin kimlik bilgisi. Bu bilgi oluşturulma anında Paywall API'sinden dönmektedir

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.
Value	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,
    "Value": {
        "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
    }
}