# 13. Money Transfer (Alias)

## Money Transfer with Wallet 'Alias'

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

{% 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 key used to call the API.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>The general client key used to identify the client.</td></tr></tbody></table>

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

```json
{
  "SourceAlias": "3087472741",
  "DestinationAlias": "5576000164",
  "Amount": 10,
  "Description": "description"
}
```

{% endtab %}
{% endtabs %}

## Service Request

<table><thead><tr><th width="234.54296875">Parameter</th><th width="192.49609375">Type</th><th>Description</th></tr></thead><tbody><tr><td>SourceAlias</td><td>Guid</td><td>The account number from which the money will be withdrawn.</td></tr><tr><td>DestinationAlias</td><td>Guid</td><td>The account number to which the money will be transferred.</td></tr><tr><td>Amount</td><td>decimal</td><td>The amount to be transferred.</td></tr><tr><td>Description</td><td>string</td><td>The description of the relevant transaction.</td></tr></tbody></table>

{% 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": 77.00,
        "AvailableBalance": 77.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:25:29.1042247Z",
        "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 service call has failed.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Indicates whether the service call was successful.</td></tr><tr><td>Errors</td><td>Array</td><td>A list of error details if an error occurred.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>The data set returned in case of a successful 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>The unique identifier of the transaction record.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>The unique identifier of the wallet owner.</td></tr><tr><td>Name</td><td>string</td><td>The name of the wallet owner or the wallet name.</td></tr><tr><td>Alias</td><td>string</td><td>The alias (nickname) defined for the wallet.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>The merchant ID associated with the wallet.</td></tr><tr><td>RegionId</td><td>string</td><td>The region code of the wallet owner.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>The currency code used by the wallet (e.g., TRY, USD).</td></tr><tr><td>Balance</td><td>decimal</td><td>The total balance of the wallet.</td></tr><tr><td>AvailableBalance</td><td>decimal</td><td>The available balance in the wallet.</td></tr><tr><td>TotalGiftBalance</td><td>decimal</td><td>The total gift balance in the wallet.</td></tr><tr><td>BlockedBalance</td><td>decimal</td><td>Blocked (unusable) balance.</td></tr><tr><td>FrozenUntil</td><td>DateTime</td><td>The last date the wallet was frozen.</td></tr><tr><td>IsFrozen</td><td>bool</td><td>Indicates whether the wallet is frozen.</td></tr><tr><td>IsDeleted</td><td>bool</td><td>Indicates whether the wallet 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 transaction ID associated with the transaction.</td></tr></tbody></table>