1. Create (System Level)

You can create a commission that will apply to all wallet owners and their wallets across the system using this service.

Create Commission Across the System

POST{{WalletUrl}}/api/v1/commission/by/merchant

Note: To use this service, the apikeypublic and apiclientpublic parameters must be included 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	It is the general key used to provide API access.
apiclientpublic	string	Yes	It is the public identification key specific to the API client.

Service Reguest - JSON

{
  "TransactionType": 1, // Deposit = 1, Withdrawal = 2, Purchase = 3, OutgoingTransfer = 4, IncomingTransfer = 13, GiftBalanceAdded = 5, GiftBalanceUsed = 6, GiftBalanceExpired = 7, Cashback = 8, Bonus = 9, Refund = 10, TransferReversal = 11, Fee = 12
  "FeeType": "Fixed", // Fixed, Percentage
  "FeeValue": 1,
  "CurrencyCode": "try", // usd, eur, all
  "ConditionType": null, // None = 0, TransactionCount = 1, TransactionAmount = 2
  "ConditionThreshold": 0
}

Service Reguest - JSON

{
    "Value": {
        "Id": "6a07c25a-0843-46b8-b167-5013f67feffe",
        "Level": "Merchant",
        "MerchantId": 2071,
        "WalletOwnerId": null,
        "WalletId": null,
        "TransactionType": "Deposit",
        "FeeType": "Fixed",
        "FeeValue": 1,
        "ConditionType": "None",
        "ConditionThreshold": 0,
        "CurrencyCode": "try",
        "IsActive": true,
        "CreatedAt": "2025-05-01T14:23:07.7736605Z",
        "UpdatedAt": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}

Service Response

Parameter	Type	Description
IsFailure	bool	Indicates whether the operation was unsuccessful. If true, an error has occurred.
IsSuccess	bool	Indicates whether the operation was successful. If true, it has been completed successfully.
Errors	Array	A list containing the details of any errors that occurred.
Value	Array	Contains the main data content returned in the case of a successful response.

Service Response (Value)

Parameter	Type	Description
Id	Guid	The unique identifier for the commission.
Level	string	Commission Level See: Commission Levels
MerchantId	int	The merchant (your) PayWall identification information.
WalletOwnerId	Guid	The identification information of the wallet owner to whom the commission is assigned.
WalletId	Guid	The wallet identification information to which the commission is assigned.
TransactionType	string	Transaction Type for Commission See: Transaction Types
FeeType	string	The type information for which the commission will be applied. See: Cost Types
FeeValue	decimal	The value of the commission cost.
ConditionType	string	The condition type of the commission. See: Cost Types
ConditionThreshold	decimal	The condition value for the commission.
CurrencyCode	string	The currency in which the commission will be applied.
IsActive	bool	The active status of the commission.
CreatedAt	DateTime	The creation date of the record.
UpdatedAt	DateTime	The date when the record was last updated.