3. Create

This service should be called to add new data to the system.

Create Wallet

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

Note: Before making the service call, the apikeypublic and apiclientpublic information must be included in the Header section.

WalletAPI Address

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

Parameter	Type	Required	Description
apikeypublic	string	Evet	It is the public access key used for authentication in API requests.
apiclientpublic	string	Evet	It is the public key that specifies the identity of the client making the API call.

Service Request - JSON

{
  "WalletOwnerId": "9edb23f2-7362-42a8-8eb4-0c89ffb397b0",
  "Name": "{{$randomFirstName}}",
  "RegionId": 1,
  "CurrencyCode": "try", // usd, eur, all
  "Alias": "1234567890", // 10 digit number
  "Description": "Cüzdanım"
}

Service Request

Parameter	Type	Description
WalletOwnerId	Guid	Wallet owner's identity information
Name	string	The name to be assigned to the wallet account
RegionId	int	Country identity information for the wallet See: Regions
CurrencyCode	string	Currency See: Currency
Alias	string	Unique wallet number
Description	string	Description to be assigned to the wallet account

Service Request - JSON

{
    "Value": {
        "Id": "30bac1c0-ad6b-4c50-a52e-1b34f9b487a7",
        "WalletOwnerId": "b5708099-be62-4d34-af06-27132082eb78",
        "Name": "Wilson",
        "Alias": "8203287943",
        "MerchantId": 2071,
        "RegionId": 1,
        "CurrencyCode": "TRY",
        "Balance": 0,
        "AvailableBalance": 0,
        "TotalGiftBalance": 0,
        "BlockedBalance": 0,
        "FrozenUntil": "0001-01-01T00:00:00",
        "IsFrozen": false,
        "IsDeleted": false,
        "CreatedAt": "2025-04-24T09:05:47.980805Z",
        "UpdatedAt": null,
        "TransactionId": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	The field that indicates whether the API call was successful or not.
IsSuccess	bool	It is the value that indicates whether the service call was successfully completed or not.
Errors	Array	It is the data structure that lists the error information encountered during the request.
Value	Array<Items>	It is the list structure representing the main data object returned by the service.

Service Response (Value)

Parameter	Type	Description
Id	Guid	It is the unique identifier of the entity recorded in the system.
WalletOwnerId	Guid	It is the unique identification information of the wallet owner.
Name	string	It is the name or business title of the wallet owner.
Alias	string	It is the alternate name or short name assigned to the wallet.
MerchantId	Guid	It is the merchant ID associated with the wallet.
RegionId	string	It is the code representing the geographic region where the wallet owner is registered.
CurrencyCode	string	It is the international currency code of the currency used (e.g., TRY, USD).
Balance	decimal	It is the total available balance of the wallet.
AvailableBalance	decimal	It represents the amount of balance available for use.
TotalGiftBalance	decimal	It is the total gift balance amount in the wallet.
BlockedBalance	decimal	It is the blocked balance amount that cannot be used.
FrozenUntil	DateTime	It is the date that remains valid until the end of the wallet's frozen period.
IsFrozen	bool	It is the status field that indicates whether the wallet is currently frozen.
IsDeleted	bool	It is the field that indicates whether the wallet has been deleted from the system.
CreatedAt	DateTime	It is the date and time when the record was created in the system.
UpdatedAt	DateTime	It is the timestamp when the record was last updated in the system.
TransactionId	Guid	It is the identifier for the last transaction made from the wallet account.