Bonus distribution
On this page, you can view a full list of bonuses credited to clients, monitor bonus statuses, and manually credit bonuses to clients as needed. For details of the process of awarding bonuses to clients, refer to Introduction to bonuses.
General information
The following information is provided about each bonus:
ID
The bonus identifier.
Client ID
The client identifier.
Client name
The client’s name.
Client email
The client’s email address.
Tags
The tags assigned to a client, which are used to sort the client list displayed to Back Office administrators.
Account
The number of a trading account to which a bonus is credited.
Amount
The bonus amount.
Bonus name
The bonus name, displayed to a client in the B2CORE UI.
For temporary bonuses, the default name is the name of a temporary bonus program from which a bonus was claimed. To display a different name in the B2CORE UI, enter the desired name in the Caption field within the bonus details.
For manually credited bonuses, if the Bonus name field is empty, the name of the platform associated with the account receiving a bonus will be displayed to the client in the B2CORE UI.
State
The bonus status:
Queued— a bonus was awarded to a client trading account, but hasn’t yet been added to the account as credit.Pending— a bonus was added to a client trading account as credit, and the required volume that must be traded by the client was calculated.Processing— a bonus is currently being processed for burning.Completed— bonus requirements were successfully met, indicating that the required volume was achieved by the client within the specified number of days, and the bonus credit has been received on the account balance.On completing— the bonus credit is being added to the account balance.Expired— bonus requirements weren’t met, resulting in the bonus credit being revoked from the account.Error— an error occurred while processing a bonus.
Created at
The date and time when a bonus was credited to a client trading account.
Details
On the details page, you can view the bonus setting and requirements that a client must meet to receive a bonus credit on their account balance.
Additionally, you can reactivate bonuses that have the Expired status and revoke bonuses with the Pending status. To do this, click the Actions button in the upper-right page corner and select the appropriate option in the dropdown.
The following information is provided on the details page:
Created at
The date and time when a bonus was credited to a client trading account.
Amount
The bonus amount.
State
The bonus status.
Volume closed
The volume of closed positions counted towards the required volume that a client must achieve to receive a bonus credit on their account balance.
Temporary Bonus Applicable for temporary bonuses only
The name of a temporary bonus program from which a bonus was claimed.
Activated at
The date and time when a bonus amount was added to a client trading account as credit.
Client
The client’s email address.
Account
The number of a trading account to which a bonus was credited.
Fictive Volume
This field is used for reactivation of the expired bonus.
Caption
The bonus name, displayed to a client in the B2CORE UI.
If this field is empty:
For temporary bonuses, the name of a temporary bonus program from which a bonus was claimed will be displayed to the client in the B2CORE UI.
For manually credited bonuses, the name of the platform associated with the account receiving a bonus will be displayed to the client in the B2CORE UI.
Lifetime (days)
The number of days to fulfill the bonus requirements. After the bonus amount is added to a client trading account as credit, the client must trade the required volume within the specified number of days to receive the bonus credit on the account balance.
Lot per unit
The ratio applied to the bonus amount to determine the volume that must be traded by a client to receive the bonus credit on their account balance:
Required volume = Bonus amount / Lot per unit
Suppose that the bonus amount is 100 USD and the Lot per unit option is set to 2. In order to receive the bonus credit of 100 USD to their account balance, a client must trade the following volume:
100 / 2 = 50 lots.
Set credit immediately
If Enabled, when a client claims bonuses from multiple programs at a time using the same trading account, all claimed bonuses are immediately added to their account as credit, enabling the client to use credit funds for trading.
If Disabled, when a client claims bonuses from multiple programs at a time using the same trading account, the claimed bonuses are added to their account one after another. Only after the first claimed bonus is processed and assigned the final status (
CompletedorExpired), the second claimed bonus is added to the client trading account as credit, and so on.
Ignored open/close interval (sec)
The minimum duration, in seconds, for which a client must keep a position open for it to be counted towards the traded volume of the bonus program.
Autoenable trading if balance > 0
When the account balance changes from zero or negative to positive, the permission named Trade Enabled is either automatically restored for the account or not, depending on this setting:
If Enabled, when the account balance becomes positive, the
Trade Enabledpermission is automatically restored, enabling the client to resume trading on their account, including the use of the bonus credit.If Disabled, when the account balance becomes positive, the
Trade Enabledpermission isn’t automatically restored.
Ignored symbol groups
One or more symbol groups in which trades aren't counted towards the traded volume of the bonus program.
For cTrader, individual symbols must be selected in this field instead of symbol groups, even though symbol groups are available on the cTrader platform.
This field is optional and can be empty.
Last updated
