Ctrlk
Test Panel 🧪Paywall 📟Servis Durumu 📊
For the complete documentation index, see llms.txt. This page is also available as Markdown.

2. Wallet ile Getir

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

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

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ı

{
    "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
    }
}
Previous1. Id ile GetirNext3. WalletOwner ile Getir

Last updated