19. Satış/Harcama (Alias)

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

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

POST{{WalletUrl}}/api/v1/wallet/purchase/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şimi için kullanılacak genel anahtar bilgisidir.
apiclientpublic	string	Evet	İlgili istemciyi tanımlayan, sistemdeki genel client anahtarı bilgisidir.

Servis İstek - Json

{
  "Alias": "2816220769",
  "Amount": 10,
  "Description": "string",
  "ExternalReference": "{{$randomFullName}}",
  "UseGiftBalances": true, // If there is a defined gift balance, it will be spent first.
  "CashbackApply": true,
  "CashbackType": "Amount",
  "CashbackValue": 10
}

Servis İstek

Parametre	Tip	Açıklama
Alias	string	Satış/Harcama işleminin gerçekleştiği cüzdan numarası
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": "24d912c2-11b1-4fdf-b0e7-6483e526e523",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Alias": "2816220769",
        "TransactionType": "Purchase",
        "Amount": 10,
        "GiftAmount": null,
        "Description": "string",
        "ExternalReference": "6ddf4d59-34f9-447a-9168-c1846bdb5d79",
        "CreatedAt": "2025-08-20T11:56:51.8211279Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 99892.80,
        "SourceWalletId": null,
        "DestinationWalletId": null,
        "GiftBalanceId": null,
        "MainTransactionId": null,
        "UniqueCode": "e7022bed-3827-44f4-a1fe-c035048298df",
        "UsedGiftBalances": null,
        "CashbackAmount": 1.00
    }
}

Servis Cevap

Parametre	Tip	Açıklama
IsFailure	bool	Servis isteği başarısız olduysa true döner, aksi halde false.
IsSuccess	bool	Servis isteği başarılı olduysa true döner, aksi halde false.
Errors	Array	Hata durumunda dönen mesaj veya hata kodu listesidir.
Value	Array<Items>	Servisten dönen verilerin bulunduğu ana listedir.

Servis Cevap (Value)

Parametre	Tip	Açıklama
Id	Guid	İşleme ait benzersiz kimlik numarasıdır.
WalletId	String	İşlemin gerçekleştiği cüzdanın kimliğidir.
TransactionType	String	İşlemin türünü belirtir (ör. ödeme, iade, aktarım).
Amount	Decimal	İşlemde kullanılan toplam tutarı belirtir.
GiftAmount	Decimal	Hediye bakiyesinden kullanılan tutardır.
Description	String	İşleme dair açıklayıcı bilgidir.
ExternalReference	String	Harici sistem tarafından sağlanan referans bilgisidir.
CreatedAt	DateTime	İşlemin oluşturulduğu tarih ve zaman.
UpdatedAt	DateTime	İşlem üzerinde yapılan son güncelleme zamanı.
BalanceAfterTransaction	Decimal	İşlem sonrası cüzdanın yeni bakiyesi.
SourceWalletId	String	Kaynak cüzdan ID’si (aktarım işlemlerinde kullanılır).
DestinationWalletId	String	Hedef cüzdan ID’si (aktarım işlemlerinde kullanılır).
GiftBalanceId	Guid	Kullanılan hediye bakiyesinin kimliğidir.
MainTransactionId	Guid	Ana işleme ait ID (bağlantılı işlemlerde referans olur).
UniqueCode	String	İşleme özel benzersiz kod.
UsedGiftBalances	List	Kullanılan hediye bakiyelerinin listesi.
CashbackAmount	Decimal	Bu işlem sonucu kazanılan geri ödeme (cashback) tutarı.