13. Money Transfer (Alias)

You can use this service to perform money transfers between wallets.

Money Transfer with Wallet 'Alias'

POST {{WalletUrl}}/api/v1/wallet/transfer/by/alias

Note: To use this service, it is mandatory to include the apikeypublic and apiclientpublic parameters in the Header field.

WalletAPI Address

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

Parameter	Type	Required	Description
apikeypublic	string	Yes	The general key used to call the API.
apiclientpublic	string	Yes	The general client key used to identify the client.

Service Reguest - JSON

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

Service Request

Parameter	Type	Description
SourceAlias	Guid	The account number from which the money will be withdrawn.
DestinationAlias	Guid	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.

Service Reguest - 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
}

Service Response

Parameter	Type	Description
IsFailure	bool	Indicates whether the service call has failed.
IsSuccess	bool	Indicates whether the service call was successful.
Errors	Array	A list of error details if an error occurred.
Value	Array<Items>	The data set returned in case of a successful call.

Service Response (Value)

Parameter	Type	Description
Id	Guid	The unique identifier of the transaction record.
WalletOwnerId	Guid	The unique identifier of the wallet owner.
Name	string	The name of the wallet owner or the wallet name.
Alias	string	The alias (nickname) defined for the wallet.
MerchantId	Guid	The merchant ID associated with the wallet.
RegionId	string	The region code of the wallet owner.
CurrencyCode	string	The currency code used by the wallet (e.g., TRY, USD).
Balance	decimal	The total balance of the wallet.
AvailableBalance	decimal	The available balance in the wallet.
TotalGiftBalance	decimal	The total gift balance in the wallet.
BlockedBalance	decimal	Blocked (unusable) balance.
FrozenUntil	DateTime	The last date the wallet was frozen.
IsFrozen	bool	Indicates whether the wallet is frozen.
IsDeleted	bool	Indicates whether the wallet has been deleted.
CreatedAt	DateTime	The creation date of the wallet record.
UpdatedAt	DateTime	The last update date of the wallet record.
TransactionId	Guid	The transaction ID associated with the transaction.