# 12. Money Transfer (Wallet)

## Money Transfer with Wallet 'Id'

<mark style="color:yellow;">`POST`</mark> `{{WalletUrl}}/api/v1/wallet/transfer`

{% hint style="info" %}
**Note:** To use this service, it is mandatory to include the **apikeypublic** and **apiclientpublic** parameters in the Header field.

\
[<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>The general API key required to use the service.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>The client ID required for service access.</td></tr></tbody></table>

{% tabs %}
{% tab title="Service Reguest - JSON" %}

```json
{
  "SourceWalletId": "eb6d76b1-eddc-4ce4-8538-93696ff15fa2",
  "DestinationWalletId": "1fef5f3f-3c7b-4aa7-b0dd-713ba391765d",
  "Amount": "10",
  "Description": "transfer"
}
```

{% endtab %}
{% endtabs %}

## Service Request

| Parameter           | Type    | Description                                                                     |
| ------------------- | ------- | ------------------------------------------------------------------------------- |
| SourceWalletId      | Guid    | The identity information of the account from which the money will be withdrawn. |
| DestinationWalletId | Guid    | The identity information of the account to which the money will be transferred. |
| Amount              | decimal | The amount to be transferred.                                                   |
| Description         | string  | The description of the relevant transaction.                                    |

{% tabs %}
{% tab title="Service Reguest - JSON" %}
{% code lineNumbers="true" %}

```json
{
    "Value": {
        "Id": "830f8449-c816-4706-9933-dde252fc44d0",
        "WalletOwnerId": "9edb23f2-7362-42a8-8eb4-0c89ffb397b0",
        "Name": "Elisabeth",
        "Alias": "3087472741",
        "MerchantId": 2071,
        "RegionId": 1,
        "CurrencyCode": "TRY",
        "Balance": 88.00,
        "AvailableBalance": 88.00,
        "TotalGiftBalance": 0,
        "BlockedBalance": 0,
        "FrozenUntil": "0001-01-01T00:00:00",
        "IsFrozen": false,
        "IsDeleted": false,
        "CreatedAt": "2025-05-01T17:24:20.703144Z",
        "UpdatedAt": "2025-05-01T17:24:47.029242Z",
        "TransactionId": null
    },
    "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>Indicates whether the transaction has failed.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Indicates whether the transaction was successful.</td></tr><tr><td>Errors</td><td>Array</td><td>Contains the error messages that occurred during the transaction.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>Contains the data set returned as a result of the transaction.</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>Unique identifier of the wallet record.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>Unique identifier of the wallet owner.</td></tr><tr><td>Name</td><td>string</td><td>Name of the wallet owner.</td></tr><tr><td>Alias</td><td>string</td><td>Alias designated for the wallet.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>Merchant ID associated with the wallet.</td></tr><tr><td>RegionId</td><td>string</td><td>Region code to which the wallet belongs.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>Currency code of the wallet (e.g., TRY, USD).</td></tr><tr><td>Balance</td><td>decimal</td><td>Total current balance of the wallet.</td></tr><tr><td>AvailableBalance</td><td>decimal</td><td>Instantly available balance amount.</td></tr><tr><td>TotalGiftBalance</td><td>decimal</td><td>Total gift balance amount.</td></tr><tr><td>BlockedBalance</td><td>decimal</td><td>Blocked (unusable) balance amount.</td></tr><tr><td>FrozenUntil</td><td>DateTime</td><td>The date and time information when the wallet was frozen (if applicable).</td></tr><tr><td>IsFrozen</td><td>bool</td><td>Indicates whether the wallet has been temporarily frozen.</td></tr><tr><td>IsDeleted</td><td>bool</td><td>Indicates whether the wallet record has been deleted.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>The creation date of the wallet record.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>The last update date of the wallet record.</td></tr><tr><td>TransactionId</td><td>Guid</td><td>The unique transaction ID generated as a result of the transaction.</td></tr></tbody></table>