14. Money Transfer (Wallet - Alias)

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

Money Transfer from Wallet Id to Wallet Alias

POST{{WalletUrl}}/api/v1/wallet/transfer/by/wallet/to/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 public key used for API access.
apiclientpublic	string	Yes	The public key used to identify the client.

Service Reguest - JSON

{
  "SourceWalletId": "1fef5f3f-3c7b-4aa7-b0dd-713ba391765d",
  "DestinationAlias": "7062444779",
  "Amount": 1,
  "Description": "description"
}

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.

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": 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
}

Service Request

Parameter	Type	Description
IsFailure	bool	It returns true if the service transaction failed, otherwise false.
IsSuccess	bool	It returns true if the service transaction was successful, otherwise false.
Errors	Array	Contains the error messages encountered during the transaction.
Value	Array<Items>	The successful data set returned from the service.

Service Request (Value)

Parameter	Type	Description
Id	Guid	The unique identifier of the entity in the system.
WalletOwnerId	Guid	The unique identifier of the wallet owner.
Name	string	The name of the wallet owner.
Alias	string	The alias (nickname) assigned to the wallet owner.
MerchantId	Guid	The unique identifier of the relevant merchant.
RegionId	string	The geographical region ID to which the wallet is associated.
CurrencyCode	string	The currency code of the wallet (e.g., TRY, USD).
Balance	decimal	The total balance in the wallet.
AvailableBalance	decimal	The usable balance available for transactions.
TotalGiftBalance	decimal	The total gift balance in the wallet.
BlockedBalance	decimal	The blocked balance that cannot be used for transactions.
FrozenUntil	DateTime	The date/time information when the wallet was last frozen.
IsFrozen	bool	The value indicating whether the wallet is frozen.
IsDeleted	bool	The value indicating whether the wallet has been deleted from the system.
CreatedAt	DateTime	The date/time when the wallet record was created.
UpdatedAt	DateTime	The date/time when the wallet record was last updated.
TransactionId	Guid	The transaction ID associated with the last transaction.