> For the complete documentation index, see [llms.txt](https://developer.paywall.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.paywall.one/cuzdan-servisleri/3.-islemler/3.-walletowner-ile-getir.md).

# 3. WalletOwner ile Getir

## **Cüzdan Kaydını** WalletOwnerId ile Tanımla&#x20;

<mark style="color:green;">`GET`</mark> `{{WalletUrl}}/api/v1/wallet/transaction/by/walletowner/:walletOwnerId?Page=1&PageSize=10&StartDate=2025-03-24T20:26:25.426Z&EndDate=2025-04-29T20:26:25.426Z&TransactionType=1`

{% hint style="info" %}
**Not**: Bu servisi çağırmadan önce, **apikeypublic** ve **apiclientpublic** parametrelerini **Header** kısmına eklemeniz gereklidir.

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

**Gerekli header ve istek parametreleri:**

<details>

<summary><strong>Parametreler ve açıklamaları</strong></summary>

<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şiminde doğrulama için kullanılan genel anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İsteğin hangi istemciden geldiğini gösteren genel istemci anahtarıdır.</td></tr></tbody></table>

</details>

**Servisten dönen parametreler şu şekildedir:**

<details>

<summary><strong>Parametreler ve açıklamaları</strong></summary>

<table><thead><tr><th width="180.05859375">Parametre</th><th width="121.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>Alias</td><td>String</td><td>İşlemin yapıldığı cüzdanın alias'ı</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>BlockedBalanceAfterTransaction</td><td>Decimal</td><td>İşlem sonrası cüzdanın bloke bakiyesi.</td></tr><tr><td>AvailableBalanceAfterTransaction</td><td>Decimal</td><td>İşlem sonrası cüzdanın kullanılabilir bakiyesi.</td></tr><tr><td>GiftBalanceBalanceAfterTransaction</td><td>Decimal</td><td>İşlem sonrası cüzdanın toplam hediye bakiyesi.</td></tr><tr><td>CurrencyCode</td><td>String</td><td>İşlemin gerçekleştiği para birimi kodu.</td></tr><tr><td>SourceWalletId</td><td>Guid</td><td>Transfer işlemlerinde kaynak cüzdanın tanımlayıcısı</td></tr><tr><td>DestinationWalletId</td><td>Guid</td><td>Transfer işlemlerinde hedef cüzdanın tanımlayıcısı.</td></tr><tr><td>GiftBalanceId</td><td>Guid</td><td>Varsa işlemle ilişkili hediye bakiye kaydının tanımlayıcısı.</td></tr><tr><td>MainTransactionId</td><td>Guid</td><td>Varsa bu işlemin bağlı olduğu ana işlemin tanımlayıcısı</td></tr><tr><td>UniqueCode</td><td>String</td><td>İşleme ait benzersiz kod</td></tr><tr><td>UsedGiftBalances</td><td>array</td><td>İşlemde kullanılan hediye bakiyelerin listesi</td></tr><tr><td><mark style="color:yellow;">UsedGiftBalances</mark> > Id</td><td>guid</td><td>Kullanılan hediye bakiye kaydının benzersiz tanımlayıcısı</td></tr><tr><td><mark style="color:yellow;">UsedGiftBalances</mark> > Amount</td><td>decimal</td><td>Bu işlemde kullanılan hediye bakiye tutarı</td></tr><tr><td><mark style="color:yellow;">UsedGiftBalances</mark> > ExpirationDate</td><td>datetime</td><td>Hediye bakiyenin son kullanma tarihi. <code>null</code> ise süresizdir</td></tr><tr><td><mark style="color:yellow;">UsedGiftBalances</mark> > IsUnlimited</td><td>bool</td><td><code>ExpirationDate</code> değeri <code>null</code> ise <code>true</code> döner, hediye bakiyenin süresiz olduğunu belirtir</td></tr><tr><td><mark style="color:yellow;">UsedGiftBalances</mark> > Description</td><td>string</td><td>Hediye bakiyeye ait açıklama veya not</td></tr><tr><td>CashbackAmount</td><td>decimal</td><td>Varsa işleme ait cashback tutarı</td></tr><tr><td>ExternalTransactionTypeId</td><td>guid</td><td>Kendi sisteminizdeki bir işlem tipini bizim sistemimize ekledikten sonra size verdiğimiz id.</td></tr><tr><td>ExternalTransactionTypeEnum</td><td>string</td><td>Kendi sisteminizdeki bir işlem tipini bizim sistemimize eklerken verdiğiniz unique değer.</td></tr><tr><td>ExternalTransactionTypeName</td><td>string</td><td>Kendi sisteminizdeki işlem tipinin görünen adı</td></tr></tbody></table>

</details>

{% tabs %}
{% tab title="JSON" %}
{% code lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Items": [
            {
                "Id": "e1e2f263-7c0c-4997-a6c9-3e70de4ebda5",
                "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
                "Alias": "2816220769",
                "TransactionType": "Deposit",
                "Amount": 100000.00,
                "GiftAmount": null,
                "Description": "string",
                "ExternalReference": "5bc276c8-acb5-4cb7-90fe-1d3ff10fbcfb",
                "CreatedAt": "2025-08-20T11:56:17.206107Z",
                "UpdatedAt": null,
                "BalanceAfterTransaction": 100000.80,
                "BlockedBalanceAfterTransaction": 0.00,
                "AvailableBalanceAfterTransaction": 100000.80,
                "GiftBalanceBalanceAfterTransaction": 0.00,
                "CurrencyCode": "TRY",
                "SourceWalletId": null,
                "DestinationWalletId": null,
                "GiftBalanceId": null,
                "MainTransactionId": null,
                "UniqueCode": "9dd0b65f-05b8-498b-b8d9-3c4adaa27731",
                "UsedGiftBalances": null,
                "CashbackAmount": 0,
                "ExternalTransactionTypeId" :null,
                "ExternalTransactionTypeEnum" :null,
                "ExternalTransactionTypeName" :null
            },
            {
                "Id": "8adb2cbe-00ac-4a8b-befe-0fb204db6366",
                "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
                "Alias": "2816220769",
                "TransactionType": "Deposit",
                "Amount": 1.00,
                "GiftAmount": null,
                "Description": "string",
                "ExternalReference": "2679c1c1-64cb-42d8-bb2f-af0970c1998a",
                "CreatedAt": "2025-08-20T10:10:20.63054Z",
                "UpdatedAt": null,
                "BalanceAfterTransaction": 3.00,
                "BlockedBalanceAfterTransaction": 0.00,
                "AvailableBalanceAfterTransaction": 3.00,
                "GiftBalanceBalanceAfterTransaction": 0.00,
                "CurrencyCode": "TRY",
                "SourceWalletId": null,
                "DestinationWalletId": null,
                "GiftBalanceId": null,
                "MainTransactionId": null,
                "UniqueCode": "35191319-3d79-472b-be04-0e98df27c4bd",
                "UsedGiftBalances": null,
                "CashbackAmount": 0,
                "ExternalTransactionTypeId" :null,
                "ExternalTransactionTypeEnum" :null,
                "ExternalTransactionTypeName" :null
            },
            {
                "Id": "aa230ce5-127d-44a0-b480-7f9c4a24a9fd",
                "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
                "Alias": "2816220769",
                "TransactionType": "Deposit",
                "Amount": 1.00,
                "GiftAmount": null,
                "Description": "string",
                "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
                "CreatedAt": "2025-08-20T10:09:37.007461Z",
                "UpdatedAt": null,
                "BalanceAfterTransaction": 1.00,
                "BlockedBalanceAfterTransaction": 0.00,
                "AvailableBalanceAfterTransaction": 1.00,
                "GiftBalanceBalanceAfterTransaction": 0.00,
                "CurrencyCode": "TRY",
                "SourceWalletId": null,
                "DestinationWalletId": null,
                "GiftBalanceId": null,
                "MainTransactionId": null,
                "UniqueCode": "33bb4315-cb53-4f43-819c-b4bced99605f",
                "UsedGiftBalances": null,
                "CashbackAmount": 0,
                "ExternalTransactionTypeId" :null,
                "ExternalTransactionTypeEnum" :null,
                "ExternalTransactionTypeName" :null
            }
        ],
        "PageNumber": 1,
        "TotalPages": 1,
        "TotalCount": 3,
        "HasPreviousPage": false,
        "HasNextPage": false
    }
}
```

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