Release

Search

Setting up real-time billing for roaming services

Link copied to clipboard

To stay competitive in the market, CSPs must ensure that customers enjoy services both on their home network and while visiting other countries. Roaming charges are higher than domestic ones; therefore, real-time billing for service usage is crucial, as it prevents customers from overspending.

PortaBilling supports real-time billing for services used in roaming. To bill for data usage, PortaBilling selects a tariff rate based on the MCC-MNC codes that identify the subscriber’s visiting network. Note that the ASN-GW must send the 3GPP-SGSN-MCC-MNC attribute in Diameter (Gy) requests.

To bill for voice calls and SMSs, PortaBilling uses the identification of the roaming zone and visiting network to match the correct tariff in the product and calculate the charges. This billing model is supported with the third-party CAMEL gateway and the third-party SMSC, respectively.

To grant access to users for the services you must first provision their data to the mobile core. Thus, depending on what mobile core equipment you have or have access to (HLR/HSS, PCRF, etc.), you must configure them and then configure data provisioning in PortaBilling. The HSS, PCRF configuration is out of the scope of this document since it depends on which equipment you have.

This chapter demonstrates how to set up real-time billing for roaming services.

Scenario

Link copied to clipboard

An MVNO operates in the UK on a 4G network. They have roaming agreements with mobile carriers in the US, Canada and Australia. The US and Canada belong to roaming zone 1. Australia belongs to roaming zone 2.

The MVNO’s roaming service bundle includes voice calls, SMS and Internet services charged as follows:

From

Home network

Zone 1

Zone 2

To

Home network

0.03

0.2

0.4

Zone 1

0.2

0.6

0.95

Zone 2

0.35

1.0

0.8

Incoming calls from

0

0.5

0.7

SMS

0.05

0.3

0.5

Internet access

0.1

0.5

0.7

Preliminary Configuration

Link copied to clipboard

In this handbook, we assume that you already configured your mobile service provisioning with real-time user authorization on your home network. Please refer to the Voice calls service configuration for MVNO handbook for detailed information about how to configure and provide voice calls, SMS and Internet access services in the home network.

Checklist

Link copied to clipboard
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.

General configuration

Link copied to clipboard

 Operation

 Done

Configure the Diameter module on the Configuration server.

Enable the RoamingAccessCode module on the Configuration server.

Create the custom services with the Messaging service type. These are used to separate xDRs for SMSs per roaming zone.

Create the custom services with the Voice calls service type. These are used to separate xDRs for calls per roaming zone.

Create the destination group set “Roaming Zones.”

Create destination groups that represent roaming zones.

Add destinations to the destination groups according to the zones where they belong.

Roaming voice calls service configuration

Link copied to clipboard

 Operation

 Done

Rating configuration (Customer)

 

Create tariffs for every Voice calls custom service type that applies to customers for outgoing calls in roaming networks. Upload rates provided by your roaming partners to the respective tariffs provided by your roaming partners.

Create tariffs for every Voice calls custom service type that applies to customers for receiving incoming calls in roaming networks. Upload the rates to the respective tariffs.

Roaming Internet access service configuration

Link copied to clipboard

 Operation

 Done

Rating configuration (Customer)

 

Create a tariff for the LTE that applies to customers for data transfer sessions.

Upload the E.212 destinations rates to this tariff.

Enter the rate for the NETACCESS destination to this tariff to charge for home services.

Create the Internet access policy.

Roaming SMS service configuration

Link copied to clipboard

 Operation

 Done

Rating configuration (Customer)

Create roaming tariffs for the Messaging service type custom services. They are used to calculate charges for SMSs sent from roaming networks.

Enter rates to the tariffs.

Product configuration

Link copied to clipboard

 Operation

 Done

Create the bundled product and include LTE, Messaging and Voice calls services plus custom services for SMS and Voice call service types. Enable the Mobile network provisioning service in the product to trigger data provisioning.

Assign the Internet access policy to the product.

Create rating entries for the Voice calls service to calculate charges for outgoing and incoming calls made in the home network. Specify the standard access codes OUTGOING and INCOMING.

Create a rating entry for each of the Voice calls service type custom services used to calculate charges for outgoing calls. Specify the access code in the format OUTGOING.<destination_group_name> and assign a corresponding roaming tariff.

Create a rating entry for each custom service of the Voice calls service type that is used to calculate charges for incoming calls. Specify the access code in the format INCOMING.<destination_group_name> and assign a corresponding roaming tariff.

Create a rating entry for the LTE service and assign the corresponding roaming tariff to it.

Create a rating entry for the Messaging service with the node you created. Specify the destination group name Zone0 as the access code and associate the corresponding tariff to it.

Create rating entries for each custom service of the Messaging service type. Specify the destination group name as the access code and assign the corresponding roaming tariffs.

Account provisioning

Link copied to clipboard

 Operation

 Done

Create a customer class.

Create a customer

Create accounts for the customer.

General configuration

Link copied to clipboard

Configure Diameter module on the Configuration server

Link copied to clipboard

PortaBilling communicates with the mobile core via the Diameter protocol. Therefore, you must set up the Diameter module in PortaBilling.

  1. On the Configuration server web interface, clone the currently active configuration.
  2. From the configuration tree, select BillingEngine -> Diameter and configure the following parameters:
    • Enabled – select Yes.
    • Origin_Host – specify the domain name of your billing node (recommended format: hostname.domainname). This is used to identify the node in data communications.
    • Origin_Realm – specify your billing node realm.

      Enable Diameter

  3. Select BillingEngine> NetAccess and configure the following parameters:
    • RateMatchWithE212 – select Yes. This is required to calculate charges based on the E.212 rate pattern. Enable the NetAcces service
  4. To identify users’ roaming zones, select BillingEngine -> Custom and enter the following string in the LoadModules option:
     roamingzone=Porta::Extra::RoamingAccessCode

    Enable roaming zone matching

  5. Click Save.
  6. Click Save and then Verify.
  7. Verify the new configuration and click Check/Apply to apply it.
    Note that the RADIUS service needs to be reloaded, so for best results, apply the configuration during an off-peak time.

 

Create services

Link copied to clipboard

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 invoices.

Create custom services for voice calls

Link copied to clipboard

To present xDRs for voice calls grouped per roaming zone and present them on customer invoices and in the xDR history separately, create a custom Voice calls service type for each roaming zone.

  1. From the navigation tree, select Service catalog -> Services.
  2. Switch to Create panel and fill in the Create service details:
    • Name – give a name to your service. E.g., Calls.US&Canada.
    • Type – select Voice calls from the list.
    • Other fields are pre-populated. You may leave them as they are.
    • Click Save.

      Custom service for calls

  3. Repeat step 2 and create another service to group calls made/received while roaming in Australia.

    Custom service list

Create the LTE service

Link copied to clipboard

To provide Internet access on the LTE network you must create the LTE service. Complete the Create the LTE service step from the LTE configuration handbook.

Create custom services for SMS

Link copied to clipboard

To group xDRs for SMSs per roaming zone where the service is used and present them on invoices and in the xDR history, create a separate service for each roaming zone with the Messaging service service type.

  1. From the navigation tree, select Service catalog -> Services.
  2. Switch to Create panel and fill in the Create service details:
    • Name – give a name to your service. E.g., SMS.US&Canada.
    • Type – select the Messaging service from the list.
    • Other fields are pre-populated. You may leave them as they are.
    • Click Save.

      Custom SMS service

  3. Repeat step 2 and create another service to group xDRs sent from Australia.

    SMS service list

Create the destination group set

Link copied to clipboard

To bill users for roaming calls and SMSs, PortaBilling must identify the user’s network and roaming zone it belongs to. For this purpose, it looks up the number of application server (for voice calls) or the serving SMSC (for SMS) among the destination groups in the “Roaming Zone” destination group set. The matched destination group serves to identify the user’s roaming zone and to match the appropriate roaming tariff.

To identify the roaming zones, the phone numbers of serving (visited) networks should be in E.164 format. Find more about the mapping of roaming zones in the Online charging for roaming services chapter.

At this step you must create the “Roaming Zone” destination group set and the destinations groups for each roaming zone under it. In our example, there are two destination groups:

  • Zone1 – for US and Canadian destinations;
  • Zone2 – for Australian destinations.

Create the “Roaming Zone” destination group set and create the required number of destination groups under it as described in the Create a destination group set and Define a destination group steps in the Creating a service with volume discount plans handbook.

Roaming zones destination group set

Assign destinations to destination groups

Link copied to clipboard

Now you add destinations to their corresponding destination groups.

Assign destinations manually

Link copied to clipboard
  1. On the Destination group list panel, click All destinations.
  2. Filter destinations using one or several search filters.
  3. Select the destinations you want to include in the destination group and click Assign group.
  4. Select the destination group (e.g., Zone1 for the US and Canadian destinations) and click Assign.

    Assign prefixes

  5. Repeat steps 1-4 to assign Australian destinations to the Zone2 destination group.

Upload destinations from a file

Link copied to clipboard

Alternatively, you can upload destinations to destination groups from a file.

  1. Prepare the file for upload. The file structure must be the following:

    Field

    Description

    Action

    Add or delete; encoded as ‘+’ and ‘-‘ or ‘add’ and ‘remove.’

    Dest_Group_Name

    The name of the destination group which the prefix will be added to or removed from.

    Prefix

    The destination prefix to add to or remove from the destination group.

    Upload prefixes to roaming rozes

    Column headers are important! Make sure the field names and formatting in your upload file are correct.
  2. On the Destination group sets page, in the toolbar, click Upload.
  3. In the Upload destination groups dialog window select the destination group set where to upload destinations to and either drag your file or define the path to it by clicking the Browse button.
  4. Click Upload.

    Upload prefixes

Roaming voice calls configuration

Link copied to clipboard

Create tariffs for end users

Link copied to clipboard

We assume that you have already configured “home” tariffs with domestic rates for outgoing and incoming calls. At this step, you create tariffs to charge customers for making and receiving calls while roaming. Since charges differ for every roaming zone, create separate tariffs for service usage in the US&Canada and in Australia. To separate xDRs per roaming zone and show them on invoices and in the xDR history as grouped, create roaming tariffs for the corresponding custom services – Calls.US&Canada and Calls.Australia, respectively.

Thus, your roaming tariff list for end users looks like this:

  • A tariff to charge for outgoing calls made from the US&Canada;
  • A tariff to charge for incoming calls received in the US&Canada;
  • A tariff to charge for outgoing calls made from Australia;
  • A tariff to charge for incoming calls made from Australia.
  1. From the navigation menu, select Service catalog, then Tariffs.
  2. On the Create panel fill in the Create tariff form:
    • Name – a short name for the tariff object; this is the name you see in select menus.
    • Currency – indicates the currency in which the vendor charges you.
    • Service – select Calls.US&Canada here.
    • Applied to – select Customer, as this tariff is used to charge your customers.
    • Managed by – select Administrator only, since we are setting up a service without the involvement of resellers.

      Create a tariff

  3. Click Save. The tariff page opens.

Enter rates

Link copied to clipboard

In this example, we show how to manually add rates. In case of entering a large number of rates, use the Rate Upload tool. Please refer to the Rate import handbook for guidelines.

  1. While on the tariff page, click Rates.
  2. On the Add rate panel, fill in new rate information:
    • Destination – start typing the destination prefix, e.g., 44 for the UK.
    • First price – specify the price for this destination (e.g., $0.02 / min).
    •  Click Save.

      Add rates

  3. Repeat step 5 to add more rates.
  4. Repeat steps 1-6 to create a tariff to charge for incoming calls received while a user roams in the US and Canada.

    Incoming calls tariff

  5. Repeat steps 1-7 and create tariffs to charge customers for making and receiving calls while they roam in Australia. Select the corresponding service you created (Calls.Australia in our example) during tariffs creation.

    Roaming tariff list

Roaming Internet service configuration

Link copied to clipboard

Create tariff for end users

Link copied to clipboard

Now you create the tariff with the charges you apply to customers for using LTE services while roaming.

  1. On the navigation menu on the left, select Service catalog and click Tariffs.
  2. Switch to the Create tariff panel and specify the information about a new tariff:
    • Name – a short name for the tariff object; this is the name you see in select menus.
    • Currency – choose the currency in which you charge customers.
    • Service – select the LTE service.
    • Applied to – choose Customer.

      Roaming LTE tariff

  3. Click Save. The tariff page opens.
  4. Go to the Rates panel.
  5. Add the rate for the NETACCESS destination to charge users for Internet usage in the home network. On the Add rate panel, enter the following:
    • Rate code – type NETACCESS.
    • Unit price – price for interval per billing unit (in this example, per megabyte). Enter $0.1.
  6. Click Save.

Upload rates for E.212 destinations

Link copied to clipboard
  1. Prepare the file for upload. The file structure must correspond to the table below:

    Field

    Description

    Destination

    The destination in the E212-MCC-MNC format.

    If you want to add a rate for the Default destination, specify it in the E212-MCC format.

    Country

    The country to which the destination belongs.

    Destination description

    The short description for the destination (e.g., area).

    Price

    The unit price.

    Upload rate

  2. On the Rates panel in your tariff, click Upload.
  3. Follow the rate upload wizard steps as described in the Rate import handbook and complete the rate upload. The result of the rate upload looks like the following:

    Rate list

Create a service policy

Link copied to clipboard

A service policy is a set of parameters that defines user access to the network. It also contains configuration attributes required to provision the NAS you use in your network infrastructure.

To apply a service policy to the user, configure it in the PCRF with the required parameters (e.g., QoS, speed limits, etc.). Then configure the service policy in PortaBilling and assign it to the user’s account. The service policy name must be the same in both systems. You also configure the user’s profile in the HSS that is used to activate their SIM and therefore provide them network access.

When PortaBilling provisions user data to the HSS and PCRF, the user is granted access to the network according to the service policy.

At this step, we show the configuration of the service policy for Internet access and the provisioning of the Protei HSS and PCRF.

  1. On the navigation menu, select Service catalog -> Service policies.
  2. On the Create service policy panel, fill in the service policy details:
    • Name – specify the service policy name. It must be the same as the service policy you configured in the PCRF.
    • Service type – select Internet access.
    • Managed by – choose Administrator only here.

      Access policy

  3. Click Save.
  4. On the Attributes tab, specify the Protei configuration attributes:
    • gprs_package – the code of the GPRS package configured in Protei PCRF.
    • hlr_profile – the user’s profile ID configured in Protei HLR.
  5. On the Hotlining tab define on what condition the user is redirected to the captive portal and provide the captive portal’s URL.
  6. Click Save.

Roaming SMS service configuration

Link copied to clipboard

Create tariffs for end users

Link copied to clipboard

At this step, you must create two tariffs to charge users for sending SMSs:

  • From the US & Canada;
  • From Australia.

To separate xDRs per roaming zone and show them on invoices and in the xDR history as grouped, create the roaming tariffs for the corresponding custom services – SMS.US&Canada and SMS.Australia, respectively.

  1. On the navigation menu on the left, select Service catalog and click Tariffs.
  2. Switch to the Create tariff panel and specify information about the new tariff:
    • Name – a short name for the tariff object (e.g., Vendor LTE home); this is the name you see in select menus.
    • Currency – choose the currency in which you charge customers.
    • Service – select the Messaging service.
    • Applied to – choose Customer.
  3. Click Save. The tariff page opens.
  4. Upload rates to the tariff following the instructions from the Rate import handbook.

    Tariff for domestic SMS

  5. Repeat steps 1-4 and create the roaming tariffs for SMSs sent from the US and Canada for their respective services.

    Tariff for roaming SMS from Zone1

    Likewise, create a roaming tariff for SMS services sent from Australia.

    Roaming SMS from Zone2

Product configuration

Link copied to clipboard

Create a bundled product

Link copied to clipboard

End users use accounts issued for specific products to access the services you provide. Products are powerful tools that define different ways for billing an account for one or several included services. Product definition is always realized through these steps: product definition, service definition and configuration, and creating a rating list.

When a user makes a call or sends an SMS from abroad, PortaBilling looks up the prefix of the country where the user is roaming in the Roaming Zones destination group set. The destination group serves to identify the user’s roaming zone. This destination group name must match the access code defined for the usage charges record in the product configuration. Thus, PortaBilling uses this name to select the roaming tariff and charge the subscriber.

  1. On the navigation menu on the left, select Service catalog -> Products.
  2. On the Create product panel fill in the new product details:
    • Name – type in the internal name of the product.
    • Name visible to end-users – specify the name of the product that your customers see on their self-care interface.
    • Product type – select Main product here.
    • Currency – specify the currency used for the product; only tariffs sharing the same currency are permitted in the rating list.
    • Managed by – select Administrator only here, since a service is being set up without the involvement of resellers.
    • Account role – select Mobile from the list, since this product is intended for use by mobile subscribers.
    • Realm – in order to differentiate products for mobile services from other products, they are created by default with a @msisdn realm. You may further distinguish them by defining a subrealm. Leave this field empty.

      Add a product

  3. Click Save. The product page opens.

Services

Link copied to clipboard
  1. Go to the Services panel and click Add a service.
  2. Select the Voice calls, Calls.US&Canada, Calls.Australia, LTE, Messaging services, Mobile network provisioning, SMS.US&Canada and SMS.Australia services from the Select services to add list and click Add.

    Included services list

  3. Select the Internet access service type to open its configuration panel.
  4. Enable the Access policy toggle and select the Internet access policy you created earlier.

    Assign service policy

Usage charges

Link copied to clipboard

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

Add usage charges records for each service you provide.

Add usage charges for the LTE service
Link copied to clipboard
  1. Click Charges -> Usage charges and click Add to add a new rating record.
  2. Сonfigure the rating entry for the LTE service:
    • Service – select LTE.
    • Node – select the LTE node here.
    • Access code – leave this field blank.
    • Tariff – select your roaming LTE tariff.
    • Click Save.

      Define charges for LTE

Add usage charges for SMS services
Link copied to clipboard
  1. Click Add and configure the rating entry for the SMS services:
    • Service – select SMS.US&Canada.
    • Node – select the SMS node here.
    • Access code – specify Zone1 here. This is the name of the destination group that US and Canadian destinations belong to.
    • Tariff – select your roaming tariff for SMS services used in the US & Canada.
    • Click Save.

      Define charges for SMS from US

  2. Repeat step 10 to add a rating entry for the SMS sent from Australia.

    Charges for SMS from AU

  3. Click Add and configure the rating entry for the home SMS service:
    • Service – select Messaging service.
    • Node – select the SMS node here.
    • Access code – leave it empty. Home SMSs are charged using the standard SMPP access code.
    • Tariff – select your tariff for SMS services used in the home network.
    • Click Save.

      Home SMS charges

Add usage charges for voice calls
Link copied to clipboard
  1. Click Add to add a rating entry for outgoing calls made in the US and Canada:
    • Service – select Calls.US&Canada.
    • Node – select the node here.
    • Access code – specify OUTGOING.Zone1 here.
    • Tariff – select your roaming tariff for outgoing calls used in the US & Canada.
    • Click Save.

      Charges for outgoing calls from US

  2. Repeat step 13 to add a rating entry for incoming calls received in the US and Canada and specify INCOMING.Zone1 as the access code.

    Charges for incoming calls from US

  3. Click Add to add a rating entry for outgoing calls made from Australia:
    • Service – select Calls.Australia.
    • Node – select the node here.
    • Access code – specify OUTGOING.Zone2 here.
    • Tariff – select your roaming tariff for outgoing calls used in Australia.
    • Click Save.
  4. Repeat step 15 to add a rating entry for incoming calls received while roaming in Australia and specify INCOMING.Zone2 as the access code.

    Charges for calls from Australia

  5. Likewise, create rating entries to charge for the Voice calls service used in the home network. Select Voice calls from the Service list and specify OUTGOING and INCOMING as access codes for the corresponding rating entries.

    Charges for home calls

  6. Click Save on the toolbar.

Account provisioning

Link copied to clipboard

Create a customer class

Link copied to clipboard

Please refer to the Create a customer class step in the Real-time user authorization and charging for wireless operators handbook to create a customer class for your mobile subscribers.

Create a customer

Link copied to clipboard

A customer is an owner of accounts. Use the customer’s contact information to distribute account usage information, call statistics, invoices, etc.

  1. On the navigation menu, select Sales -> Customers.
  2. On the Create customer panel specify their main information:
    • Name – short name for the customer object used on the web interface.
    • Balance control – specify the way the customer pays for the service: Select Postpaid in this field.
    • Currency – the currency in which this customer is billed. This is defined by the customer class selected.
    • Credit limit – specify the credit limit for the customer.
    • Business model – select Mobile from the list.
    • Customer class – select the previously created customer class.
    • Billing period – frequency of invoice generation. For more details about different available billing periods, see the PortaBilling Administrator Guide.
    • Billing period time zone – this is the time zone in which a customer’s billing period is closed and invoices generated.

      Add a customer

  3. Click Save.
  4. Follow the instructions in the Real-time user authorization and charging for wireless operators handbook and define other customer-related information like address, contact information, web self-care credentials, etc.

Create accounts

Link copied to clipboard
  1. While on the customer page, go to the Accounts panel.
  2. On the Create account panel, fill in the new account details:
    • ID – click the DID icon next to the ID field.
    • Select the unallocated option, specify the DID number search filters in the dialog box and click Next.

      Assign DID

      Add an account

    • Select the number to assign to the customer and click Assign.
  3. IMSI – click the SIM card icon and specify the SIM card search filters. Click Continue.

    Add SIM card

  4. Select the SIM card and click Assign.
  5. Product – select the product you created.

    Account configuration

  6. Click Save.

On this page

Release
What's new
Admin manuals
Handbooks
API
UI help
Search