# 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](/back-office-guide/bonuses.md#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](/back-office-guide/system/users/users.md). *** **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](#details). For manually credited bonuses, the bonus name is the value specified in the **Caption** field when [manually adding bonuses to clients](/how-to-articles/manage-bonuses/how-to-manually-credit-bonuses-to-clients.md). *** **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 by** The email address and ID of a Back Office user who created a bonus for a client. Clicking the ID opens the profile of the respective Back Office user. *** **Created at** The date and time when a bonus was credited to a client trading account. To view bonus details, click ![view-button](/files/p61PD5FCyOga5YnHfjYZ) (**View**). If any transaction related to crediting or deducting a specific bonus on the client's trading account fails, the respective bonus row is highlighted, and the **exclamation** icon appears next to the **View** button. You can view the bonus transaction history on the [Bonus transactions tab](#bonus-transactions) in the bonus details. *** **Expired at** The date and time when a credited bonus is scheduled to expire or has already expired. ## Details The details page is divided into two tabs: * [Bonus details](#bonus-details) * [Bonus transactions](#bonus-transactions) ### Bonus details On the details tab, 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 tab: **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**\ \&#xNAN;*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 (`Completed` or `Expired`), 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 Enabled` permission 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 Enabled` permission 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. ### Bonus transactions On the transactions tab, you can view the history of transactions related to crediting or deducting a specific bonus on the client's trading account, check their statuses, and retry failed transactions if necessary. For failed transactions with the `Error` status, ![retry button](/files/mmlEPd564x2ZUESkFdw5) (**Retry**) is displayed. Click the button to attempt processing the transaction again. {% hint style="info" %} The **Retry** button is available only to the Back Office users who are assigned the [permission](/back-office-guide/system/users/groups.md) to `Retry bonus operation`. If you don't have this permission, the button will be hidden. {% endhint %} To update the transaction information displayed on the tab, click ![refresh button](/files/jFzaeNhUjAvlFdkCh7OL) (**Refresh**) displayed in the upper-right corner. The following information is provided on the tab: **Operation ID** The identifier assigned to the bonus transaction. *** **Oder ID** The identifier of the order associated with the bonus transaction, if applicable. *** **Amount** The bonus amount. *** **Status** The transaction status: * `New` — the transaction has been initiated. * `In progress` — the transaction is being processed. The `New` and `In progress` statuses are intermediate and appear only for a very brief moment. * `Success` — the transaction was successfully executed. * `Error` — the transaction failed due to an issue. *** **Num of attempts** The number of attempts made to execute the transaction. *** **Last attempt date** The date and time of the most recent attempt to process the transaction. *** **Comment** A description identifying the transaction: * **Credit accrued** — the bonus amount is added to the client’s trading account as credit. * **Credit cleared** — the credited bonus is deducted from the account once the bonus requirements have been met. This occurs just before adding the bonus amount to the account balance. * **Balance accrued** — the credited bonus is added to the account balance after the bonus requirements have been met. * **Credit expired** — the credited bonus has expired and is deducted from the account. * **Bonus cancelled** — the credited bonus is revoked when funds are withdrawn from the account. *** **Error message** For transactions with the `Error` status, this field displays details about the error. *** **Creation date** The date and time when the transaction was initiated. {% hint style="success" %} **See also** [How to manually credit bonuses to clients](/how-to-articles/manage-bonuses/how-to-manually-credit-bonuses-to-clients.md) [How to automatically credit bonuses to clients upon deposits](/how-to-articles/manage-bonuses/how-to-automatically-credit-bonuses-to-clients-upon-deposits.md) {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.b2core.b2broker.com/back-office-guide/bonuses/bonus-distribution.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.