> 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/14.-money-transfer-alias.md).

# 14. 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>](/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="91.36328125">Type</th><th width="139.52734375">Description</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": "8460440228",
  "DestinationAlias": "2816220769",
  "Amount": 1,
  "Description": "string",
  "ExternalReference": "{{$guid}}"
}
```

{% 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
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "TransferId": "fdcc42cc-5eee-43b0-8bec-7111688feee5",
        "SourceTransactionId": "170a91bc-f60e-400a-9b98-5ab2c64dc70e",
        "DestinationTransactionId": "b2fe593f-7ac1-4135-ad30-9cfed3e489dd",
        "SourceWalletId": "2ea244d1-6ed2-4eca-a84b-273c62f64606",
        "DestinationWalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "SourceWalletBalanceAfterTransaction": 1.00,
        "DestinationWalletBalanceAfterTransaction": 1.80
    }
}
```

{% 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>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>Kaynak cüzdan kimlik bilgisi</td></tr><tr><td>DestinationWalletId</td><td>Guid</td><td>Alıcı cüzdan kimlik bilgisi</td></tr><tr><td>SourceWalletBalanceAfterTransaction</td><td>decimal</td><td>Kaynak cüzdanın işlem sonrasındaki bakiyesi</td></tr><tr><td>DestinationWalletBalanceAfterTransaction</td><td>decimal</td><td>Alıcı cüzdanın işlem sonrasındaki bakiyesi</td></tr></tbody></table>