# 3. WalletOwner ile Getir

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

<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>](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ş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>

{% tabs %}
{% tab title="Servis Cevap - 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
            },
            {
                "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
            },
            {
                "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
            }
        ],
        "PageNumber": 1,
        "TotalPages": 1,
        "TotalCount": 3,
        "HasPreviousPage": false,
        "HasNextPage": false
    }
}
```

{% 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>İlgili servis işleminin başarısız olup olmadığını belirten boolen değerdir.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İlgili servisin başarılı şekilde tamamlanıp tamamlanmadığını ifade eder.</td></tr><tr><td>Errors</td><td>Array</td><td>Servis sırasında oluşabilecek hata mesajlarının bulunduğu bilgi alanıdır.</td></tr><tr><td>HasNextPage</td><td>bool</td><td>Listeleme işlemlerinde bir sonraki sayfanın olup olmadığını belirtir.</td></tr><tr><td>HasPreviousPage</td><td>bool</td><td>Önceki bir sayfanın varlığını gösteren işaret bilgisidir.</td></tr><tr><td>TotalCount</td><td>int</td><td>Sorgulanan toplam kayıt adedini ifade eder.</td></tr><tr><td>TotalPages</td><td>int</td><td>Sonuçların kaç sayfada toplandığını gösterir.</td></tr><tr><td>PageNumber</td><td>int</td><td>Mevcut görüntülenen sayfanın numarasını belirtir.</td></tr><tr><td>Items</td><td>List</td><td>Sayfa içerisinde dönen veri nesnelerinin listesini içerir.</td></tr></tbody></table>

## Servis Cevap (Items)

<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>Kayıt veya işlemin sistemdeki eşsiz kimliğini temsil eder.</td></tr><tr><td>WalletId</td><td>Guid</td><td>İlgili işlemin gerçekleştiği cüzdanın benzersiz ID numarasıdır.</td></tr><tr><td>TransactionType</td><td>string</td><td>İşlemin kategorisini tanımlar (örneğin: ödeme, iade, transfer).</td></tr><tr><td>Amount</td><td>decimal</td><td>İşlem kapsamında kullanılan toplam tutarı ifade eder.</td></tr><tr><td>GiftAmount</td><td>decimal</td><td>İşlemde hediye bakiyesinden kullanılan miktardır.</td></tr><tr><td>Description</td><td>string</td><td>İşlemle ilgili açıklayıcı kısa bilgi alanıdır.</td></tr><tr><td>ExternalReference</td><td>string</td><td>Harici bir sistemde tanımlanan referans kodudur.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>İşlemin oluşturulma zaman damgasını belirtir.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>İşlemin güncellenmiş olduğu son zaman bilgisidir.</td></tr><tr><td>BalanceAfterTransaction</td><td>decimal</td><td>İşlem sonrası cüzdanda kalan güncel bakiye miktarıdır.</td></tr><tr><td>SourceWalletId</td><td>Guid</td><td>Paranın çıkış yaptığı cüzdanın kimliğini gösterir.</td></tr><tr><td>DestinationWalletId</td><td>Guid</td><td>Paranın gönderildiği hedef cüzdanın kimlik bilgisidir.</td></tr><tr><td>GiftBalanceId</td><td>int</td><td>İşlemde kullanılan hediye bakiyesine ait kimlik numarasıdır.</td></tr><tr><td>MainTransactionId</td><td>Guid</td><td>Bağlantılı asıl işlemin sistemdeki ID bilgisidir.</td></tr><tr><td>UniqueCode</td><td>string</td><td>İşleme özel üretilmiş eşsiz tanımlayıcı koddur.</td></tr><tr><td>UsedGiftBalances</td><td>List</td><td>Kullanımda olan hediye bakiye bilgilerinin listelendiği alandır.</td></tr><tr><td>CashbackAmount</td><td>decimal</td><td>İşlem sonrasında kullanıcıya sağlanan cashback tutarını gösterir.</td></tr></tbody></table>