# 18. Satış/Harcama (Wallet)

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

<mark style="color:yellow;">`POST`</mark>`{{WalletUrl}}/api/v1/Wallet/purchase`&#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'ye erişim için kullanılan genel anahtar.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>API istemci kimliğini temsil eden genel anahtar.</td></tr></tbody></table>

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

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

{% 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>Id</td><td>Guid</td><td>Satış/Harcama işleminin gerçekleştiği cüzdanın kimlik bilgisi</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": "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
    }
}
```

{% 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>İşlem başarısız olduysa true, aksi halde false.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlem başarılıysa true, aksi halde false.</td></tr><tr><td>Errors</td><td>Array</td><td>Hata mesajlarının listesi.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>İşlem sonucunda dönen veri kümesi.</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 sistem tarafından üretilen benzersiz kimlik numarasıdır. UUID formatındadır.</td></tr><tr><td>WalletId</td><td>String</td><td>İşlemin yapıldığı cüzdanın sistemdeki kimlik numarasıdır. Hangi cüzdanla ilişkili olduğunu gösterir.</td></tr><tr><td>TransactionType</td><td>String</td><td>İşlemin tipini belirtir. Örneğin "Ödeme", "İade", "Transfer" gibi işlemleri tanımlar.</td></tr><tr><td>Amount</td><td>Decimal</td><td>Gerçekleştirilen işlemin tutarıdır. Para birimi üzerinden ifade edilir.</td></tr><tr><td>GiftAmount</td><td>Decimal</td><td>İşlemde kullanılan hediye bakiye miktarıdır. Normal bakiyeden farklı olarak promosyonel kullanımı temsil eder.</td></tr><tr><td>Description</td><td>String</td><td>İşleme dair açıklayıcı bilgidir. Kullanıcı tarafından veya sistem tarafından yazılabilir.</td></tr><tr><td>ExternalReference</td><td>String</td><td>İşleme dış kaynaklı bir sistem üzerinden verilen referans numarasıdır. Genellikle entegrasyon sistemleri için kullanılır.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>İşlemin oluşturulduğu tarih ve saat bilgisidir. UTC veya sistem saatine göre kaydedilir.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>İşlemin en son güncellendiği tarih ve saat bilgisidir. Bir değişiklik olduğunda güncellenir.</td></tr><tr><td>BalanceAfterTransaction</td><td>Decimal</td><td>İşlem gerçekleştikten sonra cüzdanda kalan bakiye miktarıdır. Hesap güncellemeleri sonrası değeri ifade eder.</td></tr><tr><td>SourceWalletId</td><td>String</td><td>İşlemin gönderici tarafındaki cüzdanın ID'sidir. Para çıkışı yapan cüzdanı belirtir.</td></tr><tr><td>DestinationWalletId</td><td>String</td><td>İşlemin alıcı tarafındaki cüzdanın ID'sidir. Para girişi yapılan cüzdanı belirtir.</td></tr><tr><td>GiftBalanceId</td><td>Guid</td><td>Kullanılan hediye bakiyesine özel benzersiz kimlik numarasıdır. Takip amaçlıdır.</td></tr><tr><td>MainTransactionId</td><td>Guid</td><td>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.</td></tr><tr><td>UniqueCode</td><td>String</td><td>İşlem için sistem tarafından üretilen benzersiz kod bilgisidir. Benzersizliği garanti eder.</td></tr><tr><td>UsedGiftBalances</td><td>List</td><td>İşlemde kullanılan hediye bakiyelerinin listesidir. Birden fazla bakiye kullanılabilir.</td></tr><tr><td>CashbackAmount</td><td>Decimal</td><td>İşlem sonucunda kazanılan geri ödeme (cashback) tutarıdır. Kampanya veya promosyon kaynaklıdır.</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/18.-satis-harcama-wallet.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.