How to…

Link copied to clipboard

…Configure data provisioning to NetNumber

Link copied to clipboard

North American MVNOs use the NetNumber database for accurate SMS and MMS routing. This entails storing their DIDs in NetNumber and keeping them up-to-date.

This section shows how to configure integration with NetNumber within PortaBilling.

Before configuring the provisioning to NetNumber, make sure that all preliminary procedures with NetNumber Inc. have been completed. In particular, sign the contract and request the data necessary for integration with PortaBilling.

This section assumes that you have already configured your installation according to the instructions provided in the MVNO Service Provisioning handbook.

Configure provisioning on the Configuration server

Link copied to clipboard
  1. Go to the Configuration server and clone the configuration.
  2. Select PortaSwitch on the Configuration Tree, then select NumberPorting.
  3. Enable number porting functionality by selecting Yes:

    Enable number porting

  4. Select the NumberPorting_NetNumber group and fill in the following fields:
    • Enabled – select Yes.
    • NNID – specify your ID number provided by NetNumber.
    • SFTP_auth_file – provide the path to the NetNumber SFTP authorization file.
    • SFTP_directory – specify your remote directory on the NetNumber server.
    • SFTP_password – specify the NetNumber SFTP server password.
    • SFTP_server – specify the NetNumber SFTP server IP address or its domain name.
    • SFTP_username – specify the username information for the NetNumber SFTP server.
    • Transfer_period – specify the frequency of data transfer (in minutes).

      Configure number porting for NetNumber

  5. Click the Save button first, then the Check button.
  6. Verify the new configuration and click the Check/Apply button.

Enable events for ESPF (External system provisioning framework)

Link copied to clipboard
  1. Open the system console and connect to the PortaBilling web server.
  2. Type in the following commands to:
    • Enable the corresponding handler:
      > /home/provisioning-framework/utils/ handler enable NetNumber
    • Enable the required events:
      > /home/provisioning-framework/utils/ type enable Account/New
      > /home/provisioning-framework/utils/ type enable Account/Status/Closed
    • Subscribe the handler to the events:
      > /home/provisioning-framework/utils/ handler sub NetNumber Account/New
      > /home/provisioning-framework/utils/ handler sub NetNumber Account/Status/Closed

      or to all allowed events

      > /home/provisioning-framework/utils/ handler sub NetNumber all
    • Check the matrix to see the handler’s subscription:
      > /home/provisioning-framework/utils/ matrix
  3. Save the changes.

…Generate mobile accounts in bulk for SIM cards distribution

Link copied to clipboard

“Prepaid starter packs” are often printed to distribute SIM cards. They contain a combination of a mobile number (MSISDN) and a SIM card number (IMSI). When you need to prepare data for “Prepaid starter packs,” generate a batch of mobile accounts via the Account generator. Each account in a given batch is assigned a combination of MSISDN and IMSI from the corresponding inventory. Mobile accounts are initially generated as inactive to prevent misuse of SIM cards if they are stolen or lost (and later recovered by a third party).

 You can assign a batch of accounts to a specific distributor before generation. The distributor sells SIM cards and activates the corresponding accounts via the web self-care interface. After purchase, the prepaid SIM cards can be used right away.

Let’s say distributor John Smith wants to sell SIM cards in his grocery store.  You need to provide John with 100 $10 SIM cards (“Prepaid starter packs”). To do this, create a batch of 100 inactive debit accounts with a $10 initial balance each and assign this batch to the distributor.

Note that mobile numbers (MSISDN) and SIM cards (IMSI) must be previously uploaded to the DID/MSISDN and SIM card inventories. Refer to handbook sections Managing Available Phone Numbers (DID Inventory) and Enter SIM cards into the SIM card inventory to upload this data to PortaBilling.

To generate mobile accounts, follow these steps:

  1. Create a customer – create a customer as an account holder to keep accounts organized in one location.
  2. On the customer’s panel, click Accounts.
  3. On the Create an account panel, click Account generator.
  4. In the Account generation dialog, fill in the information about accounts.

    Initial configuration

    Link copied to clipboard
    • Account role – select Mobile.
    • Type – select Debit.
      Only debit accounts can be generated as inactive and assigned to a distributor.
    • Product – select the product for the mobile services created.
    • Quantity – set the number of accounts (SIM cards) to be generated.
    • Batch – select a batch for the accounts generated. This batch includes accounts grouped together according to some criteria. If Add a new batch is selected, the generated accounts are placed in a new batch. Otherwise, an existing batch is selected from the drop-down list.
    • New batch name – type a name for the new batch.

      Generate mobile accounts using the Account generator: the Initial configuration

    Optional configuration

    Link copied to clipboard
    • Opening balance – this is the initial balance available on the account. Type ‘10’ here to create accounts with a $10 balance each.
    • Requires manual activation – switch on the Requires manual activation toggle switch to create inactive accounts. Since these accounts have an available initial balance, it’s safer to generate them as inactive, so that corresponding SIM cards can’t be misused before they are sold. Either the whole batch or an individual account can always be activated later.
    • Generation method – by default, each account in a batch is assigned a mobile number (MSISDN) and a SIM card (IMSI) from the corresponding inventory.
    • Pricing batch – select the pricing batch to take MSISDN numbers from the DID/MSISDN inventory.
    • Use MSISDN from – here define where PortaBilling retrieves the MSISDN numbers from. The MSISDN inventory option means that the accounts are generated with available MSISDNs. If there are reserved MSISDNs for the customer, select The assigned to Customers option.
    • Assign MSISDN sequentially starting with – the default option is The first one available, but choose a specific starting number for the consecutive range of MSISDN numbers assigned to accounts generated.
    • Assign IMSI sequentially starting with – the default option is The first one available, but choose a specific starting number for the consecutive range of SIM cards (IMSI) assigned to the accounts generated.
    • Service password – choose Empty for mobile accounts.
    • Distributor – assign this batch of accounts to the distributor who has been provided with SIM cards.

      Generate mobile accounts using the Account generator: the Optional configuration

      Generate mobile accounts using the Account generator: complete the Optional configuration

  5. Click Generate.

Once the account generation task is completed, 100 inactive $10 accounts are visible in the customer’s Account list.

The list of generated mobile accounts

Upon account generation and if PortaBilling is already integrated with the mobile carrier’s core, SIM cards are automatically provisioned to the host mobile network (i.e., HSS and/or PCRF).

The new accounts are available on the distributor’s web self-care interface and are ready to be sold.

The distributor’s commission for activation and further account topup per SIM card is automatically reflected in PortaBilling. Refer to the Configuring a Distributor for Prepaid Services handbook for more details.

Distributor's balance on the web self-care interface

On this page

What's new
Admin manuals
UI help
Back to main menu