10. Para Yatırma (Alias)

Belirtilen alias bilgisi kullanılarak bir hesaba para yatırmak ve yatırılan tutarın işleme alınabilmesi amacıyla bu servis aracılığıyla bilgi gönderilmelidir.

Cüzdan 'Alias' Bilgisiyle Para Yatır

POST {{WalletUrl}}/api/v1/wallet/deposit/by/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:

Zorunlu header parametreleri

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	API'ye yapılan çağrılarda kimlik doğrulaması amacıyla kullanılan açık anahtar değeridir.
apiclientpublic	string	Evet	İstemcinin sistemde tanımlı kimliğini temsil eden genel anahtar bilgisidir.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
Alias	string	Evet	Para yüklenecek cüzdanın alias'ı
Amount	decimal	Evet	Yüklenecek tutar. Sıfırdan büyük olmalıdır.
Description	string	Hayır	İşleme ait açıklama veya not. Opsiyoneldir.
ExternalReference	string	Evet	Kendi sisteminizdeki işleme ait benzersiz referans numarası. Aynı referansın tekrar gönderilmesi durumunda işlem reddedilebilir
ExternalTransactionTypeId	Guid	Hayır	Kendi sisteminizdeki işlem tipini UUID olarak belirtir. ExternalTransactionTypeEnum ile birlikte kullanılabilir, ikisi birbirinin alternatifidir.
ExternalTransactionTypeEnum	string	Hayır	Kendi sisteminizdeki işlem tipini string olarak belirtir. ExternalTransactionTypeId ile birlikte kullanılabilir, ikisi birbirinin alternatifidir.

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

JSON

{
    "Alias": "2816220769",
    "Amount": 1.00,
    "Description": "Bakiye yükleme işlemi",
    "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
    "ExternalTransactionTypeId": null,
    "ExternalTransactionTypeEnum": null
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
IsFailure	bool	Gerçekleştirilen işlemin hata ile sonuçlanıp sonuçlanmadığını belirten kontrol bilgisidir.
IsSuccess	bool	İlgili servisin başarıyla tamamlandığını ifade eden işaret alanıdır.
Errors	Array	İstek sırasında oluşan hata detaylarının bulunduğu veri listesidir.
Value	Array<Items>	Servisten dönen veri nesnelerinin topluca tutulduğu alanı ifade eder.
Value > Id	Guid	Sistemdeki her kayıt için otomatik oluşturulan benzersiz kimlik değeridir.
Value > Alias	string	Cüzdana atanmış olan alternatif isim veya kısa tanımlamadır.
Value > WalletId	Guid	İşlemin yapıldığı cüzdanın benzersiz tanımlayıcısı.
Value > TransactionType	string	İşlem tipi.
Value > Amount	decimal	Yüklenen tutar.
Value > GiftAmount	decimal	Varsa işleme ait hediye/bonus tutarı.
Value > Description	string	İşleme ait açıklama veya not.
Value > ExternalReference	string	İşleme ait dış sistem referans numarası.
Value > CreatedAt	Datetime	İşlemin oluşturulma tarihi ve saati (UTC)
Value > UpdatedAt	Datetime	İşlemin son güncellenme tarihi ve saati (UTC)
Value > BalanceAfterTransaction	decimal	İşlem sonrası cüzdanın toplam bakiyesi
Value > GiftBalanceId	Guid	Varsa işlemle ilişkili hediye bakiye kaydının tanımlayıcısı.
Value > UniqueCode	string	İşleme ait benzersiz kod.
Value > CashbackAmount	decimal	Varsa işleme ait cashback tutarı.

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "8adb2cbe-00ac-4a8b-befe-0fb204db6366",
        "Alias": "2816220769",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "TransactionType": "Deposit",
        "Amount": 1,
        "GiftAmount": null,
        "Description": "string",
        "ExternalReference": "2679c1c1-64cb-42d8-bb2f-af0970c1998a",
        "CreatedAt": "2025-08-20T10:10:20.6305401Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 3.00,
        "GiftBalanceId": null,
        "UniqueCode": "42e35902-05dd-495f-bf03-a55cf4aab41b",
        "CashbackAmount": 0
    }
}