Commission cashback

The commission cashback mechanism allows you to distribute a part of the commissions earned from trading a specific currency between the clients who have contributed to the currency promotion.

Currently, commission cashback can be enabled only for the B2Trader platform.

To enable distribution of cashback rewards between your clients, configure and enable one or several commission cashback plans (to learn more, refer to How to configure a commission cashback plan).

To receive cashback rewards, your clients must meet the following general requirements:

  • There must be funds in a target currency (the one is being promoted) on a client trading account at the end of a period for which cashback is rewarded.

  • No trades in a target currency must be made by a client during this period.

You can enable the Hold option as an additional requirement for receiving cashback rewards when configuring a commission cashback plan (to learn more, refer to How to configure a commission cashback plan).

The cashback rewards are distributed between clients at the end of each period specified in a commission cashback plan. The cashback amount that a client receives is proportional to the balance of a target currency on a client trading account at the end of a given period.

The cashback rewards can be paid in another currency than a specified target currency.

Commission plans

On this page, you can view a list of configured commission cashback plans and create new ones.

General information

The following information is provided about each plan:

ID

The identifier of a commission cashback plan.

Commission Name

The plan name used in the Back Office.

Target Currency

The traded currency. A certain portion of the total amount of commissions charged for trades in this currency is distributed as cashback rewards between clients. Commissions are collected during a specified period.

Important

The target currency must be traded as a base currency in a currency pair.

Cashback Currency

The currency in which cashback rewards are paid to clients.

To receive cashback rewards, clients must have wallets denominated in a specified cashback currency.

Percent

The percentage of a commission amount collected from trades in a target currency over a specified period that is distributed between the clients that meet the commission plan requirements.

Side

The trade side:

  • buy – cashback is paid from commissions charged only for buy trades in a target currency.

  • sell – cashback is paid from commissions charged only for sell trades in a target currency.

  • All – cashback is paid from commissions charged for both buy and sell trades in a target currency.

Hold

The hold period during which clients are not allowed to deposit or transfer funds in a target currency to their trading accounts in order to receive cashback rewards at the end of the current period.

  • If Disabled, a client must meet only the general requirements to receive cashback rewards under a cashback commission plan:

    • There must be funds in a target currency on a client trading account at the end of the current period.

    • No trades in a target currency must be made by a client during the current period.

  • If Enabled, in addition to the general requirements, a client must meet the following requirement:

    • No deposits or transfers in a target currency must be made to a client trading account during the current period.

To learn more about this option, refer to Example 1 in How to configure a commission cashback plan.

Period

The trading period during which commissions from trades in a target currency are collected. The possible values:

  • day – day 00:00:00 GMT – day 23:59:59 GMT

  • week – Monday 00:00:00 GMT – Sunday 23:59:59 GMT

  • month – the first day 00:00:00 GMT of a month – the last day 23:59:59 GMT of a month

Distribution

If Enabled, cashback distribution according to a commission plan is enabled; otherwise, Disabled.

To view commission plan details, click the Edit button related to a selected plan.

Details

On the details page, the additional Trades Provider field is available, displaying the trading platform for which a commission plan is created.

Important

Currently, commission cashback can be enabled only for B2Trader.

Trading data

On this page, you can view a list of all trades made on the B2Trader platform during a specified time period.

To specify a time period, select the start and end dates in the To and From fields located in the Date column or apply one of the following filtering options:

  • Today

  • Yesterday

  • Last 7 Days

  • Last 30 Days

  • This month

  • Last month

The following information is provided about each trade made within a specified period:

Email

The email of a client who made a trade.

Order Id

The order identifier.

Instrument

The traded asset.

Side

The trade side: buy, sell or all.

Quantity

The asset quantity.

Price

The price at which a trade was made.

Value

The total trade value, calculated as a product of trade quantity and trade price.

Commission Amount

The commission amount charged for a trade.

Currency

The commission currency.

Date

The date and time when a trade was made.

Processing log

On this page, you can find information about cashback distribution operations that are initiated at the end of each period specified in the enabled commission cashback plans.

General information

The following information is provided about each cashback distribution operation:

Operation Id

The identifier of a cashback distribution operation.

Commission Plan

The name of a commission cashback plan under which a cashback distribution operation is initiated.

Operation Status

The operation status indicating whether all the processes that constitute an operation have been successfully completed.

The possible values:

  • done – an operation has been successfully completed.

  • not_finished – an operation hasn’t been completed because some of the processes were not complete.

Period Start

The start date and time of a period during which commissions from trades in a target currency are collected.

Period End

The end date and time of a period during which commissions from trades in a target currency are collected.

Created At

The date and time when an operation was initiated in the system.

Updated At

The date and time when the operation status was last updated.

To view details of a cashback distribution operation, click the eye icon related to a selected operation.

Details

Each cashback distribution operation consists of several sequential processes named as follows:

  • Find Commissions – used to identify the number and amount of commissions charged for trades in a target currency during a given period.

  • Define Rates – used to retrieve exchange rates to convert the amount of collected commissions to a cashback currency specified in a commission cashback plan.

  • Calculate Total Distribution – used to calculate the total cashback amount that will be distributed to clients (based on the amount of collected commissions and a percentage specified in a commission cashback plan).

  • Find Holders – used to identify clients to which cashback is to be rewarded for a given period.

  • Get Fee – used to calculate the amounts of cashback rewards for the selected clients. The cashback amount is proportional to the balance of a target currency on a client trading account at the end of a given period.

  • Transfer Fee – used to check whether cashback rewards have been deposited to the selected clients.

To view process details, click the name of a selected process.

Once all the processes are complete, a cashback distribution operation is assigned the done status. If any of the processes failed to complete, this process and a cashback distribution operation are assigned the not_finished status.

Distribution log

On this page, you can find information about cashback rewards distributed to clients that met the requirements of the enabled commission cashback plans.

The cashback rewards are deposited to client wallets using the TokenDistribution method. Such deposit transactions are listed on the Finance > Deposits page and on the Transactions tab in the client details.

The following information is provided about each transaction:

Operation Id

The identifier of a cashback distribution operation. A single operation can include multiple deposit transactions to client wallets.

Click an operation identifier to navigate to the Processing log details.

Email

The email of a client that received a cashback reward.

Account

The client wallet to which a cashback reward was deposited.

Amount

The amount of a cashback reward.

Currency

The currency in which a cashback reward was paid.

Commission Plan

The commission cashback plan under which a cashback reward was paid.

Status

The transaction status.

Date

The date and time when a deposit transaction was made.