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

Was this helpful?

  1. How-to articles
  2. Manage bonuses

How to create a temporary bonus program

PreviousHow to create a bonus presetNextHow to automatically credit bonuses to clients upon deposits

Last updated 3 months ago

Was this helpful?

You can create temporary bonus programs in the Back Office. Once a bonus program is created, it’s immediately displayed on the Bonuses page in the B2CORE UI, enabling clients to claim bonuses from that program.

To create a temporary bonus program:

1

Navigate to Bonuses > Temporary Bonuses.

2

Click Create, and then select the trading platform for which you want to create the bonus program.

3

On the Create Temporary Bonus page, fill in the following fields:

  • In the Name field, enter the name of the bonus program, which will be displayed to clients in the B2CORE UI.

  • In the Amount field, specify the bonus amount.

  • In the Currency dropdown, select the currency for the bonus program. Only trading account denominated in the selected currency can be used to claim the bonus from the program.

  • In the Expired filed, set the end date and time for the bonus program.

  • In the Platform Groups, select one or more groups created on the trading platform, in which trades are counted towards the traded volume of the bonus program.

  • In the Preset dropdown, you can optionally select a preset to automatically fill in the remaining fields based on preset settings.

    Alternatively, you can leave the Preset field empty and fill in the remaining fields manually:

  • In the Lifetime (days) field, enter the duration, in days, during which clients must trade the required volume.

  • In the Lot per unit field, enter the ratio that is used to determine the volume that must be traded by clients.

    The ratio is applied to the specified bonus amount, and the required volume is calculated as follows: Required volume = Bonus amount / Lot per unit

  • In the Set credit immediately, select either of the two values:

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

    • Disabled — when a client claims bonuses from multiple programs at a time using the same trading account, the claimed bonuses are added to their trading 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.

  • In the Ignored open/close interval (sec) field, specify the minimum duration, in seconds, for which the client must keep positions open for them to be counted towards the traded volume of the bonus program.

  • In the Autoenable trading if balance > 0 dropdown, select either of the two values:

    • Enabled — when the account balance changes from zero or negative to positive, the Trade Enabled permission is automatically restored for the account, enabling the client to resume trading on their account, including the use of the bonus credit.

    • Disabled — when the account balance changes from zero or negative to positive, the Trade Enabled permission isn’t automatically restored for the account.

  • In the Ignored symbol groups dropdown, select 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.

    You can leave this field empty.

4

Click Save to create the bonus program.

The created bonus program is now listed on the Bonuses page in the B2CORE UI.

Example

This example illustrates how to interpret the requirements of the temporary bonus program with the following settings:

To receive the bonus amount of 386 USD from the bonus program, a client needs to claim the bonus in the B2CORE UI using their active trading account opened on the MetaTrader 5 Live platform and denominated in USD.

After claiming the bonus, the bonus is added to the client trading account as credit, enabling the client to use credit funds for trading. In order to receive the bonus credit on their account balance, the client must fulfill the following bonus program requirements:

Program setting
Description

Amount = 386 and Lot per unit = 10

Both settings are used to determine the volume that must be traded by the client: Required volume = Amount / Lot per unit = 386 / 10 = 38,6 lots

Lifetime (days) = 20

To receive the bonus credit on the account balance, the client must trade the required volume within 20 days after the bonus credit is added to their trading account. The traded volume is calculated based on the volume of closed positions. Moreover, these positions must be opened after claiming the bonus and receiving it as credit, and they must be closed before the end of the bonus program.

For example, if the client opens a position, then claims and receives the bonus as credit from the given program, and subsequently closes the position, the volume of that closed position won’t contribute to the traded volume of the bonus program.

Platform Groups = real/Group-Standard-USD-B, real/Group-Standard-BTC-A

Only the volume of trades made in the selected groups are counted towards the traded volume of the bonus program.

Ignored open/close interval (sec) = 5

The client must keep positions open for at least 5 seconds for them to be counted towards the traded volume of the bonus program.

Ignored symbol groups = Shares/Shares HIGH/Shares USD HIGH

If the client trades the symbols from the selected group, the volume of these trades isn’t counted towards the traded volume of the bonus program.

Set credit immediately = Enabled

Indicates that after claiming the bonus, the bonus amount of 386 USD is immediately added to the client trading account as credit without waiting for the completion of any other bonus program on that account.

Autoenable trading if balance > 0 = Enabled

Indicates that if the account balance changes from zero or negative to positive, the permission to trade on the account is automatically restored.

The settings of a temporary bonus program
The settings of a temporary bonus program