# V5.3.0 - Marketplace - New Bonus Function

Released Date - 29 Aug 2022

## Bonus Function Now Available on Marketplace

We are excited to launch a new bonus function on our CRM Marketplace.

Subscribe now for a 3 months free trial to explore the new bonus function.

## <mark style="color:red;">Marketplace</mark>&#x20;

Head over to our CRM Marketplace to purchase the bonus function.

<figure><img src="/files/CufkkD5qgMZ5lG3ZCsl7" alt=""><figcaption></figcaption></figure>

### 1)   Installation of Bonus Function

{% tabs %}
{% tab title="Step 1" %}

1. Click the “3 Months Free Trial” to begin installation of the bonus function.

   <figure><img src="/files/5UGRa436168VmIAoyVlj" alt=""><figcaption></figcaption></figure>
2. Upon installation, the validity period of the bonus function will be shown here:\
   ![](/files/id9jVyGTJ880piuxnbe8)
   {% endtab %}

{% tab title="Step 2" %}
To renew the subscription, you will need to click “Renew”. A pop up window will appear and you can select the number of months you wish to subscribe for.

1. USDT payment can be done online. You will be redirected to a third party payment page to make the payment. Upon completion of payment, the bonus function will be installed automatically.

   <figure><img src="/files/D5KknXl1OwepjwBnEglr" alt=""><figcaption></figcaption></figure>
2. For bank transfers, you will need to reach out to us to issue an invoice to you. Once payment is received, we will manually update and install the bonus function on your CRM.
   {% endtab %}

{% tab title="Step 3" %}

1. Once the bonus function has been installed, you will need to ensure permissions for bonus is selected for the respective roles. Upon turning on the permissions, you will see the “Bonus” tab here:

   <figure><img src="/files/uiiOKYns3oWmjuys1fou" alt=""><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}

### 2)   Renewal of Subscription

1. Renewal of subscription within validity period
   * The number of months purchased will be added to the expiry date.
   * For example: Validity period ends on 28 August 2022 Purchase additional 3 months Validity period will be extended for 3 months and will end on 28 November 2022
2. Renewal of subscription after expiry
   * The number of months purchased will be added to the payment date.
   * For example: Payment date: 15 September 2022 Purchase additional 5 months Validity period will end on 15 February 2022

## <mark style="color:red;">General Bonus Rules</mark>

1. Once a bonus campaign has started, you will not be able to edit the campaign details. You can only view the details or terminate the campaign.
2. When a campaign is terminated, CRM will stop paying out any bonus to the clients even if they have met the requirements set. However, there will be no changes to clients who have already received bonus payout before the campaign is terminated. Once a campaign is terminated, you will not be able to restart the campaign. A popup notification will appear for you to confirm if you would like to proceed to terminate the campaign.
3. The maximum time frame for each bonus campaign is 2 months. This is to allow for optimal processing of data and bonus payout to your clients. If your campaign will run for 4 months, you will need to create 2 separate campaigns (with the same configuration), each having a time frame of 2 months.
4. You will not be able to set the bonus campaign time frame to be beyond the subscription validity of the bonus function. If the subscription for the bonus function is expiring in 2 days, you will not be allowed to create a new event with a time frame of more than 2 days. To do so, you will first need to purchase and extend your subscription.
5. Bonus payout is not real-time and will depend on the bonus payout frequency configured for the campaign.
6. Bonus payout frequency can be set in the following ways:&#x20;
   * Every 1 day, 3 days, 5 days or 7 days
     1. For example, you set the bonus payout frequency to be every 1 day.<br>

        <figure><img src="/files/U4bSapZABlIVw6ERDp52" alt=""><figcaption></figcaption></figure>
   * At the end of the campaign
     1. For example, you set the bonus payout frequency to be end of the event.<br>

        <figure><img src="/files/zYDLgLxD1l0LzYVEpz0K" alt=""><figcaption></figcaption></figure>
7. Bonus will be paid out to clients in a single transaction.\
   \
   If the client deposit funds multiple times during the campaign period and triggers the bonus payout criteria, the total bonus amount will be consolidated into a lump sum amount and deposited into the client’s account.

> **For Example**&#x20;
>
> \
> Assume you set the bonus campaign to payout to clients bonus each time they deposit funds.
>
> Within the campaign period, Client A deposits a total of 3 times: First Deposit: $10, Bonus $1 Second Deposit: $100, Bonus $2 Third Deposit $10, Bonus $1
>
> The bonus amount will be consolidated into a lump sum figure of $4 ($1 + $2 + $1) and deposited into the client’s account.

8. Bonuses can be paid out to the client in either of the following methods:
   * Deposit into client’s trading account
   * Credit into client’s trading account
   * Deposit into client’s CRM wallet

## <mark style="color:red;">Bonus Campaign Settings</mark>&#x20;

There are 2 types of bonus campaigns that can be created:

### **1)   Deposit Bonus Campaign**&#x20;

1. Bonuses will be given to the client that has deposited funds or to their uplines.
2. This campaign is applicable to new and existing clients.

{% tabs %}
{% tab title="Step 1" %}

1. Click “New Campaign”.

   <figure><img src="/files/wVTaTbMiPPRJb28aY1Kc" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 2" %}

1. Fill in the Campaign Name
2. Select the Bonus Criteria. As of today, the only bonus criteria for “Deposit Bonus Campaign” is “Client Deposits” and this will be selected by default.
3. Deposit Type
   * As of today, the only option is “Deposit Request Approval”.
   * This means that bonus will only be paid out to clients who have submitted deposit requests, which have been approved by you.
   * Bonus will not be paid out to the client if the deposit is done manually by you either on the CRM Backoffice or on MT4/5 Manager.
4. Deposit Currency
   * Configure the currency for the deposit and the bonus payout.
5. Client Group of Client Depositing Funds

   * Select the Client Group that will be involved in this new bonus campaign.
   * Bonus will only be paid out if the client depositing funds is in the Client Group selected here.

   <figure><img src="/files/WAYk8HtZRC0LL28mf8A6" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 3" %}
Configure the Campaign Rules:

1. Bonus Recipient
   * Deposit User - Bonus will be paid out to clients that have deposited funds
   * Uplines - Bonus will be paid out to the uplines of the client that have deposited funds. You will need to key in the number of levels that you wish to payout bonus to. If you key in 2 levels, it means that bonus will be paid out to 2 levels of uplines of the client. Any uplines beyond the second level will not receive any bonus.
2. Bonus Payout Method
   * Trading Account Credit
   * Trading Account Deposit
   * CRM Wallet Deposit
3. Bonus Rules

   * Per Deposit - This means that bonus will be calculated based on each deposit transaction done by your client.
   * Total Deposit - This means that bonus will be calculated based on the total deposits done throughout the campaign.

   <figure><img src="/files/ddCqqNcAXWhXmSJPzwR6" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 4" %}

1. Configure the Deposit Range and the respective bonus payout amount.
   * Bonus Calculation can be set either as
     1. Fixed amount; or
     2. By a percentage of the deposit amount.
2. Configure the bonus payout frequency. The available options varies depending on the Bonus Rule set.
   * Per Deposit
     1. Bonus payout frequency can be set to be every 1, 3, 5 or 7 days; or
     2. At the end of the event.
   * Total Deposit
     1. Bonus payout frequency will only be at the end of the event
3. Configure Campaign Time Frame
   * Time Zone
   * Start Date The earliest start date that can be set for a campaign is for tomorrow.
   * End Date
4. Click "Save". <br>

   <figure><img src="/files/G3HVjnz3T1lJTCM2t5n1" alt=""><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}

### 2)   New Referral Deposit Bonus Campaigns

1. Bonuses will be given to the client that has deposited funds, to their uplines or to the referrer.
2. This campaign is applicable to new referred clients that has opened an account and deposited funds during the campaign time frame only.

{% tabs %}
{% tab title="Step 1" %}

1. Click “New Campaign”.<br>

   <figure><img src="/files/ZPHZMH4C91qDHRFsnAfb" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 2" %}

1. Fill in the Campaign Name
2. Select the Bonus Criteria:
   * New Users Complete Deposit
     1. During the time frame of the campaign, if a client has registered an account and deposited funds, the client and / or the uplines will receive bonus.
     2. This bonus criteria is from the perspective of a client.
     3. The purpose is to reward new clients for creating a new account and depositing funds during the campaign period. Uplines can also be rewarded with bonus (set under Bonus Recipients).
   * New Referrals Complete Deposit
     1. During the time frame of the campaign, if a client has registered an account and deposited funds, the referrer will receive the bonus payout.
     2. This bonus criteria is from the perspective of a referrer.
     3. The purpose is to reward referrers for introducing new clients to open account and deposit funds during the campaign period.
     4. You can set the number of downlines levels to be included in the bonus payout. If you set 1 to 3 downlines, it means that the referral will receive bonus payout for any new downlines up to 3 levels who creates an account and deposit funds during the campaign period.
3. Configure the Deposit Type:
   * As of today, the only limitation factor is “Deposit Request Approval”.
     1. This means that bonus will only be paid out to clients who have submitted deposit requests, which have been approved by you.
     2. Bonus will not be paid out to the client if the deposit is done manually by you either on the CRM Backoffice or on MT4/5 Manager.
4. Select the Deposit Currency for the bonus payout.
5. Select the Client Group that will be involved in this new bonus campaign. Bonus will only be paid out if the client / referral is in the Client Group selected here.

   <figure><img src="/files/zbJL3uVi3bQVJ67E930g" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 3" %}
Configure the Campaign Rules:&#x20;

1. Bonus Recipient
   * For “New Users Complete Deposit”, the bonus recipient can be:
     1. New User - Bonus will be paid out to the newly registered client that have deposited funds
     2. Uplines - Bonus will be paid out to the uplines of the new client that have deposited funds. You will need to key in the number of levels that you wish to payout bonus to. If you key in 2 levels, it means that bonus will be paid out to 2 levels of uplines of the client. Any uplines beyond the second level will not receive any bonus.
   * For “Recommend New Users to Complete Deposit”, the bonus recipient will only be the referrer and will be selected by default.
2. Bonus Payout Method
   * Trading Account Credit
   * Trading Account Deposit
   * CRM Wallet Deposit
3. Bonus Rule
   1. For “New Users Complete Deposit”, the bonus rule can be according to:
      * First Deposit - This means that bonus will be calculated based on the first deposit transaction done by the new client; or
      * Total Deposit - This means that bonus will be calculated based on the total deposits done by the new client throughout the campaign.
   2. For “Recommend New Users to Complete Deposit”, the bonus rule can be according to:

      * First Deposit - This means that bonus will be calculated based on the first deposit transaction done by the new client; or
      * Total Deposit - This means that bonus will be calculated based on the total deposits done by the new client throughout the campaign; or
      * Number of New Users who Complete First Deposit - This means that bonus will be calculated based on the total number of new clients who completed their first deposit. For this Bonus Rule, you will need to set the first deposit minimum amount.

      <figure><img src="/files/8O0hjBFZ0lVkIdOErvN1" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Step 4" %}

1. Configure the Deposit Range and the respective bonus payout amount
2. Bonus Calculation can be set either as

   * Fixed amount; or
   * By a percentage of the deposit amount.

   For “Total Number of New Clients who Completed First Deposit”, the bonus calculation can only be set as “Fixed amount”.
3. By default, the bonus payout frequency will be set as “End of Campaign”.
4. Configure Campaign Time Frame
   * Time Zone
   * Start Date The earliest start date that can be set for a campaign is for tomorrow.
   * End Date
5. Click "Save".&#x20;

   <figure><img src="/files/DuIg4Tt3XaeO2YKXIBX9" alt=""><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}

## <mark style="color:red;">Reports</mark>

Reports are consolidated and categorized based on each bonus campaign. To view the report details for a particular campaign, you will need to click onto the “Details” icon.

<figure><img src="/files/RcUAX2TEv1xAUJ3c1UPL" alt=""><figcaption></figcaption></figure>

There are 3 different reports available:

{% tabs %}
{% tab title="Triggered Orders " %}

1. This report shows all activity that has met the bonus criteria and are due for bonus payout to the respective bonus recipients.
2. This report can be downloaded into excel format.
3. Report Fields

   * Campaign ID
   * Deposit Order ID
   * Deposit Amount
   * Deposit Account
   * Client Name
   * Bonus Order ID
   * Deposit Time

   <figure><img src="/files/RviTGK31guhgprPaU6eW" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Bonus Reports " %}

1. This report shows the bonus amount for each triggered order and the respective bonus payout recipient.
2. Report Fields

   * Campaign ID
   * Recipient
   * Bonus Amount
   * Bonus Payout Method
   * Deposit Account
   * Bonus Order ID
   * Bonus Status
   * Bonus Time

   <figure><img src="/files/DHt8yJQ4VpJAm8h3kLyL" alt=""><figcaption></figcaption></figure>

{% endtab %}

{% tab title="Bonus Payout Report" %}

1. This report shows all executed bonus records to each recipient and the respective status.
2. You can view all the failed bonus records and retry bonus payout again.
3. Report Fields

   * Campaign ID
   * Bonus Order ID
   * Bonus Amount
   * Bonus Payout Method
   * Deposit Account
   * Recipient
   * Bonus Status
   * Reason for Failure
   * Bonus Time

   <figure><img src="/files/hw9kd5epjeKEODOHOgZ8" alt=""><figcaption></figcaption></figure>

{% endtab %}
{% endtabs %}

## <mark style="color:red;">**Report Data Flow**</mark>&#x20;

1. The CRM system will record down all activity that has met the bonus criteria set for the bonus campaign in the Triggered Orders report. The data will be reflected on the Triggered Orders report depending on the Bonus Payout Frequency set:
   * Every 1 day, 3 days, 5 days or 7 days
     1. Data will be shown at the end of the bonus payout frequency.
     2. For example, if bonus payout frequency is set as 3 days. The data will only reflect on the Triggered Orders report at the start of the 4th day (i.e. 00:00H of the 4th day).
   * At the end of the campaign
     1. Data will be shown at the end of the campaign.
     2. For example, if the campaign ends on the 30 September 2022. The data will only reflect on the Triggered Orders report on 1 October 2022, 00:00H.
2. Based on the orders generated in the Triggered Orders report, the CRM system will then calculate the bonus amount to be paid out to the respective recipients. The bonus amount will be reflected in the Bonus Report.
3. Bonus payout will only be executed to the recipients 24 hours after bonus has been calculated in the Bonus Report. The bonus payout records will be reflected in the Bonus Payout Report.


---

# 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://reference-guide.gitbook.io/crm-version-release-notes/v5.3.0-marketplace-new-bonus-function.md?ask=<question>
```

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.