---
description: Learn about all the details of all our recent CRM updates here.
---

# V5.10.0 - New Tier Upgrade Function, Optimization of Deposit & KYC Settings and Customizable Report

#### Released Date - 15 Nov 2022

In this release, a new tier upgrade function has been added, allowing you to set promotion criteria for your traders and IBs, and have them automatically upgraded to the next tier. Furthermore, you can setup daily deposit timeframes to better manage your operations and provide descriptions of your online deposit methods to your clients. Files uploaded by you on the KYC configuration module will now be shown on the CRM portal without clients having to download them. Depending on your business requirements, this new release also provides you the ability to restrict report timeframes that your clients can view or download.

## <mark style="color:red;">Tier Upgrade Function</mark>

### 1)   Marketplace Installation

{% tabs %}
{% tab title="Step 1" %}
You can now install the Tier Upgrade function via the CRM marketplace. This function is free for all to use.

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FQJRqGTGyPUzbWOpSW5Dq%2Fimage.png?alt=media&#x26;token=97480f6c-f2c8-4651-8537-4f5ab48243e2" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}
Upon installation, you will see a new “Tier Upgrade” module on your CRM Backoffice portal.

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FdY9mj1YBunfDmqVqEK3z%2Fimage.png?alt=media&#x26;token=f1775fa5-65fe-4eec-b50c-c429d3f860f5" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 3" %}
There are 2 tabs in the Tier Upgrade module:

1. Tier Upgrade Settings - this is where you can setup the different tier upgrade settings for the various rank structures.
2. Tier Upgrade Reports - this is where you can view the records of all clients that have met the tier upgrade criteria, view the status of tier upgrade, and manage the tier upgrade operations (e.g., approve / reject).
{% endtab %}
{% endtabs %}

### 2)   Permissions

Upon installation of the Tier Upgrade function, you will need to ensure you provide the respective permissions to your team.

1. Read Tier Upgrade Settings - you will be able to view the tier upgrade settings
2. Update Tier Upgrade Settings - you will be able to view, edit, disable and delete tier upgrade settings
3. Read Tier Upgrade Report - you will be able to view the tier upgrade reports
4. Upgrade / Reject - you will be able to manually upgrade / reject tier upgrade records

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FCIoq9TYM5nwecdvqGZIE%2F510pt3.png?alt=media&#x26;token=2f036863-f78e-4877-9730-d5c256598299" alt=""><figcaption></figcaption></figure>

### 3)   Creation of New Tier Upgrade Settings

{% tabs %}
{% tab title="Step 1" %}
To create a new Tier Upgrade Setting, click “New”.

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fk1ICFoMeoXUbqrgGkOLQ%2Fimage.png?alt=media&#x26;token=5891f50d-12c8-4861-a9d0-73d2de22cf59" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}
Fill in the relevant fields:&#x20;

1. Rule Name - cannot be duplicated with other names.
2. Upgrade Method:
   * Auto Upgrade - your clients / IBs tier will be automatically upgraded once they have met the relevant criteria
   * Manual Upgrade - clients / IBs that have met the relevant criteria will be reflected in the Tier Upgrade Report and you will need to manually approve or reject the tier upgrade
3.  Upgrade Target - this is where you indicate if this rule applies to traders only, IBs only or both.

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2Fc4jEJWhxSRb2Cm74eqpx%2Fimage.png?alt=media&#x26;token=2be633ed-252a-4468-a032-8156665cad6f" alt=""><figcaption></figcaption></figure>
4. Select the Rank that this rule will be applicable to.
   * Only one rank can be selected for each rule.
   * Each rank can only have one tier upgrade rule setup.
5. Upon selecting the Rank, a table will display the respective tiers for that particular Rank, and you will need to fill in the tier upgrade criteria.
   * Tiers will be listed from the lowest tier (first row) to the highest tier (last row).
   * Downline branches - the refers to the number of downline branches you wish to take into consideration. For example, in this case, there are 2 downline branches.\
     ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FWXYI57WqhgADHwdoam13%2Fimage.png?alt=media\&token=78ffe350-d6c7-4cec-9ee2-1571e5058c74)
   * Downline Total Deposits (includes indirect downlines)
     1. You will need to set the total deposit requirement here. The deposit amount will include deposits done by indirect downlines as well.
     2. Various currencies will be displayed here. The currencies displayed will be the base currencies setup for your trading accounts.
     3. You can set the deposit requirement for different currencies.
   * Minimum Deposit for each Branch (includes indirect downlines)
     1. You will need to set the minimum deposit for each downline branch here as well.
     2.  The minimum deposit set here cannot be more than the downline total deposits.

         <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FM3CU7gYrQOh5iAdycLmE%2Fimage.png?alt=media&#x26;token=c110fbb4-8346-4d0d-83f0-6431acbe6e85" alt=""><figcaption></figcaption></figure>
   * You will need to set the relationship between multiple currencies. If you only have one currency, this setting will not be shown. The available options are:
     1. And - this means that the criteria will include deposits requirement for each currency For example: Deposit requirement set for USD: $50 Deposit requirement set for EUR: $100 Clients / IBs will need to deposit USD 50 and EUR 100 to meet the tier upgrade criteria.
     2. Or - this means that the criteria will include deposit requirements for any currency For example: Deposit requirement set for USD: $50 Deposit requirement set for EUR: $100 Clients / IBs will need to deposit either USD 50 or EUR 100 to meet the tier upgrade criteria.
6. Deposit Type
   * By default, the “Deposit Request” will be selected. There are no available options.
   * This means that the tier upgrade function will only take into consideration of client deposit requests that has been approved.
   * Any deposit entries done manually by you will not be take into consideration.
7. Settlement Time
   * The CRM system will do a weekly settlement (on every Sunday) to identify which clients / IBs have met the tier upgrade criteria.
   * Clients / IBs who meet the tier upgrade criteria will be displayed in the Tier Upgrade Report.
   *   You will need to set the Settlement Time Zone and Time here. The system will begin settlement at this time and may take up to a few minutes for tier upgrade records to be shown on the reports.

       <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FF1uzl7mBJBK6n878ApOP%2Fimage.png?alt=media&#x26;token=ae59fb4a-d11d-48a2-8883-835ee6cbf8db" alt=""><figcaption></figcaption></figure>
8. Click "Save" once you have filled in the requird fields.&#x20;
{% endtab %}
{% endtabs %}

### 4)   Editing Tier Upgrade Settings

1.  You can edit your Tier Upgrade Settings by clicking the “Edit” icon.

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FPV5domRuLveEN1KMGlNL%2Fimage.png?alt=media&#x26;token=581a2411-cd90-4588-aeea-76c2af3d94fa" alt=""><figcaption></figcaption></figure>
2. The edited rule will not affect clients / IBs that have already been upgraded.
3. If the system is in the midst of settlement, you will not be able to edit the tier upgrade settings. A pop-up notification will show to inform you that the system is in the midst of settlement, and you will need to edit it at a later time.

### 5)   Disabling Tier Upgrade Settings

1.  You can disable tier upgrade rules by clicking the “Disable” icon.

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FUNBAXFWB5Be95uX5ILWp%2Fimage.png?alt=media&#x26;token=08bbb308-eb4c-457b-afb1-a9e571293c1b" alt=""><figcaption></figcaption></figure>
2. Once the tier upgrade rule is disabled, the system will no longer check for clients / IBs who meet the requirement. If you re-enable it, the system will proceed to do the necessary checks during settlement time.
3. Tier upgrade records in the report will still be reflected after you disable the rule. You may still perform operations on these records (e.g., approve / reject) on these records.

### 6)   Deleting Tier Upgrade Settings

1.  You can also delete tier upgrade rules by clicking the “Delete” icon.

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FBnQQ59DS3J3zcPunIcMj%2Fimage.png?alt=media&#x26;token=709f2027-34d5-4b2c-b96c-a34f1cc2f500" alt=""><figcaption></figcaption></figure>
2. Upon deleting the rule, the records in the tier upgrade reports will not be affected.

### 7)   Tier Upgrade Reports

The Tier Upgrade Reports are segregated into 2 types:

* Auto Upgrade - this report will reflect all clients / IBs who have met the upgrade requirements and the respective upgrade statuses
* Manual Upgrade - this report will reflect all clients / IBs who have met the upgrade requirements and the actions required on your end (e.g., approve / reject)

{% tabs %}
{% tab title="Auto Upgrade Report" %}
1. When a client / IB meets the tier upgrade criteria, the system will automatically upgrade their tier to the respective tier during the settlement time set.
2. All clients / IBs that have been upgraded will be shown in the report.
3. Available statuses of tier upgrade are:
   * Success - the client / IB has been promoted successfully
   * Fail - the client / IB has not been promoted successfully.
     1.  For failed records, the broker can manually upgrade or reject by selecting the record and clicking “Upgrade” or “Reject”.

         <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F5yauY7yYAGI5IPhTaYkK%2F510pt12.png?alt=media&#x26;token=71deae16-d993-4f79-ad8f-a349b1ca2fa4" alt=""><figcaption></figcaption></figure>
     2. Possible reasons for failure include:
        * Original tier of client / IB is higher than the new tier - this might have happened when you upgrade a client / IBs tier manually before the system automatically upgrades the tier
        * Rank of client has been changed
   * Rejected - the client / IB’s promotion has been rejected by the broker
   * Expired - the client / IB’s promotion record is an old data processed in the previous settlement date. Following which, a new record has been updated in the report, resulting in the old data to be expired. You will not be able to upgrade or reject any expired records.
{% endtab %}

{% tab title="Manual Upgrade Report" %}
1. When a client / IB meets the tier upgrade system, the system will check and display their records in the report during the settlement time set.
2. You will be able to approve or reject the client / IB’s promotion manually.
3. Available status of the records are:
   * Pending - you will need to approve or reject the promotion
   * Success - the client / IB has been promoted successfully
   * Fail - the client / IB has not been promoted successfully.
     1. For failed records, the broker can manually upgrade or reject by selecting the record and clicking “Upgrade” or “Reject”.
     2. Possible reasons for failure include:
        * Original tier of client / IB is higher than the new tier - this might have happened when you upgrade a client / IBs tier manually before the system automatically upgrades the tier
        * Rank of client has been changed
   * Rejected - the client / IB’s promotion has been rejected by the broker
   * Expired - the client / IB’s promotion record is an old data processed in the previous settlement date. Following which, a new record has been updated in the report, resulting in the old data to be expired. You will not be able to upgrade or reject any expired records.
{% endtab %}
{% endtabs %}

## <mark style="color:red;">Daily Deposit Timeframes</mark>

### 1)   Permissions

To setup the daily deposit timeframe, you will need to ensure you enable the Update Daily Deposit Settings permission.

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F9753BM0gZzSsclc3MpZY%2F510pt13.png?alt=media&#x26;token=3460769d-bf85-4173-860c-5bad8d0f5b95" alt=""><figcaption></figcaption></figure>

### 2)   Setting Up of Daily Deposit Timeframes

1.  Under Deposit Settings tab, you will see the “Daily Deposit Settings”.

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FT6ZePP8U3nkIcER2j1aB%2Fimage.png?alt=media&#x26;token=778883e7-4db2-4ad0-ba85-036df61cf5d4" alt=""><figcaption></figcaption></figure>
2. By default, the daily deposit settings will be set at 24 hours.
3.  Click the “Edit” button and set the time zone, start time and end time, and save accordingly. In the following example, it means that you will only allow deposit requests to be submitted from GMT+2 10:00H to 15:00H.

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FDrWKa7WqeCDlCQeAvaca%2Fimage.png?alt=media&#x26;token=0aabbc9b-bf19-4733-8bfd-4e9b557bcef1" alt=""><figcaption></figcaption></figure>

### 3)   Client Portal - Deposits&#x20;

1.  Upon setting up the daily deposit settings, your client will be able to see the time frame when depositing funds.

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F4s5Dwv2kCMhbsYkfkvcB%2Fimage.png?alt=media&#x26;token=b00ffbd2-4da1-4e79-97ae-3d9a2fdb4037" alt=""><figcaption></figcaption></figure>
2. If client is submitting a deposit request outside the daily deposit timeframe, there will be a pop-up notification to notify them of the daily deposit time.\
   ![](https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FDyTrbLUD5oHdiQh84hGZ%2Fimage.png?alt=media\&token=0b006f02-ae97-43f3-b32c-c5830d9659e2)

## <mark style="color:red;">Online Deposit Descriptions</mark>

### 1)   Setting Up of Descriptions

You can now add in descriptions for the various online deposit methods you have. This allows you to provide your clients with a better understanding of each online deposit method and decide which is their preferred method.

{% tabs %}
{% tab title="Step 1" %}
When you edit an online deposit setting, you can now see the Deposit Fields available to your clients. By default, there will be the following deposit fields which cannot be edited or deleted:

* Trading Account
* Trading Amount
* Payment Currency
* Payment Amount

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FA3FDOEdFxZYsPXFer1XI%2Fimage.png?alt=media&#x26;token=9be5b889-1c99-4daf-99b9-08160c13edf1" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}
To add a description:

* Click “Create”
* Select “Description”
* Type in the description in the respective languages
*   Click “Create Field”

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FnXgEvfWNQUQGn0HeWsO6%2Fimage.png?alt=media&#x26;token=80a2f93b-e3f2-48af-b304-92480605797d" alt=""><figcaption></figcaption></figure>

Click Save and enable the Description field.

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FVXw9kTscU0nuNSt1a1Xt%2Fimage.png?alt=media&#x26;token=5570ed73-31d1-4fbf-99d3-79ae22932fc3" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### 2)   Client Portal - Deposits&#x20;

When your client is submitted a deposit request, they will now be able to see the description.

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FXLzYGSvTLHWDdRKKgmfR%2F510pt21.png?alt=media&#x26;token=e3091f00-8f88-4324-9f1a-53569cf922ba" alt=""><figcaption></figcaption></figure>



## <mark style="color:red;">Preview of Documents Uploaded</mark>

### 1)   File Upload Settings

1. Documents uploaded in your KYC Dynamic Form can be previewed by your clients without them having to download the files.
2. When creating a new “File Download” field under KYC Dynamic Form, you will now be able to customize the Display Mode of the file. The available options are:
   * Click on the file name to open - your client will need to click the file in order to view it
   *   Display directly - your client will be able to preview the file directly on the CRM portal. Kindly note that this option will only be available for documents in PDF format and image files.

       <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FyrIWI1SWxHLCGd5V8SJN%2Fimage.png?alt=media&#x26;token=7731b7c1-bbfc-440f-a489-6a7630e7d9d1" alt=""><figcaption></figcaption></figure>

### 2)   Client Portal - KYC

When filling in the “User Information”, your client will be able to preview the file that you have uploaded:

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FoBHAynP6Av1buF2iVS5g%2F510pt23.png?alt=media&#x26;token=fba34399-973b-4706-942a-03ab6da7c4bd" alt=""><figcaption></figcaption></figure>

## <mark style="color:red;">Client Report Timeframes</mark>&#x20;

### 1)   Setting Up of Report Timeframes&#x20;

This function allows you to restrict the timeframe of reports query and download for your clients.

This can be customized for the following reports:

1. My Clients - Clients’ Report, Commission, Clients’ Requests
2. Reports - Trade History, Open Positions & Pending Orders

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FanizXgwamtuDjjcttGT3%2F510pt24.png?alt=media&#x26;token=346b9044-6f02-426a-b6ef-bd861f7f51c7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2F1nspcX5Tm3DQMYnMkYB5%2F510pt25.png?alt=media&#x26;token=178f1b77-e910-4918-b27d-21f492f2c387" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Step 1" %}
1. Select “View Time Frame”. By default, the settings will be “No Limit”.
2.  To customize, select “Customize”, select either “Week” or “Month” and fill in the number accordingly.

    * For Week, you can only set a maximum of 10 weeks.
    * For Month, you can only set a maximum of 36 months.

    <figure><img src="https://2882407036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtcPc3eNiDR0XV3sykf6H%2Fuploads%2FDuv9Ya7DQLjvr4w4uWcA%2F510pt26.png?alt=media&#x26;token=f116bc85-1d0d-4eae-958b-829a4a140b3c" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Step 2" %}
1. Upon setting the timeframe limit, your clients will be restricted on the date range that they can view or download reports.
   * For example, if you set the timeframe as 3 months and today is 11 November 2022, your clients can only view or download reports from 11 August to 11 November 2022.
   * For example, if you set the timeframe as 2 weeks and today is 11 November 2022, your clients can only view or download reports from 29 October to 11 November 2022.
2. If your clients search a timeframe beyond the timeframe limit you set, they will not be able to see any data.
{% endtab %}
{% endtabs %}

