Overview

Price list is a set of rules that can be applied to clients. A price list rule is created for each fee, cashback program, and vault rate to define their parameters and conditions. Thus, a White label can configure a Price list containing multiple rules and assign all of them at once to a client or a group of clients. It is also possible to create a Standard Price list as a unique combination of rules which is created once and set to a Person or a Company by default if otherwise is not stated.

Opening the item

Follow the steps below to see the price list details:

  1. Navigate to the Admin Panel.

  2. Click Banking on the left sidebar.

  3. Go to the Price lists menu item.

  4. Click Show or Edit in a Price list line to open its details.

How to create a price list

The process of configuring fees and rewards consists of the following steps:

  1. Creating a Price list.

  2. Adding fee and reward rules to the Price list.

  3. Publishing the Price list and assigning it to clients.

The first step of configuring transaction fees or reward programs is to create a Price list defining the common parameters.

To create a Price list

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of Price lists will be opened.

  3. Click Add New in the top-right corner to open the Price list creation window.

  4. Type in a name for the new Price list.

  5. Select a Client type for the Price list: either Person or Company. The Price list rules will be applied only to the selected client type.

  6. Select a Person/Company type to define the group of clients assigned to the new Price list.
    If the parameter is not set, the new Price list will be applied to all clients of the selected Client type.
    The groups are configured in Dictionaries and allow White Labels to set limits and price lists per each group. See Dictionary for configuration details.

  7. Check the Standard checkbox if you want the price list to be set by default for the selected client type. There is only one Standard Price List possible for each Client type.

  8. Select the External fee enabled checkbox to request transfer fees from an external service via API. The internal price list configuration for transfers will be ignored.

  9. Click Create to save the Price List as a draft.

  10. The new Price list will be available in the main list of the Price lists tab.

Creating a price list

How to create a price list rule

Once the common parameters are set, it is possible to specify fees and rewards applied to clients of the selected type. The following sections provide step-by-step guides for each type of rules; though, all of them correspond to the following properties:

  • System transaction processing:

    • A WL requires an own Company profile to process system transactions. The WL Company must have an Account for each of the following purposes:

      • To receive fiat amounts charged from clients according to fee rules. Each currency set in the rules must be provided with a Standard account.

      • To receive crypto amounts charged from clients according to fee rules. Each cryptocurrency set in the rules must be provided with a Crypto account.

      • To send fiat amounts rewarded to clients according to Cashback and Vault rules. Each currency set in the rules must be provided with a Standard account.

  • Common details:

    • Each rule is to be added separately into the Price list.

  • Vilidity period details:

    • It is possible to configure a price list rule for future usage by defining the validity period starting from a day in future. Thus, the end-user can set when a rule is to be activated.

    • The defined period starts from 00:00 UTC and ends at 23:59 UTC.

    • Price list rules cannot be applied to past dates set in the Validity parameters—only current and future dates will be valid.

    • If validation parameters are not stated, the rule will be valid from the current date and unlimited in time

  • Amount field details:

    • If you not need some of the Amount fields to be stated, leave them with zero values.

    • If the Currency parameter is set to Any currency, it is not possible to set the Fixed fee, Minimum fee, and Maximum fee parameters due to uncertainty in conversion.

  • Calculations:

    • Annual percent rates—used in Vault rates, Annual Balance fees, and Unauthorized Negative Balance fees—are calculated every calendar day according to the annual interest rate set in the Percent parameter. The fee/reward calculation is preformed daily for the end-of-day balance as follows.

      • For example, if the Percent parameter is set to 0.5, the daily calculation is performed as follows:

        0.5*(end-of-day balance)/100/365
        MATHEMATICA
      • At the end of the period, the end-of-day calculations are summarized and Client is charged/rewarded for all days in the period.
        For example, if the Percent parameter is set to 0.5, the Period is set to Month, and the account balance has not changed for the whole period, the fee/reward for a month having 30 days is calculated as follows:

        0.5*(end-of-day balance)/100*30/365
        MATHEMATICA

How to create a transaction fee

The Fees tab, available in the top sidebar of a Price list, allows to browse and add new one-off transaction fees to the Price list such as the following:

  • Outgoing transfer fee (fees for outgoing transfers)

  • Deposit fee (fees for credit/debit card deposits)

  • System Deposit fee (fees for incoming/outgoing transactions of the Deposit/Withdrawal transaction type created in the Admin Panel, see Transactions for details)

  • Incoming transfer fee (fees for incoming transfers)

  • Currency conversion fee (fees for currency exchange between personal accounts)

It is also possible to define a fee for transfers and conversions between own accounts by setting the Payment method parameter to Between accounts. In such a case, the fee can be set for Incoming, Outgoing operation types, or both.

To create a fee

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of Price lists will be opened.

  3. Select a Price list for configuration and click Edit.

  4. The Price list details window will be opened.

  5. Navigate to Fees in the top sidebar.

  6. Click Add New in the top-right corner.

  7. The Price list field value will be automatically filled with the current Price list name. If necessary, change a Price list for the rule:

    1. Click List next to the Price List field.

    2. Select a Price List from the arisen menu.

  8. Fill in the Details form. The fields with an asterisk (*) are mandatory.

    1. Set a name for the new rule.

    2. Set the rule status in the Status field to define whether the fee should be Active or Disabled once it is created. It is possible to change the setting later.

    3. Set the Operation type field to define the transactions covered by the rule. It is possible to select only one transaction type.

    4. Set the Beneficiary type field to define transfer recepient type. The parameter is available only for Outgoing transfer fees.

    5. Set the Account provider field to define whether the fee should be applied to accounts of an exact provider. If set to None, all service providers will be considered.

    6. Set the Payment method field to define whether the fee should be applied to to an exact payment type. If set to Any Payment Method, all payment types are considered.

    7. Set the Transfer provider field to define whether the fee should be applied to transactions of an exact provider. If set to None, all service providers will be considered. The parameter is available only for transfer fees.

    8. Set the Valid from and Valid to parameters to define the rule validity period.

  9. Fill in the Amounts form. The fields with an asterisk (*) are mandatory.

    1. Set the Currency field to define the fee currency. It is recommended to select the default currency allowed by the service provider.

    2. Set the Percent field to define how much to charge from clients as percentage from transaction amounts.

    3. Set the Fixed fee, Minimum fee, and Maximum fee to define fixed rates if necessary. The parameters are available for configuration only if a currency is set.

    4. Set the Minimum and Maximum Comissioned Amount paramters to define the amount thresholds to charge fee from.

  10. Click Create to save the rule parameters. The rule will be added to the Price list.

Creating a fee

How to create a recurring fee

The Recurring fees tab, available in the top sidebar of a Price list, allows to configure recurring fees that must be charged from the Client’s Primary account every defined period of time.

  • Service fee is a maintenance fee defined for a profile and charged for the main banking services.

  • Additional Account fee is a maintenance fee charged for extra accounts opened by the Client.

  • Annual Balance fee is a fee that depends on the ending balance held in all accounts opened by the Client. The balance fee can be configured to be daily, monthly, and annually.

  • Unauthorized Negative Balance fee is a fee charged for overdrawn amounts in accounts. If there was no negative balance during the defined period, the fee is not charged.

Negative Balance is not to be confused with a Credit line. Any unauthorized negative balance mostly appears due to fees charged or POS-transactions confirmed later that they should be.

To create a Recurring fee

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of Price lists will be opened.

  3. Select a Price list for configuration and click Edit.

  4. The Price list details window will be opened.

  5. Navigate to Fees in the top sidebar.

  6. Click Add New in the top-right corner.

  7. The Price list field value will be automatically filled with the current Price list name. If necessary, change a Price list for the rule:

    1. Click List next to the Price List field.

    2. Select a Price List from the arisen menu.

  8. Fill in the Details form. The fields with an asterisk (*) are mandatory.

    1. Set a name for the new rule.

    2. Set the rule status in the Status field to define whether the fee should be Active or Disabled once it is created. It is possible to change the setting later.

    3. Set the Operation type field to define the transactions covered by the rule. It is possible to select only one transaction type.

    4. Select the time period in the Period drop-down list. The fee will be charged every time period defined in the parameter.

    5. Set the Valid from and Valid to parameters to define the rule validity period.

  9. Fill in the Amounts form. The fields with an asterisk (*) are mandatory.

    1. Set the Currency field to define the fee currency. It is recommended to select the default currency allowed by the service provider

    2. Set the Percent parameter if necessary. If set, the annual interest rate on total amounts will be charged every defined period of time. Set to 0, if not required.

    3. Set the Fixed fee to define fixed rates if necessary. If set, the fixed amount will be charged every defined period of time. Set to 0, if not required. The parameters are available for configuration only if a currency is set.

  10. Click Create to save the rule parameters. The rule will be added to the Price list.

The Percent parameter can be configured only for Annual Balance and Unauthorized Negative Balance fees.

Recurring fees

How to create an Issued card fee

The Issued card fees tab, available in the top sidebar of a Price list, allows to browse and add new fees to the Price list such as the following:

  • Issuing: Fees for initial card-issuing. Delivered by all card issuing service providers.

  • Additional issuing: Fees for issuing an extra card. Delivered by all card issuing service providers.

  • Block Lost Stolen: Fees to cancel and close a lost card. Delivered by all card issuing service providers.

  • Payment Purchase: POS-transaction fees. Delivered by the Paysend service provider.

  • Domestic ATM Cash Withdrawal: Cash withdrawal fees in the domestic region. Delivered by the Railsbank service provider.

  • International ATM Cash Withdrawal: Cash withdrawal fees outside of the domestic region. Delivered by the Railsbank service provider.

  • Yearly service fee: Annual service fee that can be charged for each card. Delivered by all card issuing service providers.

To create an Issued card fee

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of Price lists will be opened.

  3. Select a Price list for configuration and click Edit.

  4. The Price list details window will be opened.

  5. Navigate to Issued card fees in the top sidebar.

  6. Click Add New in the top-right corner.

  7. The Price list field value will be automatically filled with the current Price list name. If necessary, change a Price list for the rule:

    1. Click List next to the Price List field.

    2. Select a Price List from the arisen menu.

  8. Fill in the Details form. The fields with an asterisk (*) are mandatory.

    1. Set a name for the new rule.

    2. Set the rule status in the Status field to define whether the fee should be Active or Disabled once it is created. It is possible to change the setting later.

    3. Set the Card type field to define whether plastic or virtual cards should be considered. If not set, both types will be covered by the rule.

    4. Set the Card scheme field to define whether Mastercard or Visa cards should be considered. If not set, both schemes will be covered by the rule.

    5. Set the Operation field to define the actions covered by the rule. It is possible to select only one operation type.

    6. Set the Valid from and Valid to parameters to define the rule validity period.

  9. Fill in the Amounts form. The fields with an asterisk (*) are mandatory.

    1. Set the Currency field to define the fee currency. It is recommended to select the default currency allowed by the service provider.

    2. Set the Percent field to define how much to charge from clients as percentage from transaction amounts.

    3. Set the Fixed fee, Minimum fee, and Maximum fee to define fixed rates if necessary. The parameters are available for configuration only if a currency is set.

    4. Set the Minimum and Maximum Comissioned Amount paramters to define the amount thresholds to charge fee from.

  10. Click Create to save the rule parameters. The rule will be added to the Price list.

Creating a fee for card issuing

How to create an FX Markup fee

The FX markup fees tab, available in the top sidebar of a Price list, allows to browse and add new fees to the Price list such as the following:

  • Currency Conversion—fees for currency exchange according to a fixed rate; the fee is included in the currency conversion rate.

To create an FX Markup fee

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of Price lists will be opened.

  3. Select a Price list for configuration and click Edit.

  4. The Price list details window will be opened.

  5. Navigate to FX Markup fees in the top sidebar.

  6. Click Add New in the top-right corner.

  7. The Price list field value will be automatically filled with the current Price list name. If necessary, change a Price list for the rule:

    1. Click List next to the Price List field.

    2. Select a Price List from the arisen menu.

  8. Fill in the Details form. The fields with an asterisk (*) are mandatory.

    1. Set a name for the new rule.

    2. Set the rule status in the Status field to define whether the fee should be Active or Disabled once it is created. It is possible to change the setting later.

    3. The Operation type parameter provides only the Currency Conversion option.

    4. Set the Valid from and Valid to parameters to define the rule validity period.

  9. Fill in the Amounts form. The fields with an asterisk (*) are mandatory.

    1. Set the From currency field to define the conversion source currency.

    2. Set the To currency field to define the conversion target currency.

    3. Set the Percent parameter to define how much to charge from clients as percentage from transaction amounts. The extra percent will be included in the currency conversion rate.

  10. Click Create to save the rule parameters. The rule will be added to the Price list.

Creating a markup fee

How to create a cashback rule

The Cashback tab, available in the top sidebar of a Price list, allows to browse and add new cashback rules to the Price list such as the following:

  • Cashback for outgoing Sepa transfers

  • Cashback for outgoing SWIFT transfers

  • Cashback for outgoing Crypto transfers

  • Cashback for card top-up transactions

To create a Cashback reward program

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of Price lists will be opened.

  3. Select a Price list for configuration and click Edit.

  4. The Price list details window will be opened.

  5. Navigate to Cashback in the top sidebar.

  6. Click Add New in the top-right corner.

  7. The Price list field value will be automatically filled with the current Price list name. If necessary, change a Price list for the rule:

    1. Click List next to the Price List field.

    2. Select a Price List from the arisen menu.

  8. Fill in the Details form. The fields with an asterisk (*) are mandatory.

    1. Set a name for the new rule.

    2. Set the rule status in the Status field to define whether the rule should be Active or Disabled once it is created. It is possible to change the setting later.

    3. Set the Operation type field to define the transactions covered by the rule. At the moment, only Outgoing transfers are available.

    4. Set the Beneficiary type field to define transfer recepient type.

    5. Set the Payment method field to define an exact payment method for the reward rule.

    6. Set the Valid from and Valid to parameters to define the rule validity period.

  9. Fill in the Amounts form. The fields with an asterisk (*) are mandatory.

    1. Set the Currency field to define the cashback currency. It is recommended to select the default currency allowed by the service provider. If set to Any currency, cashback will be provided in the service provider default currency.

    2. Set the Percent parameter to define the reward as percentage from transaction amounts.

  10. Click Create to save the rule parameters. The rule will be added to the Price list.

Creating a cashback rule

How to create a Vault rate

The Vault rates tab, available in the top sidebar of a Price list, allows to configure interest rates and lock-up periods for time deposits implemented in Crassula. See Vaults for additional details on the solution.

All created Vault rates will be available for the end-user in the Web Interface. If multiple rate rules are created for a Price list, the end-user will be able to select the desired one.

To create a Vault rate

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of Price lists will be opened.

  3. Select a Price list for configuration and click Edit.

  4. The Price list details window will be opened.

  5. Navigate to Vault rates in the top sidebar.

  6. Click Add New in the top-right corner.

  7. The Price list field value will be automatically filled with the current Price list name. If necessary, change a Price list for the rule:

    1. Click List next to the Price List field.

    2. Select a Price List from the arisen menu.

  8. Fill in the Details form. The fields with an asterisk (*) are mandatory.

    1. Set the Vault rate name in the Name field. The name will be visible by users in the Web Interface.

    2. Set the rule status in the Status field to define whether the rule should be Active or Disabled once it is created. It is possible to change the setting later.

    3. Set the Valid from and Valid to parameters to define the rule validity period.

  9. Fill in the Amounts form. The fields with an asterisk (*) are mandatory.

    1. Set the Currency field to define the Vault currency. The end-user will be able to open a Vault only from an account in the corresponding currency.

    2. Set the Percent (per year) parameter to define the annual interest rate for Vault accounts.

    3. Set the Lock up period (days) parameter to define how long the money must remain in the account.

    4. Set the Minimum amount parameter to define the minimum amount required for Vault opening. The parameter cannot be set if Any currency is selected for the rule.

    5. Set the On demand parameter if you want the Vault to remain active after the Lock up period. If the parameter is set, the account operates as follows:

      1. The money still must remain in the account till the end of the Lock up period.

      2. The interest rate remains active after the Lock up period.

      3. The Client can manually withdraw (completely or partially) the deposited amount at any moment once the period is over.

      4. The Client can manually withdraw (completely or partially) interest at any moment once the period is over.

  10. Click Create to save the rule parameters. The rule will be added to the Price list. Create more Vault rates with different interest rates and lock-up periods if necessary.

Creating a Vault rate

How to create a fee for changing verification levels

The Change verification level fee tab, available in the top sidebar of a Price list, allows to browse and add new rules to the Price list such as the following:

  • Fees for upgrading a verification level

  • Fees for downgrading a verification level

The functionality is implemented to charge Client when they switch their verification level, including upgrades to a custom verification level with extended limits.

To create a fee for changing verification levels

  1. Navigate to the Price lists tab in the Banking sidebar.

  2. The list of Price lists will be opened.

  3. Select a Price list for configuration and click Edit.

  4. The Price list details window will be opened.

  5. Navigate to Change verification level fees in the top sidebar.

  6. Click Add New in the top-right corner.

  7. The Price list field value will be automatically filled with the current Price list name. If necessary, change a Price list for the rule:

    1. Click List next to the Price List field.

    2. Select a Price List from the arisen menu.

  8. Fill in the Details form. The fields with an asterisk (*) are mandatory.

    1. Set the Vault rate name in the Name field. The name will be visible by users in the Web Interface.

    2. Click the Operation type field to define whether the fee rule should be applied to upgrades or downgrades.

    3. Select the target verification level from the Verification level drop-down menu. The fee will be charged when switching to the selected level.

    4. Set the Valid from and Valid to parameters to define the rule validity period.

  9. Fill in the Amounts form. The fields with an asterisk (*) are mandatory.

    1. Set the Currency field to define the fee currency. It is recommended to select the default currency allowed by the service provider

    2. Set the Fixed fee to define the fixed rate. The fixed amount will be charged once the selected verification level is upgraded (or downgraded).

  10. Click Create to save the rule parameters. The rule will be added to the Price list. Create more fee rules with different verification levels and operation types.

Change verification level fee

How to assign a Price list

Once a Price list is configured, it must be assigned to a client to take action; otherwise, a Standard price list will be used for the client.

A Price List is to be created and published before being assigned to a Client. If you have not created a Price list yet, see the previous sections for details.

To assign a Price list

  1. Make sure the Price List is published, if no other fees need to be added.

  2. Navigate to the Persons or Companies tab, depending on the Client type of the Price List.

  3. Select a Client you need to apply the Price list to.

  4. Click Edit in the corresponding line.

  5. Navigate to the Settings field of the Profile.

  6. Click Price Lists.

  7. Select a Price List in the drop-down menu. Unless a Price List is not selected, the Standard Price List is applied to the Client.

  8. Click Update to apply the changes.

Component parameters

Price lists

Parameter

Description

Name

The column includes the names of created Price lists.

Status

Defines the Price list status:

  • Draft (a Price list is created but not published yet)

  • Processing (a Price list is being published, takes up to 10 minutes)

  • Published (a Price list is active)

  • Disabled (a Price list is inactive)

Client type

Defines the user type the Price list is applied to:

Standard

Defines whether the Price list is Standard. A Standard price list is a unique combination of fees that is created once and set to a Person or a Company by default if otherwise is not stated. There is only one Standard Price list possible for each client type. The parameter can be set in the Edit mode.

External fee enabled

If the option is set, transfer fees will be requested from an external service via API. The price list configuration for transfers will be ignored. The parameter can be set in the Edit mode.

Action

  • Click Show to open a Price list with no right to edit the details

  • Click Edit to open a role with the right to edit the details.

  • Click Publish to activate a drafted Price list.

  • Click Clone to create a duplicating Price list.

  • Click Disable to deactivate a published Price list. Disabled Price lists can be re-activated again.

Filters

Search for access roles by names, status, and client type; multiple-choice is available.

Add new

Create a Price list manually, see the following instructions for additional details.

Configuring the component

Price lists details provides common details of a Price list and its rules.

Price list details

Parameter

Description

Details

The field defines general info demonstrated in the list of the Price lists.

Clients

The field demonstrates all clients the Price list is applied to.

Fees

The field defines the list of all fees included in the Price list.

Cashback

The field defines the list of all cashback rules included in the Price list.

Top sidebar

  • The Fees tab allows to browse and add new one-off fees to the Price list.

  • The Recurring fees tab allows to browse and add new recurring fees to the Price list.

  • The Issued card fees tab allows to browse and add new fees for issued cards to the Price list.

  • The FX markup fees tab allows to browse and add new fees to the Price list such as the following:

    • Currency Conversion (fees for currency exchange according to a fixed rate)

  • The Cashback tab allows to browse and add new cashback rules to the Price list.

  • The Vault rates tab allows to configure interest rates and lock-up periods for time deposits implemented in Crassula. See Vaults for additional details on the solution.

  • The Change verification level fees tab allows to browse and add new fees charged for changing the verification level set for the Client.

Advanced behavior

Recurring fees

When a Multi-currency account is set as Primary, there are additional rules applied to the recurring fee execution. If the recurring fee currency is different from the available balance currency, the fee is charged in the available balance currency.

Example

Multi-currency account is set to Primary.
Account balance is 1000 USD.
Recurring fee amount is 100 GBP.

  1. The fee amount of 100 GBP is converted to USD to calculate the equivalent according to an FX rate.

  2. The FX markup—if one is configured—is included into the equivalent sum.

  3. The equivalent sum in USD is charged from the USD account.

If the account balance is insufficient, the fee will be charged according to the aforementioned scheme once the multi-currency account is deposited.