> 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/2.-wallet/15.-money-transfer-wallet-alias.md).

# 15. Money Transfer (Wallet - Alias)

## Money Transfer from Wallet Id to Wallet Alias

<mark style="color:yellow;">`POST`</mark>`{{WalletUrl}}/api/v1/wallet/transfer/by/wallet/to/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>](/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="94.0625">Type</th><th width="143.34765625">Compulsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>The public key used for API access.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>The public key used to identify the client.</td></tr></tbody></table>

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

```json
{
  "SourceWalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
  "DestinationAlias": "8460440228",
  "Amount": 1,
  "Description": "string",
  "ExternalReference": "{{$guid}}"
}
```

{% endtab %}
{% endtabs %}

## Service Request

| Parameter        | Type    | Description                                                                     |
| ---------------- | ------- | ------------------------------------------------------------------------------- |
| SourceWalletId   | Guid    | The identity information of the account from which the money will be withdrawn. |
| DestinationAlias | string  | The account number 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": 75.00,
        "AvailableBalance": 75.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:29:57.9469992Z",
        "TransactionId": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}
```

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

## Service Request

<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 returns true if the service transaction failed, otherwise false.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>It returns true if the service transaction was successful, otherwise false.</td></tr><tr><td>Errors</td><td>Array</td><td>Contains the error messages encountered during the transaction.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>The successful data set returned from the service.</td></tr></tbody></table>

## Service Request (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>TransferId</td><td>Guid</td><td>Transfer transaction identifier information</td></tr><tr><td>SourceTransactionId</td><td>Guid</td><td>Identifier information of the transaction generated for the source wallet account</td></tr><tr><td>DestinationTransactionId</td><td>Guid</td><td>Identifier information of the transaction generated for the recipient wallet account</td></tr><tr><td>SourceWalletId</td><td>Guid</td><td>Source wallet identifier information</td></tr><tr><td>DestinationWalletId</td><td>Guid</td><td>Recipient wallet identifier information</td></tr><tr><td>SourceWalletBalanceAfterTransaction</td><td>decimal</td><td>Source wallet balance after the transaction</td></tr><tr><td>DestinationWalletBalanceAfterTransaction</td><td>decimal</td><td>Recipient wallet balance after the transaction</td></tr></tbody></table>