# 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>](https://developer.paywall.one/payment-orchestration-integration-document/environment)
{% endhint %}

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

<table><thead><tr><th width="162">Parameter</th><th width="79">Type</th><th width="107">Required</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
{
    "Value": {
        "Id": "a7b97d5c-d4ed-447b-ac01-1192839e3124",
        "WalletId": "30bac1c0-ad6b-4c50-a52e-1b34f9b487a7",
        "TransactionType": "Deposit",
        "Amount": 1.00,
        "GiftAmount": null,
        "Description": "description",
        "ExternalReference": "seamless.hps",
        "CreatedAt": "2025-04-24T09:06:47.215924Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 1.00,
        "SourceWalletId": null,
        "DestinationWalletId": null,
        "GiftBalanceId": null,
        "MainTransactionId": null,
        "UniqueCode": "a4db64de-a6c0-4c2d-bb8c-b93e0683a67b",
        "UsedGiftBalances": null,
        "CashbackAmount": 0
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}
```

{% 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>
