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

Servise gönderilmesi gereken parametreler şu şekildedir:

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.

Servis İstek - Json

{
  "Id": "{{walletId}}",
  "Amount": 1,
  "Description": "description",
  "ExternalReferenca": "123321-123321-123321-123321"
}

Servis İstek

Parametre	Tip	Açıklama
Id	Guid	Para yatırılmak istenen cüzdanın kimlik bilgisi
Amount	decimal	Yatırılmak istenen tutar
Description	string	İlgili işlemin açıklaması
ExternalReference	string	İşlemin takip numarası. Bu bilgiyle işlemi takip edebilirsiniz

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

Servis Cevap

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.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	Sistemdeki her kayıt için otomatik oluşturulan benzersiz kimlik değeridir.
WalletOwnerId	Guid	Cüzdan sahibine atanan sistem içi benzersiz kimlik numarasıdır.
Name	string	Cüzdan sahibinin ismi veya kuruluş adını temsil eden metinsel ifadedir.
Alias	string	Cüzdana atanmış olan alternatif isim veya kısa tanımlamadır.
MerchantId	Guid	Üye iş yerini gösteren eşsiz kimlik numarasıdır.
RegionId	string	Cüzdan sahibinin kayıtlı olduğu coğrafi bölgeye ait kod bilgisidir.
CurrencyCode	string	İşlemlerde kullanılan para biriminin kısa kodu (örn: TRY, USD) bilgisidir.
Balance	decimal	Cüzdanın toplam sahip olduğu parasal bakiye tutarıdır.
AvailableBalance	decimal	Anlık kullanılabilir serbest bakiye değeridir.
TotalGiftBalance	decimal	Cüzdanda biriken toplam hediye bakiye miktarını gösterir.
BlockedBalance	decimal	Kullanımı sınırlandırılmış olan bloke bakiye bilgisidir.
FrozenUntil	DateTime	Cüzdanın askıya alındığı ve tekrar açılacağı tarihi gösterir.
IsFrozen	bool	Cüzdanın donuk (pasif) durumda olup olmadığını belirtir.
IsDeleted	bool	İlgili kaydın sistem üzerinde silinmiş statüde olup olmadığını gösteren alandır.
CreatedAt	DateTime	Kaydın sistemde ilk oluşturulduğu tarih bilgisidir.
UpdatedAt	DateTime	Kaydın son düzenleme tarihini ve saat bilgisini içerir.
TransactionId	Guid	İlgili işlem hareketinin benzersiz tanımlayıcı kimlik bilgisidir.