This handbook demonstrates how to configure PortaBilling for integration with the partner platform by the example of EPC (Evolved Packet Core) by ZTE. PortaBilling supports ZTE provisioning of LTE/3G services to EPC and supports quota control for these services. Note that by combining the PortaBilling system with ZTE equipment, some of the possibilities are limited, e.g., only simple billing without real-time authorization is available; the service policy configuration (e.g., quota control, etc.) is defined on the ZTE side (which requires additional human and system resources), etc.
PortaBilling serves as the B/OSS system in this configuration. It manages customer data (including unified balance), service configuration details, product/rate tables, etc. PortaBilling allows ISPs to fine-tune a wide range of LTE features according to their business needs, and therefore it provides more flexibility and optimizes resources. Please refer to the LTE сonfiguration handbook to learn more about how to configure basic LTE service on the PortaBilling platform.
To proceed with the LTE configuration based on integration with ZTE, follow the steps described below. This handbook provides the settings required on the PortaBilling side only.
In this handbook, the following scenario is considered: the ISP provides 2 Gb of mobile Internet traffic for a $5 monthly fee. The Internet quota is defined on the ZTE side while end users are charged by PortaBilling.
Checklist
Use this checklist 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 should be checked), otherwise, the service will not work.
Operation | Done |
Enable the NetAccess service type on the Configuration server | |
Configure the Diameter (Gy) on the Configuration server | |
Create the LTE service | |
Create an empty customer tariff | |
Create an Internet access policy | |
Create a subscription plan | |
Create a product. Assign the created Internet access policy and subscription | |
Create a customer | |
Create an account for this customer. Assign the created product | |
Configure the ESPF event handler module |
Enable the NetAccess service type on the Configuration server
Enable the NetAccess service type as described in the LTE сonfiguration handbook.
Configure Diameter (Gy) settings on the Configuration server
These settings are necessary to allow the PortaBilling server and your gateway (router, modem) to exchange packages via the Diameter protocol. Refer to the LTE сonfiguration handbook for detailed instructions how to configure Diameter (Gy) module.
Create the LTE service
Services provide a way to define how charges are calculated (e.g., whether customers are charged based on the time they stay online or by the amount of data transferred) and how these are then presented on the invoices.
Create the LTE service. It will enable you to provision Internet services for your end users.
- On the navigation menu go to Service catalog and select Services.
- Open the Create service panel and fill in the required information:
- Name – a short descriptive name for this service that will be used in select menus and shown on the customer self-care pages. Type LTE into this field.
- Type – select Internet access.
- Rating base – select upload+download (kilobytes).
- Base unit – select kilobyte.
- Billing unit – select megabyte. This will be shown on statistics pages and on invoices.
- Base ratio – 1024.
- Usage charge – select Yes here.
- Click Save.
Create a customer tariff
According to the current business scenario, end users are charged via subscription plan. That is why real tariffs and rates are not required. Create an empty tariff to make it possible to create a product later on.
- On the navigation menu, select Service catalog and click Tariffs.
- On the Create tariff panel, fill in the tariff details:
- Name – type in a short name for the tariff object; this is the name you will see in the select menus.
- Currency – select the currency in which you will charge your customers.
- Service – select LTE from the list.
- Applied to – select Customer as this tariff will be used to charge your customers.
- Managed by – select Administrator only here.
- Click Save.
Create a service policy
A policy is a collection of rules and parameters that define how an end user is allowed to access the Internet service.
- On the navigation menu, select Service catalog and click Service policies.
- On the Create service policy panel, fill in the Service policy details:
- Name – define a name that matches the speed policy on the network side (e.g., ZTE Access Policy).
- Service type – select Internet access.
- Managed by – choose Administrator only here.
- Click Save.
- On the Access policy panel, mark the access types on the table and specify their download and upload rates. Please refer to the Broadband internet access services handbook for detailed information about how to configure access types.
- On the Attributes panel, select LTE ZTE EPC and configure the ZTE specific parameters:
- Profile – specify the service configuration value defined in HSS (Home Subscriber Server).
- Usertype – specify the rank of the end user as defined in RCP (Resource and Charging Control Platform). For example, user type 1 represents a gold subscriber; user type 2 represents a silver subscriber, and so on.
- PAKID – specify the package ID in ZTE SPR (Subscription Profile Repository). These packages are configured on the LTE side and define amount of Internet traffic, quality of service, bandwidth rules, access to sites, etc.
- Click Save.
Create a subscription
According to the current business scenario, end users are charged a defined monthly amount of money via subscription. To do this, create a new subscription plan.
- On the navigation menu, select Service catalog and click Subscription plans.
- On the Create subscription panel, fill in the required information:
- Name – name of the subscription plan that will be used on the Admin interface.
- Subscription name visible to end user – provide the name of the subscription plan that your customers will see on their self-care interfaces and invoices.
- Currency – indicates which currency is used for pricing information. A subscription plan can only be applied to a product, account or customer using this same currency. The currency for the subscription plan may only be chosen once and cannot be changed later.
- Managed by – select Administrator only.
- Subscription charges applied – select In advance, to apply subscription charges to the account/customer balance during the first days of the billing period.
- Periods in advance – specifies for how many periods advance charges should be made. Type in 1.
- Activation mode – defines when the subscription will be considered active (and charges will begin to apply): either simply from the date it is entered into the system, or you may postpone it until the date when the customer actually uses the account for the first time. Select Upon the account’s first usage.
- Activation fee – the value charged for every new subscription upon startup. Leave this field empty to waive the activation fee.
- Monthly fee – specify the fee value that will be applied to your customers every month.
- Can be applied more than once – select this checkbox to assign the same subscription multiple times to one account. You can only use this option when you are adding a new subscription plan. For new subscriptions, the Can be applied more than once option is off by default (so that subscription charges are not applied multiple times for the same account).
- Click Save.
Create a product
Accounts for specific products will be issued for accessing your Internet services.
- On the navigation menu, select Service catalog and click Products.
- 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.
- Name visible to end users – specify the name of this product that your customers will see on their self-care interface.
- Product type – select Main product here.
- Currency – choose a currency the product will be priced in.
- Managed by – select 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 access to and which actions they can perform.
- Account role – select Mobile to associate this product with mobile subscribers.
- Click Save.
Included services
Define which service types are included in the product. A service type is a description of the physical service provided to end users.
To add a service type:
- On your product’s panel, click Services.
- On the Services panel, click Add a service.
- In the Select services to add dialog box, select LTE and Mobile network provisioning, click Add.
Service configuration
Define the service attribute default values for all the accounts that this product will be assigned to. Assign to the product Internet access policy for ZTE.
- Go to the Internet access configuration page and configure the following:
Usage charges
The rating list has two functions: it defines permitted access points (nodes and access numbers) and specifies which tariff should be used for billing in each of these points.
- On your product’s panel, click Charges, then click Usage charges.
- On the Usage charges panel, click Add.
- Fill in the required information:
- Service – select LTE.
- Node – select LTE node.
- Access code – leave this field empty for the basic SIP service.
- Tariff – select the previously created ZTE tariff.
- Overdraft protection – to configure overdraft protection for this product, consult the Configure overdraft protection section within the product section in the Overdraft protection configuration handbook.
- Click Save.
Charges
On the Charges panel you can define regular payments such as subscriptions.
- To access this panel, click Charges on your product’s panel, then click General info.
Recurring charges
- Click the Save button to save the Product.
Enter SIM cards into the SIM card inventory
Refer to the Enter SIM cards into the SIM card inventory section of the MVNO service provisioning handbook to find out how to add SIM cards into the SIM card inventory.
Create a customer
A customer is an owner of accounts. Customer contact information is used for distributing account usage information, Internet access statistics, invoices, etc. You usually need to create one customer per each retail prepaid ZTE user.
- On the navigation menu, select Sales, then select Customers.
- 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.
- Balance control – select Prepaid in this field.
- Currency – choose the currency in which this customer will be billed.
- Available funds – the amount of funds available for the customer to spend on services.
- Business model – a business model defines what type of service is to be provided to the customer. Select Mobile for this customer.
- Customer class – customer class allows you to define a policy for automated payment collection. By choosing a specific class here the customer will automatically inherit all of the class properties (grace period, invoice template, etc.). Select the previously created customer class.
- 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.
- Click Save.
Create an account
You need to create an account for each device that has a unique SIM card.
- On your customer’s panel, click Accounts.
- On the Create an account panel, specify the account’s details:
- ID – the ID to be used to authorize Internet access. You can type in the user’s phone number manually or provision it from the DID inventory.
- Account role – select Mobile.
- IMSI – click on the IMSI icon
and select one of the available SIM cards from the SIM Card Inventory dialog box.
- Product – select the ZTE Product here.
- Activation date – the date from which the account is usable.
- Type – select Credit for your postpaid Internet users.
- Balance control – select Subordinate from the list.
- Click Save to create an account.
Enable the ESPF event handler module
ESPF (External Systems Provisioning Framework) is the event handler framework for provisioning service configuration and for account management operations done in PortaBilling to the mobile carrier’s core.
It consists of events that are processed by handlers – special Perl modules. The events processing results are sent to the carrier’s core. You can configure ESPF event handler module according to the requirements of your business model independently.
To enable the ESPF event handler on the PortaBilling web interface, complete the following steps:
- On the PortaBilling web interface, go to Infrastructure and select Event handlers.
- Open the Create event handler tab and fill in the details:
- Name – type the event handler name, e.g., “AricentHSS”.
- Type – select AricentHSS.
- Leave the Enabled toggle on to create an active handler.
- Click Save.
- Open the created event handler, go to Configuration and turn on the Aricent.Enabled toggle.
- Click Save.
When a PortaBilling administrator makes changes for an account (creating, blocking, changing product/Internet access policy, etc.), PortaBilling immediately provisions updated data to the ZTE HSS (Home Subscriber Server) or ZTE SPR (Subscription Profile Repository). HSS then provides centralized user authentication across the network and SPR manages users’ service policies. This way, user data is always up-to-date in ZTE.