Wholesale SMS Delivery  

Typical Business Case

Scenario

Checklist

Initial Configuration of PortaSwitch®

Enable the Messaging Service on the Configuration Server

Configure HLR Lookup

Enter Destinations in the E.212 Format

Upload Destinations in the E.212 Format from a File

Manually Add Destinations in the E.212 Format

Create a Domain Service Policy

Create a Service Policy for Vendor Connection

Create a Vendor Tariff

Vendor Tariff for Lleida Networks

Upload Sending Rates to the Vendor Tariff

Vendor Tariff for SmartNet

Create Vendors

Create a Vendor for Lleida Networks

Define a Connection for Lleida Networks

Create a Vendor for SmartNet

Define a Connection for SmartNet

Create a Customer Tariff

Enter Rates to the Customer Tariff

Create a Product

Create Invoice Template

Create a Customer Class

Create a Customer

Create Accounts

Test Routing with Test Dialplan (optional)

Test the whole system

Typical Business Case

Similarly to wholesale voice traffic termination, you can configure PortaSwitch® to serve as an intermediate SMS aggregator: it will collect SMS traffic from your customers and deliver the traffic to large SMS aggregators via the SMPP protocol. You, as the service provider and PortaSwitch® owner, receive a profit from the difference between:

·       The price you charge your customers for passing the SMS traffic received from them to SMS aggregators and

·       The price you pay the SMS aggregators for the SMS traffic transmission.

 

Wholesale SMS flow

 

Typically, SMS aggregators operate with MCC / MNC codes for destinations. Therefore, enable HLR lookup in PortaSwitch® to identify which mobile network a message recipient belongs to and to which SMS aggregator the message must be routed. Please refer to the PortaBilling® Administrator Guide for a detailed description of SMS routing with real-time HLR lookup.

 

This chapter provides instructions for such a configuration.

Scenario

Customer SmartNet sends bulk SMS traffic to your network from their gateway via the SMPP protocol. You authorize SmartNet using the IP address and re-send their SMS traffic to the SMS aggregator (e.g. http://www.lleida.net) for further delivery to subscribers.

 

SmartNet, as the SMSC (Short Message Service Center), requires that PortaSwitch® establish a binding connection with their gateway. Thus, SmartNet is configured both as a vendor (for PortaSwitch® to bind to their system as a transceiver) and as a customer, since SmartNet is charged for sending SMS traffic.

Checklist

Print the following page and use it to check off the operations you have completed while performing the system setup according to the instructions in this chapter. Please be sure to perform all of the operations in the order designated (all of the boxes must be checked), otherwise the service will not work.

 

 

Operation

 

Done

General Configuration

 

Enable the Messaging Service on the Configuration server

[     ]

Enable the HLRNumberLookup module on the Configuration server

[     ]

Network configuration

 

Enter destinations in the E.212 format

[     ]

Create a domain service policy (that will be referred to as service policy A later on). It determines which type of transport protocol is used for messages and which will be used for internal communications between PortaSIP® and the billing engine

[     ]

Create a service policy (that will be referred to as service policy B later on) for the vendor connection. It will be used to provision the parameters required to connect to the off-net vendor

[     ]

Rating configuration (Vendor)

 

Create a tariff (that will be referred to as tariff A later on), that describes your SMS aggregator’s transmission rates

[     ]

Upload rates to tariff A for the destinations you plan to transmit to this aggregator

[     ]

Create a tariff (that will be referred to as tariff B later on) for your SMSC

[     ]

 

Create a vendor for your SMS aggregator

[     ]

Create a connection for this vendor using tariff A and associate service policy B with it

[     ]

Create a vendor which represents the SMSC

[     ]

Create a connection for this vendor using tariff B and associate service policy B with it

[     ]

Rating configuration (Customer)

 

Create a tariff (referred to as tariff C later on), that will be used to charge the SMSC for sending SMSs

[     ]

In tariff C, upload the rates for the destinations to which your customer (SMSC) will send messages

[     ]

Create a wholesale SMS product

[     ]

Create a rating entry for this product, associating the Messaging Service, the PortaSIP® node and tariff C

[     ]

Account provisioning

 

Create a customer class that will apply to your customers

[     ]

Create a wholesale customer who owns the accounts representing remote gateways

[     ]

Create an account for the customer and specify the remote gateway’s IP address as the account ID

[     ]

Testing

 

Test routing for SMS messages with Test Dialplan

[     ]

Initial Configuration of PortaSwitch®

If you have just installed the PortaSwitch® software or dedicated a new billing environment to configure the services described in this handbook, make sure to first perform the initial configuration of PortaSwitch®. To do this, use the Initial Configuration of PortaSwitch® handbook.

Enable the Messaging Service on the Configuration Server

1.       On the Configuration server, clone the existing configuration to modify it.

2.       Select BillingEngine on the Configuration Tree. Enable the Messaging Service in the ServiceTypes group.

 

Enable the service on the Configuration Server

 

3.       Click the Save button and then the check_apply Verify button.

4.       Verify the new configuration and click the check_apply Check / Apply button.

Configure HLR Lookup

1.       Set up an account with www.hlr-lookups.com. You will be provided with the credentials for API communication.

2.       On the Configuration server clone the currently active configuration to modify it.

 

Enable HLR Lookup

 

3.       From the Configuration tree select Admin->Global->HLRNumberLookup and fill in the following information:

·       Enabled – Select Yes.

·       Username – Type in your account ID.

·       Password – Specify the password.

 

Enble HLR Lookup on the processing node

 

4.       Select the SIP cluster and set Yes in the use_hlr_lookup option in the ProcessingNodeIMGate group.

5.       Click the Save button and then the check_apply Verify button.

6.       Verify the new configuration and click the check_apply Check / Apply button.

Enter Destinations in the E.212 Format

The majority of SMS aggregators operate with destinations that are defined in the E.212 format. This format defines destinations as a combination of the mobile country code (MCC) and the mobile network code (MNC). Therefore, to easily operate with SMS aggregators, enter destinations in PortaBilling® in the E.212 format.

Upload Destinations in the E.212 Format from a File

1.       On the navigation menu, type Destinations in the  Search field.

2.       On the Destination panel, click Upload.

3.       In the Upload destinations dialog box, select Default destinations and click the arrow  next to the E.212 destinations format.

4.       Save a set of destinations as a .csv (comma-separated values) file.

5.       Open this file in Microsoft Excel or any other suitable program. Edit the data if necessary and save your changes.

 

Download the default set of destinations

6.       Switch back to the PortaBilling® admin interface and on the Destination panel, click Upload again.

7.       In the Upload destinations dialog box, select Default destinations.

8.       Select the check box for I have checked the default destinations.

9.       Select the E.212 destinations format check box and click Upload.

 

Upload the destinations

Manually Add Destinations in the E.212 Format

1.       On the navigation menu, type Destinations in the  Search field.

2.       Open the Create a destination panel.

3.       Select E.212 in the Format field.

4.       Fill in the destination information. This includes the MCC and MNC codes. Start typing the code to narrow the search. The Country and Network fields will be auto-populated. You can use the Description field to store extra information about the destination (e.g. proper).

 

Add destinations manually

 

5.       Click Save.

6.       Repeat these steps for any additional destinations you would like to add.

Create a Domain Service Policy

A service policy is a set of parameters that defines how the subsystems of PortaSwitch® must operate to provide the Messaging service.

 

At this point, it is necessary to create a domain service policy. This policy is used for internal communication between PortaSIP® and the billing engine.

1.       On the navigation menu, type Service policies in the  Search field.

2.       Open the Create service policy panel.

3.       Fill in the service policy details:

·       Name – Specify the name of the service policy (e.g. SMS service).

·       Service type – Select Messaging service.

·       Recipient domain pattern – Specify a pattern according to which the service policy will be selected. Type % for the SMS service.

4.       Click Save.

 

Create a domain service policy

 

5.       On the Service policy panel, fill in the following fields:

·       Match priority – Specify 5 in this field.

·       Description – Provide a short text description of the service policy.

6.       Open the Attributes panel.

7.       Select the Processing messages over SIP/SMPP panel.

8.       Specify the following attributes:

·       Transport protocol – Select the check box and choose the SMPP option from the list.

·       Outgoing AAA – Select the check box. Use the slider to enable outgoing message authorization and billing.

·       External routing – Select the check box. Use the slider to enable sending SMS traffic to off-net vendors.

·       Local lookup – Select the check box. Leave the slider as it is (disabled).

·       Userpart Е164 translation – Select the check box. Use the slider to enable using the dialing rules for phone number translation.

9.       Click Save.

 

Configure the domain service policy

 

_Hint_ExclamationMark Note that any service policy changes will not be applied immediately. It will take several minutes until they are propagated to PortaSIP®.

Create a Service Policy for a Vendor Connection

The service policy for a vendor connection defines the specific parameters for this connection. For these parameters to apply, the service policy must be associated with the corresponding vendor connection.

1.     On the navigation menu, type Service policies in the  Search field.

2.     Open the Create service policy panel.

3.     Fill in the service policy details:

·       Name – Specify the name of the service policy (e.g. SMS aggregator).

·       Service type – Select Messaging service.

4.     Click Save.

 

Create a service policy for vendor connection

 

5.     On the Service policy panel, add the following fields:

·       Description – Provide a short text description of the service policy.

6.     Open the Attributes panel.

7.     Select the Processing messages over SIP/SMPP panel.

8.     Specify the following attributes:

·       Transport protocol – Select the check box and choose the SMPP option from the list.

·       Bind as – Select the transceiver option from the list for the option to send and receive messages.

·       Heartbeat interval – Specify the interval (in seconds) in which ENQUIRE_LINK requests are sent to verify a connection. The zero default means no requests will be sent. Specify 30 for the SMS aggregator.

9.     Click Save.

 

Configure the service policy for vendor connection

NOTE: In case your customer’s parameters differ, in this case, SmartNet (e.g. Heartbeat interval is 10 seconds), create a new service policy specifically for this customer.

_Hint_ExclamationMark Note that any service policy changes will not be applied immediately. It will take several minutes until they are propagated to PortaSIP®.

Create a Vendor Tariff

Vendor Tariff for Lleida Networks

This tariff will contain your SMS aggregator’s transmission rates.

1.     On the navigation menu, type Tariffs in the  Search field.

2.     On the Create tariff panel, fill in the tariff details:

·       Name – A short name for the tariff object; this is the name you will see in the select menus (e.g. Lleida Networks).

·       Currency – Indicates the currency in which the SMS aggregator charges you.

NOTE: The currency for the tariff may only be chosen once and cannot be changed later.

·       Service – Choose Messaging service here.

·       Format – Select the format the SMS aggregator operates with. Select E.212 from the list.

·       Applied to – Choose Vendor in the Applied to select menu.

·       Routing – Use the slider to enable this option since this tariff will be used both to calculate your costs and to route SMS messages.

3.     Click Save.

 

Create a vendor tariff

 

Upload Sending Rates to the Vendor Tariff

Upload per-destination sending rates provided by your SMS aggregator from a .CSV or.XLS file. As messaging services are charged per message, the rating parameters will be as follows:

 

·       MCC/Country – destination mobile country code.

·       MNC/Network – destination mobile network code.

·       Unit Price – price per message (e.g. $0.01).

 

 TIP: You can define route categories in the .csv file and upload the rates with the route categories assigned to them.

 

Please consult the Rate Import handbook for more details.

 

timesaver Perform the Create Tariff and Upload Sending Rates steps described above until you have created a tariff with termination costs for each transmission partner you have.

Vendor Tariff for SmartNet

SmartNet is your customer and is charged for sending SMS traffic according to the customer tariff (which will be created later). Since SmartNet requires that PortaSwitch® bind to their system, SmartNet will be created as a vendor, too. Thus, a vendor tariff is required for a SmartNet connection. You do not need rates for this tariff, since it will not be used for SMS message routing.

1.     On the navigation menu, type Tariffs in the  Search field.

2.     On the Create tariff panel, fill in the tariff details:

·       Name – A short name for the tariff object; this is the name you will see in the select menus (e.g. SmartNet).

·       Currency – Indicates the currency.

NOTE: The currency for the tariff may only be chosen once and cannot be changed later.

·       Service – Choose Messaging service here.

·       Format – Select the format the SMS aggregator operates with. Select E.212 from the list.

·       Applied to – Choose Vendor in the Applied to select menu.

·       Routing – Make sure this option is disabled, since this tariff will not be used for SMS message routing.

3.     Click Save.

 

Create a vendor tariff

Create Vendors

Create a Vendor for Lleida Networks

_Hint_ExclamationMarkPrior to configuring PortaBilling® you must first sign up for Lleida Networks’ SMS services. To do this, send an email to support@lleida.net to apply for an account. Upon successful account registration, you will be provided with an account login and password. These credentials are used to access the Lleida Networks user interface and also for PortaBilling® vendor authorization.

 

As your SMS transmission partner, Lleida Networks must be provisioned as a vendor in PortaBilling®. To do this:

1.     On the navigation menu, type Vendors in the  Search field.

2.     On the Create vendor panel, fill in the vendor details:

·       Name – Type a short name for the vendor object; this will be used on the web interface (e.g. Lleida Networks).

·       Currency – Choose the currency in which this vendor charges you.

·       Opening balance – This indicates a starting balance for the vendor; the default is zero.

·       Billing period – Split period for vendor statistics.

3.     Click Save.

 

Create a vendor

 

When a message is sent from your network to the vendor’s gateway, the vendor performs an authorization for the message and provides you with a username and password to use for message authorization. These credentials must be stored with the “vendor authorization” info and then associated with a specific connection so that they can be used during actual message transmission.

 

4.     Create an account for digest authorization of outgoing messages:

5.     On your vendor’s panel (Lleida Networks), click General configuration, then click Authorization.

6.     On the Authorization panel, click Add and enter the credentials provided by the vendor.

7.     Click Save.

 

Configure vendor authorization

Define a Connection for Lleida Networks

The connection is the point where SMS messages leave or enter your network and is therefore where costs are incurred.

_Hint_ExclamationMark Please bear in mind that only one connection per Lleida account is possible for Lleida Networks.

 

1.     On your vendor’s panel (Lleida Networks), click Connections.

2.     On the Create connection panel, fill in the connection details: 

·       Description – Give a short description to the connection that will be shown on the list of connections.

·       Service type – Select Messaging Service here.

·       Type of connections  Select SMPP.

·       Tariff – Choose the tariff that defines your termination costs for this connection / vendor.

·       Active – Use the slider to set this connection as active.

·       Gateway ID – Specify the IP address or ID of the vendor’s gateway.

·       Service policy – Select the service policy you created for this connection (e.g. SMS aggregator).

3.     Click Save.

 

Configure the connection

 

4.     Click General configuration panel.

·       Vendor authorization – Select the vendor authorization you created for this connection (e.g. Lleida SMS).

5.     Click Save.

Select the vendor authorization

Create a Vendor for SmartNet

Your customer, SmartNet, is a SMSC and requires that PortaSwitch® establish a binding connection with their gateway. Thus, SmartNet must be provisioned as a vendor in PortaBilling®. To do this:

1.     On the navigation menu, type Vendors in the  Search field.

2.     On the Create vendor panel, fill in the vendor details:

·       Name – Type a short name for the vendor object; this will be used on the web interface (e.g. SmartNet).

·       Currency – Choose the currency in which this vendor charges you.

·       Opening balance – This indicates a starting balance for the vendor; the default is zero.

·       Billing period – Split period for vendor statistics.

3.     Click Save.

 

Create a vendor

 

When establishing a binding connection with SmartNet, PortaSwitch® sends credentials that SmartNet provides for authorization. These credentials must be stored with the “vendor authorization” info and then be associated with a specific connection so that they can be used during an actual binding procedure.

 

4.     Create an account for the digest authorization of incoming messages:

5.     On your vendor’s panel (SmartNet), click General configuration, then click Authorization.

6.     On the Authorization panel, click Add and enter the credentials provided by the vendor.

7.     Click Save.

 

Configure vendor authorization

Define a Connection for SmartNet

1.     On your vendor’s panel (SmartNet), click Connections.

2.     On the Create connection panel, fill in the connection details: 

·       Description – Give a short description for the connection that will be shown on the list of connections.

·       Service type – Select Messaging Service here.

·       Type of connections – SelectSMPP.

·       Tariff – Choose the tariff that defines your termination costs for this connection / vendor.

·       Active – Use the slider to set this connection as active.

·       Gateway ID – Specify the IP address or ID of the vendor’s gateway (e.g. 192.143.12.6).

·       Service policy – Select the service policy you created for this connection (e.g. SMS aggregator).

3.     Click Save.

 

Create vendor connection

 

4.     Click General configuration panel.

·       Vendor authorization – Select the vendor authorization you created for this connection (e.g. SmartNet).

5.     Click Save.

 

Select the vendor authorization

Create a Customer Tariff

This tariff will contain your customer’s rates for sending SMSs.

1.     On the navigation menu, type Tariffs in the  Search field.

2.     On the Create tariff panel, fill in the tariff details:

·       Name – Type a short name for the tariff object; this is the name you will see in the select menus (e.g. SMS delivery).

·       Currency – Indicates the currency in which you charge your customers.

NOTE: The currency for the tariff is chosen only once and cannot be changed later.

3.     Service – Choose Messaging service here.

4.     Format – Select E.212 from the list.

5.     Applied to – Select Customer, as this tariff will be used to charge your customers.

6.     Managed by – Select Administrator only here, since we are setting up a service without the involvement of resellers.

7.     Click Save.

 

Create a customer tariff

Enter Rates to the Customer Tariff

1.     On the Tariff panel, fill in the Add rate details:

·       MCC/Country – Select the MCC / Country pair from the list (e.g. 230 for the Czech Republic).

·       MNC/Network – Select the MNC / network pair from the list (e.g. 01 for T-Mobile).

NOTE:  You must create an entry for MCC / MNC codes in the Destination register before creating a rate for them in the tariff.

·       Unit Price – Price per message (e.g. $0.02).

 

2.     Click Save.

3.     Repeat these steps if you need to enter more rates.

 

Add rates to the customer tariff

Create a Product

Your wholesale customers’ remote gateways are represented as accounts and are therefore billed according to the products you create for those accounts.

1.       On the navigation menu, type Products in the  Search field.

2.       On the Create product panel, fill in the product details:

·       Name – Type in a short name for the product object; this is the name you will then see in the select menus (e.g. Wholesale SMS).

·       Name visible to end users – Specify the name of the product that your customers will see on their self-care interface (e.g. Easy SMS).

·       Product type – Choose Main Product here.

·       Currency – Product currency; only tariffs that share the same currency will be permitted in the rating list.

·       Managed by – Choose Administrator only here, since we are setting up a service without the involvement of resellers.

·       Account default ACL – Choose an Access Control List (ACL) for accounts with this product assigned. ACLs control which objects end users can have access to and which actions they can perform.

·       Account role – Select IPv4 address from the list.

3.       Click Save.

 

Create a product

 

4.       On the Product panel, click Services and then Add a service.

5.       Select the Messaging service and click Add.

6.       Click Save.

Add a service to the product

Charges

The Charges section provides access to a group of panels where you can set up overdraft protection and define how to charge your customer for a messaging service. On the Product panel, click Charges.

General info

On the General info panel you can define special pricing such as volume discounts, regular payments such as subscriptions, and set up overdraft protection.

·       Overdraft protection – Leave this box checked to prevent overdraft for users who use this product.

·       Breakage – Specify the minimum amount of funds the account must contain to use the services.

·       Default discount plan – This allows you to assign a discount plan for the product. Leave None as no volume discount plan is specified for this service.

·       Subscription – This allows you to choose a subscription plan for the product, so that this plan will be automatically applied to every account with this product assigned. Skip this step if no subscription plan is specified for this service.

 

Configure the product

Usage charges

The Usage charges panel has two functions: it defines the permitted access points (nodes and access numbers) and specifies which tariff must be used for billing at each of these points.

7.       On the Product panel, click Charges, then click Usage charges.

8.       On the Usage charges panel, click Add.

9.       Fill in the required information:

·       Service – Select Messaging Service from the list.

·       Node – Select the PortaSIP node.

·       Access code – Leave this field empty.

·       Tariff – Select the tariff that will be applied to your customers for sending SMSs (e.g. SMS delivery).

·       Overdraft protection – Use the slider to send alerts when overdraft is detected.

10.    Click Save.

Add usage charges

Additional information

Define additional settings for the product.

1.     On your product’s panel, click Additional information.

2.     On the Additional information panel, fill in the following product information:

·       Notes – Open the Notes panel to make notes about the product.

·       Product group – A product group is a custom grouping of add-on products on the account self-care interface. Select None for this product.

·       Account default ACL – The access level assigned by default to new accounts created with this product. The ACL determines which operations may be performed by accounts on the self-care pages. The default ACL value “Account self-care” allows all possible operations.

·       Information URL – If you have an external server with a description of product features, enter the URL here (e.g. http://www.myproduct.com). Your customers will be able to go there from their self-care page.

·       Description – Your internal comments about the intended use of this product.

·       Description visible to end users – Provide a product description to be shown to end users on their self-care interfaces.

3.     Click Save.

 

Additional settings for the product

Create Invoice Template

At the end of the billing period, PortaBilling® can produce invoices for your customers. An invoice reflects all the transactions (calls, payments, refunds, subscription charges, etc.) that occurred during a specific period. It serves as the primary record of services provided to a certain customer as well as the primary record of their status. To enable invoice generation you need to create a template for the invoice layout first.

 

Create an invoice template as described in the Setting up a Wholesale Traffic Exchange handbook.

Create a Customer Class

Customer class provides the ability to globally define a group of parameters in a centralized way, and then apply those parameters to many customers at once.

1.     On the navigation menu, type Customer classes in the  Search field.

2.     On the Create a customer class panel, fill in the customer class details:

·       Name – Type a short name for this customer class.

·       Currency – Specify the currency in which you want to set the Collection threshold. When specified, this customer class can only be assigned to customers with the same currency. Once the currency selection is saved, it cannot be changed.

·       Business model – Select which customers this customer class will apply. Select SIP trunking from the list.

·       Managed by – Select Administrator only.

3.     Click Save.

 

Create a customer class

 

4.     On your customer class panel, click Finances, then click General info.

5.     On the General info panel, fill in general information about the customer class:

·       The billing period is closed – Select Automatically.

·       Configurethe Statistics parameters:

o   Send statistics via email – Define how you will provide statistics to your customers.

·       Configure the Customer status changes parameters:

o   Suspend on insufficient funds for subscriptions – Here you can specify whether PortaBilling® must check whether the customer has sufficient funds for their subscription charges.

o   Permanently terminate customers after provisional termination – Use the slider to enable the option. Specify the amount of days (e.g. 120) after which the provisionally terminated customer becomes permanently terminated.

·       Configure the Other parameters:

o   Description – Your comments about the intended use of this customer class.

6.     Click Save.

Fill in the customer class information

 

7.     On your customer class panel, click Finances, click Invoicing, then click Regular invoices.

8.     On the Regular invoices panel, specify the invoicing parameters for the customer class:

·       Use regular invoicesEnable this parameter to generate regular invoices for customers who belong to this customer class.

·       Invoice template – Select the appropriate template which will be used to create a .pdf file with the invoice for your customers (e.g. Wholesale invoice template).

·       Generate invoice pdf – Leave the default option At the end of the billing period to generate the .pdf files once the billing period ends.

·       Send the invoice via email – Select Automatically to automatically send an invoice to a customer at the end of the billing period.

·       Configure Payment terms, Payment collection and Action upon non-payment parameters for customers. Please consult the PortaBilling® help for a description of parameters available here.

9.     Click Save.

Configure regular invoices

 

10.   On the Invoicing panel, click Out-of-turn invoices (optional) to enable generation of the out-of-turn invoices (to cover only a few specific items) on demand for customers that belong to this customer class. Specify the invoice template and copy the settings from Regular invoices panel.

11.   On the Taxation panel, specify the taxation method to be applied to your customers.

12.   Click Save.

 

Specify the taxation method

Create a Customer

A customer is a company that sends SMS traffic for you to transmit and pays depending upon the amount of traffic sent. The customer’s contact information is used to distribute account usage information, service usage statistics, invoices, etc.

 

In this example, we will describe how to manually create a new customer, without using a Quick Form.

1.     On the navigation menu, type Customers in the  Search field

2.     On the Create customer panel, fill in the customer details:

·       Name – Type a short name for the customer object; this will be used on the web interface.

·       Business model – Select SIP trunking for this customer. A business model defines what type of service is to be provided to the customer.

·       Customer class – Select the previously created customer class for wholesale customers. By choosing a specific class here the customer will automatically inherit all of the class properties (grace period, invoice template, etc.).

·       Billing period – Choose a billing period for the customer. A billing period defines the frequency of invoicing for this customer.

·       Billing period time zone – Choose a time zone in which customer’s billing period will be closed and invoices will be generated.

·       The last day of the billing period – This is a read-only field available only during customer creation. It shows the last date of the customer’s first billing period. Note that this date is shown in customer’s time zone.

·       Balance control - Specify the way the customer will pay for the service: Postpaid – after consuming the services; Prepaid – prior to consuming the services. Select Postpaid in this field.

·       Currency – Choose the currency in which this customer will be billed.

·       Credit limit – Assign a credit limit for the customer.

3.     Click Save.

Create a customer

Personal

Define the customer's personal information (such as name, email address, and etc.).

1.     On your customer’s panel, click Personal, then click General info.

2.     On the Personal info panel, fill in the customer’s personal information and an email address for the receipt of accounting information. After the billing period is over, a list of xDRs and other statistics will be sent to this address.

Address info panel

1.     While on the Personal panel, click Address info.

2.     On the Address info panel specify the customer’s address. In the BCC field type in the email address of your account representative. They will receive a copy of every outgoing email sent to the customer; this may be used for debug and archiving purposes.

Web self-care

Define credentials and preferred settings (such as language, time zone, date input and output formats) for this customer's self-care interface.

1.     On your customer’s panel, click Personal, click General info, then click Web self-care.

2.     On the Web self-care panel, define credentials for the customer self-care interface (such as login, password, time zone, etc.) and other preferred settings.

Subscriptions

Define whether to suspend the customer when their balance is insufficient to cover subscription charges.

1.     On your customer’s panel, click Finances, click General info, then click Subscriptions.

2.     On the Subscriptions panel, set the Suspend on insufficient funds parameter. This defines whether the system must check that the customer has sufficient funds for their subscription charges. 

Balance and credits

1.     On your customer’s panel, click Finances, click General info, then click Balance and credits.

2.     On the Balance and credits panel, define the Credit limit warning threshold parameter. The customer can be notified by email when his balance is dangerously close to the credit limit and service will soon be blocked. The threshold can be specified:

·       As a percentage (e.g. 90%). The warning will be sent when the customer’s balance exceeds that percentage of his credit limit. So, if the credit limit is USD 1000.00 and the threshold is 90%, a warning will be sent as soon as the balance exceeds USD 900.00. This is only applicable when the customer has a positive credit limit.

·       As an absolute value. The warning will be sent as soon as the balance goes above the specified value.

NOTE: To specify several credit limit warning thresholds, enter the values by clicking .

Invoices and taxation

Define whether to send this customer their statistics and invoices by email.

1.     On your customer’s panel, click Finances, and then click Invoices and taxation.

2.     On the Invoices and taxation panel, set the Send Statistics via email option to Summary only. This delivers a call summary only and do not attach a details file; this could be useful in the case of a large number of calls. Other options are Full Statistics (attach a complete list of xDRs) or Do not send (this option prevents the delivery of event statistics to this customer via email).

Services

1.     On your customer’s panel, click Services.

 

The Services panel provides an access to a group of panels where you can activate / deactivate various features of the voice calls service provided to the customer.

 

This is a convenient way for managing parameters which are the same for a whole set of accounts. Instead of trying to configure them for each individual account, you can define them once at the customer level, then specify in the account configuration that the value in the customer’s configuration be used. If you wish to change this value later, you need only modify it once for the change to be automatically propagated to all accounts.

 

For now you may leave these with their default values. If you change them later, these changes will automatically affect all accounts created under this customer.

 

2.     Click Save.

Create Accounts

Accounts enable the authorization of a customer’s actual end-points. In our example, we assume that the authorization is performed by the IP address of the remote gateway / proxy.

 

1.     On your customer’s panel, click Accounts.

2.     On the Create an account panel, fill in the account information:

·       ID – The IP address for the customer’s proxy or gateway (must be identical to the IP that is mentioned in the connection).

·       Account role – Select the IPv4 address from the list.

·       Product – Choose the main product that you would like your account to have.

·       Activation date – Choose the date from which the account is usable. By default, the account is activated immediately upon creation.

·       Type – Select Credit in this field.

·       Balance control – Choose Subordinate, since a credit limit is controlled at the customer level.

3.     Click Save.

 

Create an account

Service configuration

1.     On your account’s panel, click Services.

 

On this panel, you can activate / deactivate various features of the voice calls service provided to this account (e.g. assign a routing plan, etc.).

 

2.     Click Save.

Test Routing with Test Dialplan (optional)

You may check the routing for an SMS in your system prior to actually sending a message. The system will perform the HLR lookup and you will see the routing results based on the MCC / MNC codes for the destination number.

 

1.     In the Routing section of the Admin-Index page, choose Test Dialplan.

2.     Enter the destination phone number and service type.

3.     Select the HLR Lookup check box to enable HLR lookup.

4.     Click Search to display a list of applicable routes.

 

Test dialplan

 

Test the whole system

You can configure the SMPP client / gateway to send messages to your PortaSIP® server. To do this, use the PortaSIP’s virtual IP address and port for incoming SMPP connections (which is 2775 by default).

Since authorization is performed by the SMPP client / gateway IP address, you can set any values for the SMPP login and password. Then send a message.