1. Oluştur (Wallet)

Cüzdanlara hediye bakiye tanımlamak için bu servisi kullanabilirsiniz

Cüzdan 'Id' ile Hediye Bakiye Oluştur

POST{{WalletUrl}}/api/v1/balance/gift

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

WalletAPI Adresi

Servise gönderilmesi gereken parametreler şu şekildedir:

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	API servislerine genel erişimi sağlayan ortak anahtar bilgisidir.
apiclientpublic	string	Evet	İstemci uygulamayı tanımlayan açık istemci anahtar bilgisidir.

Servis İstek - Json

{
    "WalletId": "92858707-7718-435c-9ba3-3d702a3bea9b",
    "Amount": 100.00,
    "ExternalReference": "{{$guid}}",
    "ExpirationDate": "2025-11-11",
    "Description": "External Gift Balance"
}

Servis İstek

Parametre	Tip	Açıklama
WalletId	Guid	Hediye bakiyenin tanımlanacağı cüzdan kimlik bilgisi
Amount	decimal	Tanımlanacak hediye bakiye
ExpirationDate	DateTime?	Eğer ilgili hediye bakiye belirli bir tarihe kadar geçerli olsun istiyorsanız. Tarih tanımı yapabilirsiniz. Eğer tarih verirseniz, ilgili tutar o tarihe kadar harcanmazsa otomatik olarak kullanım dışı kalır. Eğer tarih verilmezse, ilgili tutar kullanılana kadar cüzdanda tanımlı kalır
Description	string	Verilen hediye bakiyenin açıklaması Örnek: "Doğum günü"
ExternalReference	string	İşlemin sisteminiz tarafından takip edilebilmesi için takip numarası

Servis Cevap - Json

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "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",
        "LastTransactionId": null,
        "CreatedAt": "2025-08-20T14:32:16.468416Z",
        "UpdatedAt": null
    }
}

Servis Cevap

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.

Servis Cevap (Value)

Parametre	Tip	Açıklama
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 tutar bilgisini metinsel olarak tutar.
RemainingAmount	decimal	Mevcut bakiye içerisinden harcanmamış kalan kısmı ifade eder.
ExpirationDate	decimal	Tutarın sona ereceği tarihi timestamp formatında temsil eder.
IsUnlimited	string	Bakiye için geçerlilik süresi sınırsız mı bilgisini tutar ("true"/"false").
Description	string	Tutarın veya işlemin açıklamasıdır, kullanıcıya bilgi verir.
LastTransactionId	Guid	Bu bakiyeyi kullanan son işlemin kimliğidir.
CreatedAt	Guid	Kaydın oluşturulma tarihidir (muhtemelen veri tipi DateTime olmalıdır).
UpdatedAt	int	Kaydın en son ne zaman güncellendiğini gösteren UNIX zaman damgasıdır.