> 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/4.-referans-ile-getir.md).

# 4. Referans ile Getir

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

<mark style="color:green;">`GET`</mark> `{{WalletUrl}}/api/v1/wallet/transaction/by/external-reference/5bc276c8-acb5-4cb7-90fe-1d3ff10fbcfb`

{% 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": [
        {
            "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": "bdf7ab45-2437-4f3b-ab56-5402f1c69654",
            "UsedGiftBalances": null,
            "CashbackAmount": 0,
            "ExternalTransactionTypeId" :null,
            "ExternalTransactionTypeEnum" :null,
            "ExternalTransactionTypeName" :null
        }
    ]
}
```

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