LogoLogo
Release notesHomepageTry demo
  • Welcome to B2CORE docs
  • Integrations
    • Platforms
    • Payment systems
    • KYC providers
    • Communication platforms
    • Other systems
  • Back Office guide
    • Get started
    • Clients
      • General
        • Client tab
        • Contacts tab
        • Event log tab
        • Accounts tab
        • Transactions tab
        • Finance tab
        • History tab
        • Trades tab
        • Services tab
        • Files tab
        • Settings tab
        • Advanced tab
        • Compliances tab
        • Devices tab
        • Documents tab
        • Mailing Log tab
        • Introducing brokers tab
      • Services
      • Requests
      • Accounts
      • Managers
      • Types
      • Events log
      • Jurisdictions
    • Introducing brokers
    • Finance
      • Deposits
      • Payouts
      • Deposit wallets
      • Transfers
      • Exchange
      • Transactions
      • Reports
    • Savings
      • Presets
      • Plans
    • Bonuses
      • Bonus presets
      • Bonus distribution
      • Temporary bonuses
    • Currencies
      • Currencies
      • Rates
      • Currency pairs
    • Cashback
      • MetaTrader Volume
        • Preferences tab
        • Tiers tab
    • Products
      • Products
      • Groups
      • Rights
      • Platforms
    • Promotion
      • Banners
      • Announcements
      • Dashboard
      • Menu
    • Mailing
      • Marketing
      • System
    • Ticket feedback
    • Verification
      • Levels
      • Documents
      • Document types
      • Document groups
      • Client tests
    • Investment platform
    • System
      • SMS Providers
      • Key storage
      • Deposit system
      • Payout system
      • Wizards
      • Bulk actions
      • Operation types
      • Countries
      • External connections
      • Localizations
      • Requests
      • Templates
        • Email
        • SMS
        • Slack
        • Telegram
      • Logs
      • Settings
      • Event notifications
      • Users
        • Users
        • Groups
        • Client Tags
      • Events
      • Client rights
      • Client folders
      • Backend images
      • Import data
      • Visual customization
    • Security
      • Search by IP
      • Blocked clients
      • Black lists
      • White lists
      • Transaction monitoring
      • Address whitelist
      • Email black list
    • References
      • Client statuses
      • Client request statuses
      • Transaction statuses
      • Event types for triggering event notifications for Back Office users
      • Product permissions
      • Supported currencies
      • Supported cryptocurrency payment methods
      • Block explorer list
  • How-to articles
    • Manage clients
      • How to register a new client
      • How to change a client password
      • How to disable 2FA for a client
      • How to enable internal transfers for a client
      • How to view deposit or withdrawal wallet addresses
      • How to upload files to a client profile
      • How to assign tags to clients
      • How to approve or reject client requests
      • How to create categories for the Event log
      • How to create a jurisdiction
    • Manage finances
      • How to create a deposit
      • How to create a payout
      • How to create a transfer
      • How to exchange funds
      • How to create a report
      • How to update balances
      • How to process transactions with the Partial status
    • Manage savings programs
      • How to create a savings program
        • Configure the Flexible strategy settings
        • Configure the Fixed strategy settings
    • Manage currencies
      • How to add a currency
      • How to configure currency exchange rates
      • How to add an exchange currency pair
      • How to set priorities for exchange rate providers
      • How to enable requests for exchanges in specific currency pairs
      • How to update rates in exchange requests
    • Manage bonuses
      • How to create a bonus preset
      • How to create a temporary bonus program
      • How to automatically credit bonuses to clients upon deposits
      • How to manually credit bonuses to clients
    • Manage products
      • How to create a wallet
      • How to restrict the use of a product
    • Manage platforms
      • How to integrate B2TRADER
      • How to integrate DXtrade
      • How to integrate Match-Trader
      • How to integrate MetaTrader
      • How to integrate TradeLocker
      • How to integrate OneZero and PrimeXM
      • How to enable one-click trading access from the B2CORE UI and mobile app
    • Manage cashback options
      • How to configure cashback programs for MT4 and MT5
    • Manage advertising options
      • How to create a banner
      • How to create an announcement
      • How to configure the default Dashboard
      • How to add Ticker Widget symbols to the Dashboard
      • How to configure a menu in the B2CORE UI
    • Manage mailing options
      • How to send an email
      • How to create an email template
      • How to configure SMTP
      • How to configure SendGrid
      • How to determine why clients fail to receive email notifications
    • Manage verification options
      • How to use the KYC constructor
      • How to use SumSubstance
      • How to use ShuftiPro
      • How to use iDenfy
      • How to create a client accreditation test
    • Manage system settings
      • How to set up the Registration wizard
        • How to add and configure the Registration wizard
        • How to set up fields for the Basic Information step
        • Fields supported in the Basic Information step
        • How to set up fields for the Advanced step
        • Field types and validation rules
        • How to configure the User Registration step
      • How to change the wizard workflow
      • How to block registration for a country
      • How to add or remove a language
      • How to create a request resolution type
      • How to create a request resolution
      • How to set up event notifications
      • How to set up Apple push notification
      • How to add a user group and grant permissions
      • How to add an admin user
      • How to make an admin user see only specific clients
      • How to add a manager
      • How to create a bulk action
      • How to export a CSV file with email addresses
      • How to change Back Office images
      • How to set up 2FA
      • How to import client-related data
      • How to import data related to Back Office user groups
      • How to configure a connection to Zendesk
      • How to switch from SupportPal to Zendesk
      • How to configure a connection to RudderStack
      • How to configure settings for mobile app downloads
    • Manage payment methods
      • How to add non-PSS deposit and withdrawal methods
        • How to integrate B2BINPAY
      • How to add the manual deposit or withdrawal method
      • How to add the Constructor deposit or withdrawal method
      • How to add deposit and withdrawal methods through PSS
        • How to integrate BridgerPay
        • How to integrate PayPal
        • How to integrate Paytiko
        • How to integrate Praxis
      • How to configure commissions for deposit and withdrawal methods
      • How to restrict the use of deposit and withdrawal methods
    • Manage communication platforms
      • How to configure Twilio
      • How to set up a Slack bot
      • How to set up a Telegram bot
      • How to get Telegram chat, group and channel identifiers
  • B2CORE Mobile
    • Deploying your iOS app
    • Deploying your Android app
  • B2CORE API
    • Restricted access to the API
  • Release notes
    • Release notes
    • Release notes Mobile
Powered by GitBook
On this page
  • General information
  • Details
  • Bonus details
  • Bonus transactions

Was this helpful?

  1. Back Office guide
  2. Bonuses

Bonus distribution

PreviousBonus presetsNextTemporary bonuses

Last updated 20 days ago

Was this helpful?

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 .

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 .


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

The details page is divided into two tabs:

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 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.

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.

See also

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 .

To view bonus details, click (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 in the bonus details.

For failed transactions with the Error status, (Retry) is displayed. Click the button to attempt processing the transaction again.

The Retry button is available only to the Back Office users who are assigned the to Retry bonus operation. If you don't have this permission, the button will be hidden.

To update the transaction information displayed on the tab, click (Refresh) displayed in the upper-right corner.

permission
How to manually credit bonuses to clients
How to automatically credit bonuses to clients upon deposits
bonus details
Bonus transactions tab
Bonus details
Bonus transactions
Back Office administrators
Introduction to bonuses