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

Servise gönderilmesi gereken parametreler şu şekildedir:

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.

Servis İstek - Json

{
  "Amount": 1,
  "Description": "description",
  "Alias": "{{alias}}",
  "ExternalReference": "123321-123321-123321-123321"
}

Servis İstek

Parametre	Tip	Açıklama
Amount	decimal	Yatırılmak istenen tutar
Description	string	İlgili işlemin açıklaması
Alias	string	Cüzdan'a tanımlanmış hesap numarası (1234567890)
ExternalReference	string	İşlemin takip numarası. Bu bilgiyle işlemi takip edebilirsiniz

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

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	Servis çağrısının hata verip vermediğini belirten durum bayrağıdır.
IsSuccess	bool	İşlemin başarılı şekilde gerçekleştiğini gösteren onay bilgisidir.
Errors	Array	İşlem sırasında oluşabilecek hata detaylarını içeren liste yapısıdır.
Value	Array<Items>	İşlemin başarılı olması durumunda dönen veri nesnelerinin toplandığı dizidir.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	Sistemde kayıtlı varlığı temsil eden benzersiz kimlik numarasıdır.
WalletOwnerId	Guid	Cüzdan sahibinin benzersiz sistem kimlik numarasıdır.
Name	string	Cüzdan kullanıcısının ya da kurumsal hesabın ad veya unvan bilgisidir.
Alias	string	Cüzdan için atanmış takma ad ya da alternatif tanımlayıcı isimdir.
MerchantId	Guid	İlgili üye iş yerini temsil eden eşsiz kimlik değeridir.
RegionId	string	Cüzdan sahibinin bağlı olduğu bölgeyi temsil eden kod verisidir.
CurrencyCode	string	Cüzdandaki işlemlerin gerçekleştiği para biriminin kod bilgisidir (örn: TRY, USD).
Balance	decimal	Cüzdanın toplam mevcut parasal varlık miktarını gösterir.
AvailableBalance	decimal	Anlık olarak kullanılabilir serbest bakiye tutarıdır.
TotalGiftBalance	decimal	Cüzdanda bulunan toplam hediye bakiyesi değeridir.
BlockedBalance	decimal	İşlem kısıtlamasına tabi tutulan bakiye miktarıdır.
FrozenUntil	DateTime	Cüzdanın dondurulduğu ve tekrar aktif olacağı tarih bilgisidir.
IsFrozen	bool	Cüzdanın donuk (dondurulmuş) statüde olup olmadığını gösteren bilgidir.
IsDeleted	bool	İlgili kaydın sistem üzerinde silinmiş statüsünde olup olmadığını ifade eder.
CreatedAt	DateTime	Kayıt işleminin ilk oluşturulduğu tarih ve saat bilgisidir.
UpdatedAt	DateTime	Kaydın sistem üzerinde son güncellendiği zamanı belirtir.
TransactionId	Guid	Gerçekleştirilen işlemin benzersiz kimlik numarasıdır.