12. Para Çekme (Alias)

Belirtilen Alias bilgisi kullanılarak bir hesaptan para çekme işlemi başlatmak ve çekilen 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/withdraw/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 erişimini doğrulamak için kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	İstemciyi tanımlayan ve servis çağrısında kimlik doğrulaması sağlayan anahtar bilgisidir.

Servis İstek - Json

{
  "Alias": "2816220769",
  "Amount": 0.1,
  "Description": "{{$randomJobDescriptor}}",
  "ExternalReference": "{{$guid}}"
}

Servis İstek

Amount	decimal	Para çekilmek 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": "86d1ed9e-9e61-4c8e-96db-4f06030ea19d",
        "Alias": "2816220769",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "TransactionType": "Withdrawal",
        "Amount": 0.1,
        "GiftAmount": null,
        "Description": "Regional",
        "ExternalReference": "0f84e841-847f-426a-b02f-20cc93e2d667",
        "CreatedAt": "2025-08-20T10:13:13.9375891Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 2.90,
        "GiftBalanceId": null,
        "UniqueCode": "23fea619-eaae-4a5a-8740-458d989edd47",
        "CashbackAmount": 0
    }
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	İşlem sırasında hata oluşup oluşmadığını belirtir.
IsSuccess	bool	Servisin başarılı bir şekilde tamamlandığını gösterir.
Errors	Array	İşlem sırasında alınan hata detaylarını içeren liste.
Value	Array<Items>	Servisten dönen asıl veri kümesini içerir.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	Kayıt için sistem tarafından üretilmiş eşsiz kimlik numarasıdır.
WalletOwnerId	Guid	İlgili cüzdan sahibinin benzersiz tanımlayıcısıdır.
Name	string	Cüzdan sahibine ait isim bilgisidir.
Alias	string	Cüzdanı temsil eden takma isim bilgisidir.
CurrencyCode	string	Cüzdanın işlem yaptığı para birimi kodudur.
Balance	decimal	Cüzdanda bulunan toplam bakiye miktarıdır.
AvailableBalance	decimal	Kullanıma açık, harcanabilir bakiye bilgisidir.
TotalGiftBalance	decimal	Cüzdandaki toplam hediye bakiye tutarını gösterir.
BlockedBalance	decimal	Bloke edilmiş, kullanılamayan bakiye miktarıdır.
FrozenUntil	DateTime	Cüzdanın donuk kalacağı son tarih bilgisidir.
IsFrozen	bool	Cüzdanın dondurulmuş olup olmadığını ifade eder.
IsDeleted	bool	Kaydın silinmiş olup olmadığını gösterir.
CreatedAt	DateTime	Kayıt oluşturulma zaman bilgisidir.
UpdatedAt	DateTime	Kayıt üzerinde yapılan son güncelleme zaman bilgisidir.
TransactionId	Guid	İşleme ait eşsiz tanımlayıcı numaradır.