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

Gerekli header ve istek parametreleri:

Zorunlu header parametreleri

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.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
Id	Guid	Evet	Benzersiz kimlik 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

İş Kuralları

• Id ile belirtilen cüzdan Merchant altında aktif olarak kayıtlı olmalıdır.

• ExternalReference aynı Merchant kapsamında benzersiz olmalıdır. Daha önce kullanılmış bir referans ile yeni işlem oluşturulamaz.

• Amount sıfırdan büyük olmalıdır.

• Silinmiş veya dondurulmuş cüzdanlar üzerinde işlem gerçekleştirilemez.

• Para çekme işlemlerinde tanımlanan tutar ve işlem adedi limitleri aşılamaz.

• İşlem öncesinde kullanılabilir bakiye, çekim tutarı ve varsa komisyon tutarını karşılamalıdır. Yetersiz bakiye durumunda işlem reddedilir.

• Overdraft özelliği aktif olan cüzdanlarda bakiye kontrolü OverdraftLimit dahilinde gerçekleştirilir.

• Aynı cüzdana 2 saniye içinde tekrar gönderilen para çekme istekleri reddedilir.

• Aktif komisyon tanımı varsa komisyon tutarı çekim tutarıyla birlikte bakiyeden düşülür.

• İşlem sonrasında koşulları sağlayan aktif bir bonus kampanyası varsa otomatik olarak bonus işlemi oluşturulur.

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

JSON

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

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 > 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ı.
Value > Alias	string	Cüzdana atanmış olan alternatif isim veya kısa tanımlamadır.
Value > AvailableBalanceAfterTransaction	decimal	Para çekme işlemi sonrası cüzdanın kullanılabilir bakiyesi.

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,
        "Alias" : null,
        "AvailableBalanceAfterTransaction" : 1.00
    }
}