5. Açıklama Güncelle

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

PUT {{WalletUrl}}/api/v1/wallet/transaction/description

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

WalletAPI Adresi

Servise gönderilmesi gereken parametreler şu şekildedir:

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.

Servis İstek - Json

{
  "TransactionId": "95d2b18a-8a91-46e4-8d21-80d76135e4ef",
  "Description": "Updated external transaction description"
}

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

Servis Cevap

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

Servis Cevap (Items)

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