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

Gerekli header ve istek parametreleri:

Zorunlu header parametreleri

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.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
Alias	string	Evet	Cüzdan'a tanımlanmış hesap numarası.
Amount	decimal	Evet	Çekilecek 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

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

JSON

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

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": "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
    }
}