> 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/payment-orchestration-integration-document/wallet-services/3.-transactions/1.-get-by-id.md).

# 1. Get by Id

## Identify the Wallet Record by Id

<mark style="color:green;">`GET`</mark> `{{WalletUrl}}/api/v1/wallet/transaction/by/id/:id`&#x20;

{% hint style="info" %}
**Note:** Before calling this service, you must include the apikeypublic and apiclientpublic parameters in the Header section.

[<mark style="color:green;">**WalletAPI Address**</mark>](/payment-orchestration-integration-document/environment.md)
{% endhint %}

**The parameters that need to be sent to the service are as follows:**

<table><thead><tr><th width="162">Parameter</th><th width="109.84375">Type</th><th width="147.68359375">Compolsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>It is the general key used for authentication in API service requests.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>It is the general client key used to specify which client the API call is coming from.</td></tr></tbody></table>

{% tabs %}
{% tab title="Service Reguest - 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": "48a7f588-7430-4038-8a35-d6276bd5e36a",
        "UsedGiftBalances": null,
        "CashbackAmount": 0
    }
}
```

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

## Service Response

<table><thead><tr><th width="192">Parameter</th><th width="147.89192708333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>It is the value that indicates whether the API call was successful or not. (true/false)</td></tr><tr><td>IsSuccess</td><td>bool</td><td>It is the value that indicates whether the API call was successful or not. (true/false)</td></tr><tr><td>Errors</td><td>Array</td><td>It is the field containing the error messages and details that occurred during the service call.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>It represents the main data set returned in a successful API call.</td></tr></tbody></table>

## Service Response (Value)

<table><thead><tr><th width="234.05859375">Parameter</th><th width="162.38671875">Type</th><th width="348.94140625">Description</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>It is the unique identifier of the transaction or record.</td></tr><tr><td>WalletId</td><td>Guid</td><td>It is the unique identifier of the wallet where the transaction took place.</td></tr><tr><td>TransactionType</td><td>string</td><td>It specifies the type of the transaction (e.g., payment, refund, transfer, etc.).</td></tr><tr><td>Amount</td><td>decimal</td><td>It specifies the amount of principal used in the transaction.</td></tr><tr><td>GiftAmount</td><td>decimal</td><td>It specifies the amount of gift balance used during the transaction.</td></tr><tr><td>Description</td><td>string</td><td>It is the description or note related to the transaction.</td></tr><tr><td>ExternalReference</td><td>string</td><td>It is the reference number used in external systems for the transaction.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>It is the date and time when the transaction was created.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>It is the date and time when the transaction was last updated.</td></tr><tr><td>BalanceAfterTransaction</td><td>decimal</td><td>It is the current balance in the wallet after the transaction.</td></tr><tr><td>SourceWalletId</td><td>Guid</td><td>It is the identity number of the wallet that initiated (sent) the transaction.</td></tr><tr><td>DestinationWalletId</td><td>Guid</td><td>It is the identity number of the wallet that is the target (receiver) of the transaction.</td></tr><tr><td>GiftBalanceId</td><td>int</td><td>It is the identifier of the gift balance used during the transaction.</td></tr><tr><td>MainTransactionId</td><td>Guid</td><td>It is the identifier of the parent transaction (especially for refunds and partial transactions).</td></tr><tr><td>UniqueCode</td><td>string</td><td>It is the unique code generated specifically for the transaction.</td></tr><tr><td>UsedGiftBalances</td><td>List</td><td>It is the list of gift balances used in the transaction if multiple gift balances were utilized.</td></tr><tr><td>CashbackAmount</td><td>decimal</td><td>It specifies the cashback (refund) amount earned as a result of the transaction.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.paywall.one/payment-orchestration-integration-document/wallet-services/3.-transactions/1.-get-by-id.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.