9. Para Yatırma (Wallet)

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 'Id' Bilgisiyle Para Yatır

POST {{WalletUrl}}/api/v1/wallet/deposit

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 isteklerinde erişim izni sağlamak amacıyla kullanılan genel anahtar verisidir.
apiclientpublic	string	Evet	İstemcinin kimliğini doğrulamak için her istekte gönderilen açık kimlik anahtarıdır.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
Id	Guid	Evet	Para yüklenecek cüzdanın benzersiz tanımlayıcısı
Amount	decimal	Evet	Yüklenecek tutar. Sıfırdan büyük olmalıdır.
ExternalReference	string	Evet	Kendi sisteminizdeki işleme ait benzersiz referans numarası. Aynı referansın tekrar gönderilmesi durumunda işlem reddedilebilir
Description	string	Hayır	İşleme ait açıklama veya not. Opsiyoneldir.
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.

İş Kuralları

• Id alanında belirtilen cüzdan, ilgili Merchant altında aktif olarak kayıtlı olmalıdır. Bulunamayan bir cüzdan için işlem gerçekleştirilemez.

• Amount değeri sıfırdan büyük olmalıdır.

• ExternalReference değeri aynı Merchant kapsamında benzersiz olmalıdır. Daha önce kullanılmış bir referans değeri ile yeni işlem oluşturulamaz.

• Silinmiş cüzdanlar üzerinde işlem gerçekleştirilemez.

• Dondurulmuş durumda olan ve dondurma süresi henüz sona ermemiş cüzdanlar için işlem kabul edilmez.

• ExternalTransactionType bilgisi gönderildiğinde, belirtilen tipin sistemde tanımlı ve aktif olması gerekmektedir. Geçersiz veya bulunamayan tip bilgisi ile işlem gerçekleştirilemez.

• ExternalTransactionType bilgisi ile gerçekleştirilen işlemlerde, ilgili işlem tipine özel tutar ve işlem adedi limitleri kontrol edilir. Limitlerin aşılması durumunda işlem reddedilir.

• ExternalTransactionType bilgisi gönderilmediğinde, para yatırma işlemleri için tanımlanan genel tutar ve işlem adedi limitleri uygulanır. Limitlerin aşılması halinde işlem gerçekleştirilemez.

• ExternalTransactionType bilgisi gönderilen işlemlerde genel para yatırma limitleri uygulanmaz, yalnızca ilgili işlem tipine özel limitler dikkate alınır.

• Aynı cüzdana 2 saniye içinde tekrar para yatırma isteği gönderilirse işlem reddedilir.

• Para yatırma işlemi tamamlandıktan sonra koşulları sağlayan aktif bir bonus kampanyası bulunması halinde sistem tarafından otomatik olarak bonus işlemi oluşturulur. Kazanılan bonus tutarı CashbackAmount alanında iletilir.

• Para yatırma işlemleri için aktif bir komisyon tanımı bulunuyorsa komisyon tutarı işlem tutarı üzerinden hesaplanır, bakiye güncellemesi net tutar üzerinden gerçekleştirilir ve komisyon ayrı bir işlem kaydı olarak oluşturulur.

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

JSON

{
  "Id": "{{walletId}}",
  "Amount": 1,
  "Description": "description",
  "ExternalReference": "123321-123321-123321-123321",
  "Description" : "string",
  "ExternalTransactionTypeId" : "123321-123321-123321-123321",
  "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ı.
Value > AvailableBalanceAfterTransaction	decimal	İşlem sonrası cüzdanın kullanılabilir bakiyesi

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "aa230ce5-127d-44a0-b480-7f9c4a24a9fd",
        "Alias": "2816220769",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "TransactionType": "Deposit",
        "Amount": 1,
        "GiftAmount": null,
        "Description": "string",
        "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
        "CreatedAt": "2025-08-20T10:09:37.0074611Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 1.00,
        "GiftBalanceId": null,
        "UniqueCode": "68b977f6-58dc-4c48-857a-86fea5ef35c5",
        "CashbackAmount": 0,
        "AvailableBalanceAfterTransaction" : 1.00
    }
}