# 1. Create (System Level)

## **Create Commission Across the System**

<mark style="color:yellow;">`POST`</mark>`{{WalletUrl}}/api/v1/commission/by/merchant`&#x20;

{% hint style="info" %}
**Note:** To use this service, the **apikeypublic** and **apiclientpublic** parameters must be included in the Header field.

\
[<mark style="color:green;">**WalletAPI Address**</mark>](https://developer.paywall.one/payment-orchestration-integration-document/environment)
{% endhint %}

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

<table><thead><tr><th width="162">Parameter</th><th width="79">Type</th><th width="107">Required</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>It is the general key used to provide API access.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>It is the public identification key specific to the API client.</td></tr></tbody></table>

{% tabs %}
{% tab title="Service Reguest - JSON" %}

```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
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Service Reguest - JSON" %}
{% code lineNumbers="true" %}

```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
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

## **Service Response**

<table><thead><tr><th width="192">Parameter</th><th width="147.89192708333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>Indicates whether the operation was unsuccessful. If true, an error has occurred.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Indicates whether the operation was successful. If true, it has been completed successfully.</td></tr><tr><td>Errors</td><td>Array</td><td>A list containing the details of any errors that occurred.</td></tr><tr><td>Value</td><td>Array</td><td>Contains the main data content returned in the case of a successful response.</td></tr></tbody></table>

## **Service Response** (Value)

<table><thead><tr><th width="234.05859375">Parameter</th><th width="162.38671875">Type</th><th width="348.94140625">Description</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>The unique identifier for the commission.</td></tr><tr><td>Level</td><td>string</td><td>Commission Level<br><br>See: <a href="broken-reference">Commission Levels</a></td></tr><tr><td>MerchantId</td><td>int</td><td>The merchant (your) PayWall identification information.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>The identification information of the wallet owner to whom the commission is assigned.</td></tr><tr><td>WalletId</td><td>Guid</td><td>The wallet identification information to which the commission is assigned.</td></tr><tr><td>TransactionType</td><td>string</td><td>Transaction Type for Commission<br><br>See: <a href="broken-reference">Transaction Types</a></td></tr><tr><td>FeeType</td><td>string</td><td>The type information for which the commission will be applied.<br><br>See: <a href="broken-reference">Cost Types</a></td></tr><tr><td>FeeValue</td><td>decimal</td><td>The value of the commission cost.</td></tr><tr><td>ConditionType</td><td>string</td><td>The condition type of the commission.<br><br>See: <a href="broken-reference">Cost Types</a></td></tr><tr><td>ConditionThreshold</td><td>decimal</td><td>The condition value for the commission.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>The currency in which the commission will be applied.</td></tr><tr><td>IsActive</td><td>bool</td><td>The active status of the commission.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>The creation date of the record.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>The date when the record was last updated.</td></tr></tbody></table>