4. Referans ile Getir

Belirtilen ExternalReference değeri ile ilişkili kayıt bilgilerine erişmek için bu servis kullanılmalıdır.

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

GET {{WalletUrl}}/api/v1/wallet/transaction/by/external-reference/5bc276c8-acb5-4cb7-90fe-1d3ff10fbcfb

Not: Bu servisi çağırmadan önce, apikeypublic ve apiclientpublic parametrelerini Header kısmına eklemeniz gereklidir.

WalletAPI Adresi

Gerekli header ve istek parametreleri:

Parametreler ve açıklamaları

Parametre	Tip	Zorunlu	Açıklama
apikeypublic	string	Evet	API erişiminde doğrulama için kullanılan genel anahtar bilgisidir.
apiclientpublic	string	Evet	İsteğin hangi istemciden geldiğini gösteren genel istemci anahtarıdır.

Servisten dönen parametreler şu şekildedir:

Parametreler ve açıklamaları

Parametre	Tip	Açıklama
Id	Guid	İşleme ait sistem tarafından üretilen benzersiz kimlik numarasıdır. UUID formatındadır.
WalletId	String	İşlemin yapıldığı cüzdanın sistemdeki kimlik numarasıdır. Hangi cüzdanla ilişkili olduğunu gösterir.
Alias	String	İşlemin yapıldığı cüzdanın alias'ı
TransactionType	String	İşlemin tipini belirtir. Örneğin "Ödeme", "İade", "Transfer" gibi işlemleri tanımlar.
Amount	Decimal	Gerçekleştirilen işlemin tutarıdır. Para birimi üzerinden ifade edilir.
GiftAmount	Decimal	İşlemde kullanılan hediye bakiye miktarıdır. Normal bakiyeden farklı olarak promosyonel kullanımı temsil eder.
Description	String	İşleme dair açıklayıcı bilgidir. Kullanıcı tarafından veya sistem tarafından yazılabilir.
ExternalReference	String	İşleme dış kaynaklı bir sistem üzerinden verilen referans numarasıdır. Genellikle entegrasyon sistemleri için kullanılır.
CreatedAt	DateTime	İşlemin oluşturulduğu tarih ve saat bilgisidir. UTC veya sistem saatine göre kaydedilir.
UpdatedAt	DateTime	İşlemin en son güncellendiği tarih ve saat bilgisidir. Bir değişiklik olduğunda güncellenir.
BalanceAfterTransaction	Decimal	İşlem gerçekleştikten sonra cüzdanda kalan bakiye miktarıdır. Hesap güncellemeleri sonrası değeri ifade eder.
BlockedBalanceAfterTransaction	Decimal	İşlem sonrası cüzdanın bloke bakiyesi.
AvailableBalanceAfterTransaction	Decimal	İşlem sonrası cüzdanın kullanılabilir bakiyesi.
GiftBalanceBalanceAfterTransaction	Decimal	İşlem sonrası cüzdanın toplam hediye bakiyesi.
CurrencyCode	String	İşlemin gerçekleştiği para birimi kodu.
SourceWalletId	Guid	Transfer işlemlerinde kaynak cüzdanın tanımlayıcısı
DestinationWalletId	Guid	Transfer işlemlerinde hedef cüzdanın tanımlayıcısı.
GiftBalanceId	Guid	Varsa işlemle ilişkili hediye bakiye kaydının tanımlayıcısı.
MainTransactionId	Guid	Varsa bu işlemin bağlı olduğu ana işlemin tanımlayıcısı
UniqueCode	String	İşleme ait benzersiz kod
UsedGiftBalances	array	İşlemde kullanılan hediye bakiyelerin listesi
UsedGiftBalances > Id	guid	Kullanılan hediye bakiye kaydının benzersiz tanımlayıcısı
UsedGiftBalances > Amount	decimal	Bu işlemde kullanılan hediye bakiye tutarı
UsedGiftBalances > ExpirationDate	datetime	Hediye bakiyenin son kullanma tarihi. null ise süresizdir
UsedGiftBalances > IsUnlimited	bool	ExpirationDate değeri null ise true döner, hediye bakiyenin süresiz olduğunu belirtir
UsedGiftBalances > Description	string	Hediye bakiyeye ait açıklama veya not
CashbackAmount	decimal	Varsa işleme ait cashback tutarı
ExternalTransactionTypeId	guid	Kendi sisteminizdeki bir işlem tipini bizim sistemimize ekledikten sonra size verdiğimiz id.
ExternalTransactionTypeEnum	string	Kendi sisteminizdeki bir işlem tipini bizim sistemimize eklerken verdiğiniz unique değer.
ExternalTransactionTypeName	string	Kendi sisteminizdeki işlem tipinin görünen adı

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
        }
    ]
}