# 19. Satış/Harcama (Alias)

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

<mark style="color:yellow;">`POST`</mark>`{{WalletUrl}}/api/v1/wallet/purchase/by/alias`&#x20;

{% hint style="info" %}
Not: Bu servisin kullanılabilmesi için **apikeypublic** ve **apiclientpublic** parametrelerinin Header alanına eklenmiş olması zorunludur.

\
[<mark style="color:green;">**WalletAPI Adresi**</mark>](https://developer.paywall.one/ortam)
{% endhint %}

**Servise gönderilmesi gereken parametreler şu şekildedir:**

<table><thead><tr><th width="162">Parametre</th><th width="79">Tip</th><th width="107">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Evet</td><td>API erişimi için kullanılacak genel anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İlgili istemciyi tanımlayan, sistemdeki genel client anahtarı bilgisidir.</td></tr></tbody></table>

{% tabs %}
{% tab title="Servis İstek - Json" %}

```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
}
```

{% endtab %}
{% endtabs %}

## Servis İstek

<table><thead><tr><th width="192">Parametre</th><th width="147.89192708333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>Alias</td><td>string</td><td>Satış/Harcama işleminin gerçekleştiği cüzdan numarası</td></tr><tr><td>Amount</td><td>decimal</td><td>İşlem tutarı</td></tr><tr><td>Description</td><td>string</td><td>İşleme ait açıklama</td></tr><tr><td>ExternalReference</td><td>string</td><td>İşlem takip numarası</td></tr><tr><td>UseGiftBalance</td><td>bool</td><td>İlgili işlemin gerçekleştiği cüzdana tanımlı hediye bakiye varsa, bu bakiye kullanılsın mı?</td></tr><tr><td>CashbackApply</td><td>bool</td><td>İşlem sonrasında Cashback uygulansın mı?</td></tr><tr><td>CashbackType</td><td>string</td><td>Cashback tipi<br><br>Bkz: <a href="../sistem-verileri/cashback-tipleri">Cashback Tipleri</a></td></tr><tr><td>CashbackValue</td><td>decimal</td><td>Verilecek Cashback değeri</td></tr></tbody></table>

{% tabs %}
{% tab title="Servis Cevap - Json" %}
{% code lineNumbers="true" %}

```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
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Servis Cevap

<table><thead><tr><th width="192">Parametre</th><th width="147.89192708333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>Servis isteği başarısız olduysa true döner, aksi halde false.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Servis isteği başarılı olduysa true döner, aksi halde false.</td></tr><tr><td>Errors</td><td>Array</td><td>Hata durumunda dönen mesaj veya hata kodu listesidir.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>Servisten dönen verilerin bulunduğu ana listedir.</td></tr></tbody></table>

## Servis Cevap (Value)

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