2. Oluştur (Alias)

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

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

POST{{WalletUrl}}/api/v1/balance/gift/by/wallet/alias

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

{
    "Alias": "2816220769",
    "Amount": 100.00,
    "ExternalReference": "{{$guid}}",
    "ExpirationDate": null,
    "Description": "External Gift Balance"
}

Servis İstek

Parametre	Tip	Açıklama
Alias	string	Hediye bakiyenin tanımlanacağı cüzdan numarası
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": "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",
        "LastTransactionId": null,
        "CreatedAt": "2025-08-20T14:33:15.741943Z",
        "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	Bu kayda özel sistem tarafından atanmış ID'dir.
WalletId	Guid	Hangi cüzdanla ilişkili olduğunu gösteren kimlik numarasıdır.
Amount	string	Kullanıcıya tanımlanan toplam tutar (örneğin: "100.00").
RemainingAmount	decimal	Kullanıcının harcayabileceği mevcut bakiye.
ExpirationDate	decimal	Bu tutarın geçerli olduğu son tarih.
IsUnlimited	string	Süresiz geçerliliğe sahip olup olmadığını belirtir.
Description	string	Bu tutarın amacı veya açıklayıcı notu.
IsUsed	DateTime	İlk harcama işleminin gerçekleştiği zaman.
IsFullyUsed	DateTime	Kullanıcının tüm tutarı kullandığı zaman.
IsPartiallyUsed	decimal	Harcanan kısmın miktarı (örneğin: 25.50).
LastTransactionId	Guid	Son işlemle ilişkili benzersiz ID numarası.
CreatedAt	Guid	Bu kayıt ne zaman oluşturuldu (tarih bilgisi olmalı).
UpdatedAt	int	Bilgilerin son kez güncellendiği zamanı belirtir.