Bonus distribution
On this page, you can view a full list of bonuses awarded to clients, monitor bonus statuses, and manually award 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 awarded.
Amount
The bonus amount.
Temporary bonus name Applicable for temporary bonuses only
The name of a temporary bonus program from which a bonus was claimed.
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 awarded 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 awarded 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 awarded.
Fictive Volume
This field is used for reactivation of the expired bonus.
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. This field is optional and can be empty.
Last updated
