15. 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	Compulsory	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": "7883fb19-2359-4a9b-b917-f08a259898ed",
  "DestinationAlias": "8460440228",
  "Amount": 1,
  "Description": "string",
  "ExternalReference": "{{$guid}}"
}

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
TransferId	Guid	Transfer transaction identifier information
SourceTransactionId	Guid	Identifier information of the transaction generated for the source wallet account
DestinationTransactionId	Guid	Identifier information of the transaction generated for the recipient wallet account
SourceWalletId	Guid	Source wallet identifier information
DestinationWalletId	Guid	Recipient wallet identifier information
SourceWalletBalanceAfterTransaction	decimal	Source wallet balance after the transaction
DestinationWalletBalanceAfterTransaction	decimal	Recipient wallet balance after the transaction