11. Para Çekme (Wallet)

Belirtilen alias bilgisi kullanılarak bir hesaptan para çekmek ve çekilen tutarın işleme alınabilmesi amacıyla bu servis aracılığıyla bilgi gönderilmelidir.

Cüzdan 'Id' Bilgisiyle Para Çek

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

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 erişim sağlayabilmek için zorunlu olan genel anahtar bilgisidir.
apiclientpublic	string	Evet	İstemci kimliğini temsil eden ve API isteklerinde kullanılacak genel anahtar bilgisidir.

Servis İstek - Json

{
  "Id": "{{walletId}}",
  "Amount": 1,
  "Description": "description",
  "ExternalReference": "{{$randomFullName}}"
}

Servis İstek

Parametre	Tip	Açıklama
Id	Guid	Para çekilmek 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": "f19ea4b9-9b42-48e6-9fdd-a3bc519d60ab",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "TransactionType": "Withdrawal",
        "Amount": 1,
        "GiftAmount": null,
        "Description": "string",
        "ExternalReference": "9e1348e3-807e-4754-a567-b907cd4e5547",
        "CreatedAt": "2025-08-20T10:10:45.6814699Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 3.00,
        "GiftBalanceId": null,
        "UniqueCode": "04006cec-1ae0-43d8-b49d-e1a55cda274f",
        "CashbackAmount": 0
    }
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	Servisin hata verip vermediğini belirten durum bilgisidir.
IsSuccess	bool	Servisin başarılı sonuçlanıp sonuçlanmadığını gösterir.
Errors	Array	Servis tarafından dönen hata mesajlarının listesi.
Value	Array<Items>	İstek sonucu oluşan veri kümesidir.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	Kayıt edilen işlemin benzersiz kimlik numarasıdır.
WalletOwnerId	Guid	İşleme ait cüzdan sahibinin sistemdeki ID numarasıdır.
Name	string	Kullanıcıya veya işletmeye ait kayıtlı isim bilgisidir.
Alias	string	Cüzdana tanımlanan alternatif takma isimdir.
MerchantId	Guid	İşlem gerçekleştiren üye işyerinin sistemdeki benzersiz kimliğidir.
RegionId	string	İşlemin veya kullanıcının bağlı olduğu bölge bilgisidir.
CurrencyCode	string	Kullanılan para biriminin kod bilgisidir (örn. TRY, USD).
Balance	decimal	Cüzdanda mevcut olan toplam bakiye bilgisidir.
AvailableBalance	decimal	İşlem yapılabilecek kullanılabilir bakiye miktarıdır.
TotalGiftBalance	decimal	Hediye bakiyesi dahil toplam bakiye bilgisidir.
BlockedBalance	decimal	Kullanımı kısıtlanmış bakiye tutarıdır.
FrozenUntil	DateTime	Cüzdanın dondurulduğu ve açılacağı tarih bilgisidir.
IsFrozen	bool	Cüzdanın aktif mi yoksa dondurulmuş mu olduğunu belirtir.
IsDeleted	bool	İlgili kaydın sistemde silinip silinmediğini gösterir.
CreatedAt	DateTime	Kaydın oluşturulduğu tarih ve saat bilgisidir.
UpdatedAt	DateTime	Son güncelleme işleminin yapıldığı tarih bilgisidir.
TransactionId	Guid	İşleme ait benzersiz işlem kimlik numarasıdır.