18. Satış/Harcama (Wallet)

Cüzdan ile yapılan satış/harcama işlemlerini bu servis üzerinden yönetebilirsiniz

Cüzdan 'Id' ile Satış/Harcama

POST{{WalletUrl}}/api/v1/Wallet/purchase

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 için kullanılan genel anahtar.
apiclientpublic	string	Evet	API istemci kimliğini temsil eden genel anahtar.

Servis İstek - Json

{
  "Id": "92858707-7718-435c-9ba3-3d702a3bea9b",
  "Amount": 1,
  "Description": "string",
  "ExternalReference": "{{$guid}}",
  "UseGiftBalances": false,
  "CashbackApply": false,
  "CashbackType": "Percentage",
  "CashbackValue": 50
}

Servis İstek

Parametre	Tip	Açıklama
Id	Guid	Satış/Harcama işleminin gerçekleştiği cüzdanın kimlik bilgisi
Amount	decimal	İşlem tutarı
Description	string	İşleme ait açıklama
ExternalReference	string	İşlem takip numarası
UseGiftBalance	bool	İlgili işlemin gerçekleştiği cüzdana tanımlı hediye bakiye varsa, bu bakiye kullanılsın mı?
CashbackApply	bool	İşlem sonrasında Cashback uygulansın mı?
CashbackType	string	Cashback tipi Bkz: Cashback Tipleri
CashbackValue	decimal	Verilecek Cashback değeri

Servis Cevap - Json

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "784f8d50-c2cc-4911-b82b-2f8f49a0b98f",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Alias": "2816220769",
        "TransactionType": "Purchase",
        "Amount": 100,
        "GiftAmount": null,
        "Description": "string",
        "ExternalReference": "8e0c7f38-d63e-4c79-b6e6-c53751d205cf",
        "CreatedAt": "2025-08-20T11:56:24.8210569Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 99900.80,
        "SourceWalletId": null,
        "DestinationWalletId": null,
        "GiftBalanceId": null,
        "MainTransactionId": null,
        "UniqueCode": "bd0413e8-2a5f-4476-8617-57775655e322",
        "UsedGiftBalances": null,
        "CashbackAmount": 0
    }
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	İşlem başarısız olduysa true, aksi halde false.
IsSuccess	bool	İşlem başarılıysa true, aksi halde false.
Errors	Array	Hata mesajlarının listesi.
Value	Array<Items>	İşlem sonucunda dönen veri kümesi.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	İşleme ait sistem tarafından üretilen benzersiz kimlik numarasıdır. UUID formatındadır.
WalletId	String	İşlemin yapıldığı cüzdanın sistemdeki kimlik numarasıdır. Hangi cüzdanla ilişkili olduğunu gösterir.
TransactionType	String	İşlemin tipini belirtir. Örneğin "Ödeme", "İade", "Transfer" gibi işlemleri tanımlar.
Amount	Decimal	Gerçekleştirilen işlemin tutarıdır. Para birimi üzerinden ifade edilir.
GiftAmount	Decimal	İşlemde kullanılan hediye bakiye miktarıdır. Normal bakiyeden farklı olarak promosyonel kullanımı temsil eder.
Description	String	İşleme dair açıklayıcı bilgidir. Kullanıcı tarafından veya sistem tarafından yazılabilir.
ExternalReference	String	İşleme dış kaynaklı bir sistem üzerinden verilen referans numarasıdır. Genellikle entegrasyon sistemleri için kullanılır.
CreatedAt	DateTime	İşlemin oluşturulduğu tarih ve saat bilgisidir. UTC veya sistem saatine göre kaydedilir.
UpdatedAt	DateTime	İşlemin en son güncellendiği tarih ve saat bilgisidir. Bir değişiklik olduğunda güncellenir.
BalanceAfterTransaction	Decimal	İşlem gerçekleştikten sonra cüzdanda kalan bakiye miktarıdır. Hesap güncellemeleri sonrası değeri ifade eder.
SourceWalletId	String	İşlemin gönderici tarafındaki cüzdanın ID'sidir. Para çıkışı yapan cüzdanı belirtir.
DestinationWalletId	String	İşlemin alıcı tarafındaki cüzdanın ID'sidir. Para girişi yapılan cüzdanı belirtir.
GiftBalanceId	Guid	Kullanılan hediye bakiyesine özel benzersiz kimlik numarasıdır. Takip amaçlıdır.
MainTransactionId	Guid	Eğer bu işlem bir başka işlemin devamı ya da parçasıysa, bağlı olduğu ana işlemin ID'sidir.
UniqueCode	String	İşlem için sistem tarafından üretilen benzersiz kod bilgisidir. Benzersizliği garanti eder.
UsedGiftBalances	List	İşlemde kullanılan hediye bakiyelerinin listesidir. Birden fazla bakiye kullanılabilir.
CashbackAmount	Decimal	İşlem sonucunda kazanılan geri ödeme (cashback) tutarıdır. Kampanya veya promosyon kaynaklıdır.