Savings

Introduction to Savings

Savings programs offer clients a way to invest their idle funds and earn interest by holding them on savings accounts. These programs provide a passive method to grow their crypto or fiat assets, similar to traditional bank savings accounts.

Key points

  • Savings programs can operate based on Fixed and Flexible strategies.

  • In a Fixed strategy, clients must invest a predefined amount and earn a fixed interest rate throughout the program’s duration. These programs have a set period during which clients must hold their funds, and interest is accrued and paid according to the payment period set in a program.

  • The Flexible strategy allows clients to deposit the minimum required amount or more and make additional deposits. The interest rate is flexible and determined by tiers, which assign rates based on the invested amount. Programs with flexible strategies aren’t limited by time, and interests are accrued daily and paid to clients on the first day of each month.

  • To subscribe to a savings program, clients must have wallets denominated in the program currency. Earned interests are then paid to the same client wallets.

  • When clients subscribe to savings programs and invest the required amounts, individual savings plans are created for them, including lists of interest payments.

  • For both strategies, partial withdrawals are prohibited. Clients can only withdraw the full amount of invested funds, which leads to the termination of their respective savings plans.

Presets

On this page, you can view a list of presets containing settings of the created savings programs, modify them, and create new ones.

Presets can’t be deleted but can be disabled by changing their status to Inactive.

General information

The following information is provided about each savings program:

ID

The identifier of a savings program.

Name

The unique name of a savings program, which is displayed to clients in the B2Core UI.

Strategy

The savings strategy:

  • Fixed — a fixed interest rate

  • Flexible — a flexible interest rate

Currency

The currency of a savings program. To subscribe to the program, your clients must have wallets denominated in the program currency.

Status

The status of a savings program.

  • If Active, the card showing details of a savings program is displayed in the B2Core UI, and clients can subscribe to the program.

  • If Inactive, the card of a savings program isn’t displayed in the B2Core UI.

Description

The description of a savings program, which is displayed to clients in the B2Core UI.

Created

The date and time when a savings program was created.

Last updated

The date and time when a savings program was last updated.

To view savings program details, click the Edit button.

Details

On the details page, you can view and modify the following program settings:

Name

The unique name of a savings program, which is displayed to clients in the B2Core UI.

Status

The status of a savings program.

  • If Active, the card showing details of a savings program is displayed in the B2Core UI, and clients can subscribe to the program.

  • If Inactive, the card of a savings program isn’t displayed in the B2Core UI.

Admission fee

The fee amount that a client must pay for participation in a savings program. When subscribing to the program, the admission is deducted from a client wallet denominated in the program currency.

The field is optional. If you don’t want to charge the admission fee, enter 0 (zero).

Description

The description of a savings program, which is displayed to clients in the B2Core UI.

Flexible Preset Details

Minimum investment amount

The minimum amount of the initial investment. When subscribing to a program, clients must invest the specified minimum or more.

Minimum additional investment amount

The minimum amount that clients can add to the initial investment.

The minimum investment and additional investment amounts can be specified as integer or decimal values.

Penalty period (days)

The period, in days, during which a client can’t withdraw their invested funds without a penalty.

Redeem penalty

The penalty amount charged to a client if the client withdraws their invested funds before the end of the penalty period.

The penalty amount can be specified as an integer or decimal value and must be less than the minimum investment amount.

No partial withdrawal is allowed; only the full amount of invested funds can be withdrawn. Upon withdrawal, the client’s savings plan is terminated.

If a client withdraws their invested funds during the the penalty period, the amount that the client can return to their wallet is calculated as follows: Total invested amount - Redeem penalty.

Payment period

The frequency of interest payments to a client wallet. Always, “The first day of each month” and can’t be changed.

Tiers

In this section, you can view the number of added tiers that are used to apply flexible interest rates.

For each tier, the following parameters are specified:

Tier from

The minimum amount that clients must invest to get an interest rate assigned to that tier. This amount indicates the tier’s starting point and the previous tier’s end point.

Annual percentage rate

The annual interest rate, in percentage, applied to the tier.

There is the tier with the Tier From value equal to 0 (zero), which can’t be removed.

For example, suppose you have the following tiers configured:

  • Tier 1: the Tier from is 0 and the Annual percentage rate is 1%

  • Tier 2: the Tier from is 2,000 and the Annual percentage rate is 2%

If a client invests 500, that client receives an interest rate of 1%.

If the client adds 1,499, bringing the total invested amount to 1,999, the interest rate remains at 1%.

Once the client adds more funds and reaches a total investment of 2,000 or more, the interest rate increases to 2%.

When modifying tiers, you can select the Update Savings Plans Tiers to apply the modified tiers to the savings plans that have already been created based on the selected preset (for details, refer to Modify tiers for savings programs with Flexible strategies).

Fixed Preset Details

Plan length (days)

The holding period, in days, during which the investment amount contributed to a savings program must be held. The plan length can be specified with an interval of 30 days, such as 30, 60, 90, and so on.

At the end of the plan length, the investment amount is refunded to the client wallet.

Payment period (days)

The payment period, in days, indicating how often interest is accrued and paid to a client wallet. The payment period can be specified with an interval of 30 days, such as 30, 60, 90, and so on.

Investment amount

The amount that must be contributed to a savings program. When subscribing to the program, the investment amount is deducted from a client wallet denominated in the currency of the savings program. If a client has more than one wallet denominated in the program currency, the client can select a wallet from which the investment amount should be deducted.

Interest rate (percent)

The percentage of the investment amount, which is used to calculate interest earned at the end of each payment period.

Cancellation penalty

The penalty amount charged to a client if the client wants to withdraw the amount invested to a savings program before the end of the plan length.

The penalty amount can be specified as an integer or decimal value and must be less than the investment amount.

No partial withdrawal is allowed; only the full investment amount can be withdrawn. Upon withdrawal, the client’s savings plan is terminated.

The amount that the client can return to their wallet is calculated as follows: Investment amount - Cancellation penalty.

Plans

On this page, you can view a list of savings plans that are created for clients after they subscribe to savings programs.

General information

The following information is provided about each plan:

ID

The plan identifier.

Status

The plan status.

Strategy

The savings strategy:

  • Fixed — a fixed interest rate

  • Flexible — a flexible interest rate

Preset

The identifier of a preset containing settings of the savings program to which a client subscribed.

Click the identifier to navigate to the preset details page and view the program settings.

Client

The client identifier.

Click the identifier to navigate to the client details page and view information about the client.

Wallet account number

The identifier of a client wallet to which earned interest is paid.

Details

The essential settings (such as the currency, investment amount, admission fee, and cancellation penalty) of the savings program to which a client subscribed.

Created

The date and time when a client subscribed to a savings program.

To view payment plan details, click view-button.

Details

On the details page, you can view settings of the savings program to which a client subscribed. Additionally, a list of interest payments is displayed.

For Fixed strategies, the payments list include scheduled payments as well as payments that have been already made to a client wallet.

For Flexible strategies the list displays only payments made to a client.

The following information is provided about each interest payment:

ID

The identifier of a payment transaction.

Amount

The interest amount.

Due date

Applicable only for Fixed strategies

The date and time when a payment is scheduled to be made.

Status

The payment status:

  • Scheduled — indicates that a payment is scheduled but hasn’t yet been made

  • Paid — indicates that a payment has been made to a client

  • Cancelled — indicates that a payment was cancelled because the client decided to withdraw the investment amount before the end of the plan length (for Fixed strategies) or before the end of the penalty period (for Flexible strategies).

Paid date

Only for interest payments to which the Paid status is assigned.

The date and time when interest was paid to a client.