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

Gerekli header ve istek parametreleri:

Zorunlu header parametreleri

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.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
WalletId	Guid	Evet	Hediye bakiyenin tanımlanacağı cüzdan kimlik bilgisi
Amount	decimal	Evet	Tanımlanacak hediye bakiye
ExternalReference	string	Evet	İşlemin sisteminiz tarafından takip edilebilmesi için takip numarası
ExpirationDate	DateTime	Hayır	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	Hayır	Verilen hediye bakiyenin açıklaması Örnek: "Doğum günü"
ExternalTransactionTypeId	integer	Hayır	Kendi sisteminizdeki bir işlem tipini bizim sistemimize ekledikten sonra size verdiğimiz id.
ExternalTransactionTypeEnum	integer	Hayır	Kendi sisteminizdeki bir işlem tipini bizim sistemimize eklerken verdiğiniz unique değer.

İş Kuralları

• ExternalReference aynı Merchant kapsamında benzersiz olmalıdır.

• Bir cüzdana en fazla 100 adet hediye bakiye tanımlanabilir. Bu limit aşıldığında yeni kayıt oluşturulamaz.

• Son kullanma tarihi belirtilmeden oluşturulan hediye bakiyeler süresiz kabul edilir. Dönüş modelinde ExpirationDate alanı boş, IsUnlimited alanı true olarak döner.

• Hediye bakiye başarıyla oluşturulduğunda sistem tarafından otomatik olarak GiftBalanceAdded tipinde bir işlem kaydı oluşturulur ve ExternalReference bu kayıtla ilişkilendirilir.

Servise gönderilecek örnek bir JSON dosyası şu şekildedir :

JSON

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

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.
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.

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
    }
}