# 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>](/ortam.md)
{% 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="/pages/sKlLDRa10aojPQk2SmGf">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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.paywall.one/cuzdan-servisleri/2.-cuzdan/19.-satis-harcama-alias.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.