12. Money Transfer (Wallet)

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

Money Transfer with Wallet 'Id'

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

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 API key required to use the service.
apiclientpublic	string	Yes	The client ID required for service access.

Service Reguest - JSON

{
  "SourceWalletId": "eb6d76b1-eddc-4ce4-8538-93696ff15fa2",
  "DestinationWalletId": "1fef5f3f-3c7b-4aa7-b0dd-713ba391765d",
  "Amount": "10",
  "Description": "transfer"
}

Service Request

Parameter	Type	Description
SourceWalletId	Guid	The identity information of the account from which the money will be withdrawn.
DestinationWalletId	Guid	The identity information of the account 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": 88.00,
        "AvailableBalance": 88.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:24:47.029242Z",
        "TransactionId": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	Indicates whether the transaction has failed.
IsSuccess	bool	Indicates whether the transaction was successful.
Errors	Array	Contains the error messages that occurred during the transaction.
Value	Array<Items>	Contains the data set returned as a result of the transaction.

Service Response (Value)

Parameter	Type	Description
Id	Guid	Unique identifier of the wallet record.
WalletOwnerId	Guid	Unique identifier of the wallet owner.
Name	string	Name of the wallet owner.
Alias	string	Alias designated for the wallet.
MerchantId	Guid	Merchant ID associated with the wallet.
RegionId	string	Region code to which the wallet belongs.
CurrencyCode	string	Currency code of the wallet (e.g., TRY, USD).
Balance	decimal	Total current balance of the wallet.
AvailableBalance	decimal	Instantly available balance amount.
TotalGiftBalance	decimal	Total gift balance amount.
BlockedBalance	decimal	Blocked (unusable) balance amount.
FrozenUntil	DateTime	The date and time information when the wallet was frozen (if applicable).
IsFrozen	bool	Indicates whether the wallet has been temporarily frozen.
IsDeleted	bool	Indicates whether the wallet record 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 unique transaction ID generated as a result of the transaction.