> 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/2.-wallet-ile-getir.md). # 2. Wallet ile Getir ## **Cüzdan Kaydını** WalletId ile Tanımla `GET` `{{WalletUrl}}/api/v1/wallet/transaction/by/wallet/:walletId?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. [**WalletAPI Adresi**](/ortam.md) {% endhint %} **Gerekli header ve istek parametreleri:**
Parametreler ve açıklamaları
ParametreTipZorunluAçıklama
apikeypublicstringEvetAPI erişiminde doğrulama için kullanılan genel anahtar bilgisidir.
apiclientpublicstringEvetİsteğin hangi istemciden geldiğini gösteren genel istemci anahtarıdır.
**Servisten dönen parametreler şu şekildedir:**
Parametreler ve açıklamaları
ParametreTipAçıklama
IdGuidİşleme ait sistem tarafından üretilen benzersiz kimlik numarasıdır. UUID formatındadır.
WalletIdStringİşlemin yapıldığı cüzdanın sistemdeki kimlik numarasıdır. Hangi cüzdanla ilişkili olduğunu gösterir.
AliasStringİşlemin yapıldığı cüzdanın alias'ı
TransactionTypeStringİşlemin tipini belirtir. Örneğin "Ödeme", "İade", "Transfer" gibi işlemleri tanımlar.
AmountDecimalGerçekleştirilen işlemin tutarıdır. Para birimi üzerinden ifade edilir.
GiftAmountDecimalİşlemde kullanılan hediye bakiye miktarıdır. Normal bakiyeden farklı olarak promosyonel kullanımı temsil eder.
DescriptionStringİşleme dair açıklayıcı bilgidir. Kullanıcı tarafından veya sistem tarafından yazılabilir.
ExternalReferenceStringİşleme dış kaynaklı bir sistem üzerinden verilen referans numarasıdır. Genellikle entegrasyon sistemleri için kullanılır.
CreatedAtDateTimeİşlemin oluşturulduğu tarih ve saat bilgisidir. UTC veya sistem saatine göre kaydedilir.
UpdatedAtDateTimeİşlemin en son güncellendiği tarih ve saat bilgisidir. Bir değişiklik olduğunda güncellenir.
BalanceAfterTransactionDecimalİşlem gerçekleştikten sonra cüzdanda kalan bakiye miktarıdır. Hesap güncellemeleri sonrası değeri ifade eder.
BlockedBalanceAfterTransactionDecimalİşlem sonrası cüzdanın bloke bakiyesi.
AvailableBalanceAfterTransactionDecimalİşlem sonrası cüzdanın kullanılabilir bakiyesi.
GiftBalanceBalanceAfterTransactionDecimalİşlem sonrası cüzdanın toplam hediye bakiyesi.
CurrencyCodeStringİşlemin gerçekleştiği para birimi kodu.
SourceWalletIdGuidTransfer işlemlerinde kaynak cüzdanın tanımlayıcısı
DestinationWalletIdGuidTransfer işlemlerinde hedef cüzdanın tanımlayıcısı.
GiftBalanceIdGuidVarsa işlemle ilişkili hediye bakiye kaydının tanımlayıcısı.
MainTransactionIdGuidVarsa bu işlemin bağlı olduğu ana işlemin tanımlayıcısı
UniqueCodeStringİşleme ait benzersiz kod
UsedGiftBalancesarrayİşlemde kullanılan hediye bakiyelerin listesi
UsedGiftBalances > IdguidKullanılan hediye bakiye kaydının benzersiz tanımlayıcısı
UsedGiftBalances > AmountdecimalBu işlemde kullanılan hediye bakiye tutarı
UsedGiftBalances > ExpirationDatedatetimeHediye bakiyenin son kullanma tarihi. null ise süresizdir
UsedGiftBalances > IsUnlimitedboolExpirationDate değeri null ise true döner, hediye bakiyenin süresiz olduğunu belirtir
UsedGiftBalances > DescriptionstringHediye bakiyeye ait açıklama veya not
CashbackAmountdecimalVarsa işleme ait cashback tutarı
ExternalTransactionTypeIdguidKendi sisteminizdeki bir işlem tipini bizim sistemimize ekledikten sonra size verdiğimiz id.
ExternalTransactionTypeEnumstringKendi sisteminizdeki bir işlem tipini bizim sistemimize eklerken verdiğiniz unique değer.
ExternalTransactionTypeNamestringKendi sisteminizdeki işlem tipinin görünen adı
{% tabs %} {% tab title="JSON" %} {% code lineNumbers="true" %} ```json { "IsSuccess": true, "IsFailure": false, "Value": { "Items": [ { "Id": "c7cbc07d-1241-4e15-9717-4dcd844c5e82", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "Refund", "Amount": 100.00, "GiftAmount": null, "Description": "Refund of Purchase bea70a60-c631-4c3e-963a-6188ef449601", "ExternalReference": "bea70a60-c631-4c3e-963a-6188ef449601", "CreatedAt": "2025-08-20T11:58:38.651619Z", "UpdatedAt": null, "BalanceAfterTransaction": 99901.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 99901.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": "f6f2fc96-8df1-4674-8b71-0cec7cdaa312", "UniqueCode": "00e54514-1050-4ee4-ab43-571b8bf4ef4d", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "26bb3157-2733-48c0-b228-0daa3ffbabbd", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "CashbackRefund", "Amount": 1.00, "GiftAmount": null, "Description": "Cashback rollback for refund of Cashback bea70a60-c631-4c3e-963a-6188ef449601", "ExternalReference": "bea70a60-c631-4c3e-963a-6188ef449601", "CreatedAt": "2025-08-20T11:58:38.6516Z", "UpdatedAt": null, "BalanceAfterTransaction": 99801.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 99801.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": "f6f2fc96-8df1-4674-8b71-0cec7cdaa312", "UniqueCode": "0c552a65-92d1-402d-803f-66f413acb7a3", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "b8bedc85-2572-440f-be90-99848d7076c4", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "CashbackCancel", "Amount": 1.00, "GiftAmount": null, "Description": "Cashback rollback for cancel of Cashback 6ddf4d59-34f9-447a-9168-c1846bdb5d79", "ExternalReference": "6ddf4d59-34f9-447a-9168-c1846bdb5d79", "CreatedAt": "2025-08-20T11:57:27.002273Z", "UpdatedAt": null, "BalanceAfterTransaction": 99901.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 99901.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": "24d912c2-11b1-4fdf-b0e7-6483e526e523", "UniqueCode": "778bf487-52fe-4ef4-8cfb-0fd4595b7989", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "e1638d79-b78b-4052-934d-9ff49318a981", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "Cancel", "Amount": 10.00, "GiftAmount": null, "Description": "Cancel of Purchase 6ddf4d59-34f9-447a-9168-c1846bdb5d79", "ExternalReference": "6ddf4d59-34f9-447a-9168-c1846bdb5d79", "CreatedAt": "2025-08-20T11:57:27.002067Z", "UpdatedAt": null, "BalanceAfterTransaction": 99903.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 99903.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": "24d912c2-11b1-4fdf-b0e7-6483e526e523", "UniqueCode": "44255766-5ff1-49b9-a029-1254bad3a33e", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "eea3693b-7942-400b-a713-0052652b90a1", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "Cashback", "Amount": 1.00, "GiftAmount": null, "Description": "Cashback from External Campaign campaign", "ExternalReference": "6ddf4d59-34f9-447a-9168-c1846bdb5d79", "CreatedAt": "2025-08-20T11:56:53.010756Z", "UpdatedAt": null, "BalanceAfterTransaction": 99893.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 99893.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": "24d912c2-11b1-4fdf-b0e7-6483e526e523", "UniqueCode": "3f6ce76f-f9f1-44d0-be0d-636865e5cac4", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "24d912c2-11b1-4fdf-b0e7-6483e526e523", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "Purchase", "Amount": 10.00, "GiftAmount": null, "Description": "string", "ExternalReference": "6ddf4d59-34f9-447a-9168-c1846bdb5d79", "CreatedAt": "2025-08-20T11:56:51.821127Z", "UpdatedAt": null, "BalanceAfterTransaction": 99891.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 99891.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": null, "UniqueCode": "6524c873-4af7-409d-baa2-31f28597b31f", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "784f8d50-c2cc-4911-b82b-2f8f49a0b98f", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "Purchase", "Amount": 100.00, "GiftAmount": null, "Description": "string", "ExternalReference": "8e0c7f38-d63e-4c79-b6e6-c53751d205cf", "CreatedAt": "2025-08-20T11:56:24.821056Z", "UpdatedAt": null, "BalanceAfterTransaction": 99900.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 99900.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": null, "UniqueCode": "3ce16452-ccb1-46d0-8419-2127659abca6", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "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": "7b43dae0-2f05-4bfc-903b-9a82ee754566", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "29d040bc-5169-4288-b4f5-01862b552971", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "OutgoingTransfer", "Amount": 1.00, "GiftAmount": null, "Description": "string", "ExternalReference": "db163b15-aa15-49bc-afec-529959b9fbc2", "CreatedAt": "2025-08-20T11:51:23.09447Z", "UpdatedAt": null, "BalanceAfterTransaction": 0.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 0.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": null, "UniqueCode": "93902fc4-4a58-486c-b0a2-be9e1241d9c1", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "b2fe593f-7ac1-4135-ad30-9cfed3e489dd", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "IncomingTransfer", "Amount": 1.00, "GiftAmount": null, "Description": "string", "ExternalReference": "39693c50-270e-463c-9c22-ba72449f693e", "CreatedAt": "2025-08-20T11:50:44.048803Z", "UpdatedAt": null, "BalanceAfterTransaction": 1.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 1.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": null, "UniqueCode": "7950ee19-a687-4890-b9bc-4138358c8e61", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "6077149a-6eb2-4a18-844b-54afcfd1346f", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "OutgoingTransfer", "Amount": 1.00, "GiftAmount": null, "Description": "string", "ExternalReference": "2a12f4bc-0e8f-4392-86d7-e46136bc1070", "CreatedAt": "2025-08-20T11:47:02.448464Z", "UpdatedAt": null, "BalanceAfterTransaction": 0.80, "BlockedBalanceAfterTransaction": 0.00, "AvailableBalanceAfterTransaction": 0.80, "GiftBalanceBalanceAfterTransaction": 0.00, "CurrencyCode": "TRY", "SourceWalletId": null, "DestinationWalletId": null, "GiftBalanceId": null, "MainTransactionId": null, "UniqueCode": "275c1364-6734-4b40-8ce3-14647314fd3c", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null }, { "Id": "f19ea4b9-9b42-48e6-9fdd-a3bc519d60ab", "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed", "Alias": "2816220769", "TransactionType": "Withdrawal", "Amount": 1.00, "GiftAmount": null, "Description": "string", "ExternalReference": "9e1348e3-807e-4754-a567-b907cd4e5547", "CreatedAt": "2025-08-20T10:10:45.681469Z", "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": "17826804-9814-4f8e-a29e-c3912a811f10", "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": "49a6f3e2-a42e-4574-b0dc-ba740549c785", "UsedGiftBalances": null, "CashbackAmount": 0, "ExternalTransactionTypeId" :null, "ExternalTransactionTypeEnum" :null, "ExternalTransactionTypeName" :null } ], "PageNumber": 1, "TotalPages": 1, "TotalCount": 24, "HasPreviousPage": false, "HasNextPage": false } } ``` {% endcode %} {% endtab %} {% endtabs %}