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

Gerekli header ve istek parametreleri:

Zorunlu header parametreleri

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.

İstek gövdesi parametreleri

Parametre	Tip	Zorunlu	Açıklama
Alias	string	Evet	Satış/Harcama işleminin gerçekleştiği cüzdan numarası
Amount	decimal	Evet	Satın alma 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
UseGiftBalances	bool	Evet	İlgili işlemin gerçekleştiği cüzdana tanımlı hediye bakiye varsa, bu bakiye kullanılsın mı?
CashbackApply	bool	Hayır	İşleme cashback uygulanıp uygulanmayacağını belirtir. Varsayılan: false
CashbackType	enum	Hayır	Cashback türü. Amount = Sabit tutar, Percentage = Yüzde
CashbackValue	decimal	Hayır	Cashback değeri. CashbackType = Amount ise tutar, Percentage ise yüzde değeri olarak belirtilir. Sıfır veya sıfırdan büyük olmalıdır
ExternalTransactionTypeId	Guid	Hayır	Kendi sisteminizdeki işlem tipini UUID olarak belirtir. ExternalTransactionTypeEnum ile birlikte kullanılabilir, ikisi birbirinin alternatifidir.
ExternalTransactionTypeEnum	string	Hayır	Kendi sisteminizdeki işlem tipini string olarak belirtir. ExternalTransactionTypeId ile birlikte kullanılabilir, ikisi birbirinin alternatifidir.

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

JSON

{
    "Alias": "2816220769",
    "Amount": 10.00,
    "Description": "Satın alma işlemi",
    "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
    "UseGiftBalances": true,
    "CashbackApply": true,
    "CashbackType": "Amount",
    "CashbackValue": 10.00,
    "ExternalTransactionTypeId": null,
    "ExternalTransactionTypeEnum": null
}

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

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.
Alias	String	İşlemin yapıldığı cüzdanın alias'ı
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	Guid	Transfer işlemlerinde kaynak cüzdanın tanımlayıcısı
DestinationWalletId	Guid	Transfer işlemlerinde hedef cüzdanın tanımlayıcısı.
GiftBalanceId	Guid	Varsa işlemle ilişkili hediye bakiye kaydının tanımlayıcısı.
MainTransactionId	Guid	Varsa bu işlemin bağlı olduğu ana işlemin tanımlayıcısı
UniqueCode	String	İşleme ait benzersiz kod
UsedGiftBalances	array	İşlemde kullanılan hediye bakiyelerin listesi
UsedGiftBalances > Id	guid	Kullanılan hediye bakiye kaydının benzersiz tanımlayıcısı
UsedGiftBalances > Amount	decimal	Bu işlemde kullanılan hediye bakiye tutarı
UsedGiftBalances > ExpirationDate	datetime	Hediye bakiyenin son kullanma tarihi. null ise süresizdir
UsedGiftBalances > IsUnlimited	bool	ExpirationDate değeri null ise true döner, hediye bakiyenin süresiz olduğunu belirtir
UsedGiftBalances > Description	string	Hediye bakiyeye ait açıklama veya not
CashbackAmount	decimal	Varsa işleme ait cashback tutarı

JSON

{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "24d912c2-11b1-4fdf-b0e7-6483e526e523",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Alias": "2816220769",
        "TransactionType": "Purchase",
        "Amount": 10.00,
        "GiftAmount": null,
        "Description": "Satın alma işlemi",
        "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
        "CreatedAt": "2025-08-20T11:56:51.8211279Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 89.00,
        "SourceWalletId": null,
        "DestinationWalletId": null,
        "GiftBalanceId": null,
        "MainTransactionId": null,
        "UniqueCode": "e7022bed-3827-44f4-a1fe-c035048298df",
        "UsedGiftBalances": [
            {
                "Id": "aa230ce5-127d-44a0-b480-7f9c4a24a9fd",
                "Amount": 5.00,
                "ExpirationDate": "2025-12-31T23:59:59Z",
                "IsUnlimited": false,
                "Description": "Hoşgeldin bonusu"
            }
        ],
        "CashbackAmount": 1.00
    }
}