In some deployments, it is required the caller should be controlled with balance. When caller makes out-going call, the service should check whether he/she has enough balance to make this call. After the call is established, the server should be able to monitor the balance and fee in real-time and the server should release the call forcedly if the user hasn’t enough balance to continue the call.

When the user is receiving incoming call, it is unnecessary to calculate his/her fee.

In MSS system, we name this service as “caller prepaid”. From the network topology, we can see

(1) All prepaid configurations will be configured in MSS and stored in MySQL.

(2) MSS will be responsible for checking balance and calculate fee. Of course, MSS will be responsible for establish and release the calls.

1.1 Abbreviations

DB MySQL database.

MSS miniSipServer

UE User End

2 Configuration

There are three kinds of configurations we shall prepare for “caller prepaid” service.

(1) Remote database configuration.

(2) User configuration.

(3) Prepaid configuration..

2.1 Remote database

In current phase, MSS can only connect to MySQL database.

Please click menu “DataàSystem informationàRemote database” and configure the parameters according to your MySQL configurations.

Figure 2‑1 System information configuration window (Remote database Tab)

Item	Value	Description
Database address	domain name or IP address	Remote MySQL address. Note, MSS and MySQL can be installed in the same computer. In this case, the “database address” should be “localhost”.
Visit port	Integer.	Remote MySQL visit port. If you updated port in MySQL configuration, you need update this configuration in MSS too. The default value is 3306. Please refer to MySQL manual document.
User name	String	The user name which is created in MySQL database. The user should have the right to create database, create tables, etc.
Password	String	Password of the visit user. It depends on MySQL configuration.

2.2 Local user

In default, it is unnecessary to support “caller prepaid’ for normal users. If the user is plan to support “caller prepaid”, it should be indicated clearly.

Please click menu “DataàLocal users” and select/add a user as following.

Figure 2‑2: local user configuration

It is ok to just select “caller prepaid” option.

2.3 Prepaid

It includes following parts: (1) How to set fee rate? (2) How to set balance for the prepaid users. (3) How to calculate fee?

Figure 2‑3: prepaid menu

2.3.1 Prepaid rate

Please click menu “ServicesàPrepaidàPrepaid rate” and prepare to add a new prepaid rate.

Figure 2‑4: prepaid rate configuration

Item	Value	Description
ID	integer	Indication of current record.
Interval	Integer.	Interval for calculating fee. The unit is “second”
Tariff	Integer	Fee for each “Interval”.

For an example, “ID=1; Interval=60; Tariff=10”. It means that MSS should reduce 10(USD) from the user’s balance every 60 seconds.

2.3.2 Subscriber balance

Please click menu “ServicesàPrepaidàSubscriber balance” and prepare to add balance for the prepaid users.

Figure 2‑5: subscriber configuration

Item	Value	Description
Subscriber	String	Local user who is prepaid subscriber
Balance	Integer	Balance of the current prepaid user.

2.3.3 Caller prepaid

Please click menu “ServicesàPrepaidàCaller prepaid” and prepare to set how to calculate fee for the prepaid subscribers.

Figure 2‑6: caller prepaid configuration

Item	Value	Description
Subscriber	String	Local user who is prepaid subscriber. This field can be set with “*”. That means for all prepaid subscriber.
Route number	String	The destination prefix which the call will be routed. This field can be set with “*”. That means for all destinations.
Prepaid rate ID	Integer	Prepaid rate for calculating fee. This ID is configured in previous section “2.3.1Prepaid rate”.

For examples:

We configure following records in the “caller prepaid” table.

Subscriber	Route number	Prepaid rate ID	Description
*	*	1	For all prepaid subscriber and all destination, the rate “1” will be applied.
*	101	2	Any subscribers call destination with prefix “101”, the rate “2” will be applied.
100	*	3	Subscriber “100” calls any destination, the rate ID “3” will be applied.
100	1	4	Subscriber “100” calls destination whose prefix is “1”, the rate ID “4” will be applied.

Then, we can see which rate will be applied in following cases.

(1) “100” call “101”. The rate ID “4” will be applied.

(2) “100” call “800xxx”. The rate ID “3” will be applied.

(3) “102” call “101”. The rate ID “2” will be applied.

(4) “102” call “103”. The rate ID “1” will be applied.