Selling manually-configured DIDs via a shared pool

Link copied to clipboard

With PortaSwitch, you can become an active player in the wholesale DID market by granting other service providers access to your DID inventory and enabling them to provision DIDs on-demand. In addition, if you provide hosting services to your customers (i.e., a customer operates in a separate billing environment), you can distribute the pool of DIDs across your own billing environments. Thereby you extend your clientele and become a wholesale DID provider.

This chapter provides you with instructions for how to configure a wholesale DID exchange in PortaSwitch.

If you wish to buy DID numbers from another PortaSwitch owner and provision them on-demand, please refer to the On-demand DID provisioning from another PortaSwitch handbook.

Example 1. DID provisioning to PortaSwitch owners

Link copied to clipboard

As a configuration example, let us take the following basic scenario:

Your company, EasyDIDs, owns a pool of 10M DID numbers. Your wholesale partner, FastNet, is also a PortaSwitch owner. FastNet plans to introduce residential services in their system and thus require DID numbers.

You configure access to your DID pool for on-demand DID provisioning and charge FastNet per DID number as follows:

  • $2 activation fee;
  • $5 monthly recurring fee.


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.

The checklist below assumes that you have already configured the routing between your system and that of your DID buyers according to the instructions provided in the previous chapters.



Make sure you have configured the routing to the DID buyer’s system as described in the Basic Residential VoIP Service handbook (your DID buyer operates as a vendor)

Rating configuration

Upload DID numbers to DID inventory

Release DID numbers to the DID pool

Create a pricing DID batch and define the DID markup within

Create a DID provisioning customer and define their web self-care credentials

Assign the pricing DID batch to this customer

Upload DID numbers to the DID inventory

Link copied to clipboard

Please refer to the Managing DIDs for customers manually (DID inventory) handbook for instructions on how to upload DID numbers.

Release DID numbers to the DID pool

Link copied to clipboard

To use the DID numbers, release them to the DID pool.

  1. On the navigation menu, select Infrastructure, then select Inventory and click DID inventory.
  2. On the DID inventory page, go to DID numbers list.

    DID inventory page

  3. On the DID number search panel, select the specific vendor batch from the Vendor batch list and click Apply filters.

    Check the search result

  4. Select the appropriate DIDs and click Manage.
  5. In the Select operations to apply to the selected DIDs dialog page, select Pool management, then select Release DIDs to the pool.

    Release DIDs to the pool

  6. Click Ok. On the refreshed page you will see that the DID numbers have now been unfrozen and released to the DID pool.

    Check the DID status

Create a pricing DID batch

Link copied to clipboard

The pricing DID batch is a storage area for DID numbers that can be used for a particular purpose (e.g., to be provisioned to end users). Pricing batches allow you to apply additional charges for using DID numbers.

At this point create a pricing batch with a DID markup.

  1. On the DID inventory panel, select Pricing batches.
  2. On the Create a pricing batch panel, fill in the pricing batch details:
    • Name – type a pricing batch name.
    • Applied to – select Customer.
    • Type of DIDs – select Inventoried as the batch contains DID numbers previously uploaded to the DID inventory.
    • Pricing – select Fee-paying.
    • Pricing parameters:
      • Currency – choose the currency used to charge for DID usage.
      • Additional activation fee – type in 2 here.
      • Additional recurring fee – type in 5 here.
      • Recurring fee markup – specify a markup that will be included in the recurring amount charged to the customer in addition to the actual DID cost (charged by a DID vendor).
      • Decimal places, number – specify the rounding pattern to obtain “marketable” figures. This will specify the last “pre-set” digits in the figure.

      Create a pricing batch

  3. Click Save.

Create a customer

Link copied to clipboard

To enable your DID buyers to access your DID inventory and provision the numbers, you need to create a DID provisioning customer. This acts as a placeholder for all provisioned DID numbers and allows you to control the billing for their usage.

  1. On the navigation menu, select Sales, then select Customers.
  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.
    • Balance control – specify the way the customer will pay for the service. Choose Postpaid in this field.
    • Currency – choose the currency in which this customer will be billed.
    • Credit limit – assign a credit limit for the customer.
    • Business model ­– a business model defines what type of service is to be provided to the customer. Select Universal here.
    • Customer class – select Default 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.

      Create a customer

  3. Click Save.

Assign the pricing DID batch to the customer

Link copied to clipboard

To control charges for provisioned DID numbers, assign the pricing DID batch to your DID provisioning customer.

  1. On your customer’s panel, select Personal, then select General info.
  2. On the Personal info panel, select Additional info.

    Assign the pricing DID batch to the customer

  3. On the Additional info panel, select a previously created pricing batch in the Auto-provision DIDs via batch list.
  4. Click Save.

The configuration is finished. Now provide your DID buyer with the DID provisioning customer’s web self-care credentials. As soon as a DID number is provisioned from your DID inventory, it will have the In use status.

Example 2. Distributing DID numbers across billing environments

Link copied to clipboard

If you provide hosting services to your customers (i.e., a customer operates in a separate billing environment), you can distribute the pool of DIDs across your own billing environments and allow customers to provision them on-demand. When a call is made to the DID number, PortaSwitch detects the billing environment where it is provisioned as an account and delivers the call to the callee.

To configure DID distribution across billing environments follow these steps:

Configure the PortaSIP dispatching SBC on the Configuration server

Link copied to clipboard

To enable PortaSwitch to detect a billing environment for an incoming call, it is necessary to configure the PortaSIP dispatching SBC.

For normal operation, the PortaSIP dispatching SBC must be deployed on a separate physical server located at a separate site. For testing purposes, however, you can deploy it on one of your SIP servers within the existing site. For either type of deployment, assign the virtual IP address to the PortaSIP dispatching SBC as the visible point of entry to your network.

  1. Clone the currently active configuration.
  2. From the Configuration Tree, select ClusterSuite > PortaSIP Cluster.
  3. Select the sip-cluster that you use to distribute the pool of DIDs.
  4. Select the DispatchingSBC group.
  5. In the vipaddr field specify the virtual IP address of your PortaSIP Dispatching SBC. Since it is the point of entry to your network, the virtual IP address must be public.
    Important! The PortaSIP dispatching SBC virtual IP address must not be defined as the service IP for any instances and must also not coincide with the PortaSIP cluster virtual IP address.

    Specify vipaddr

  6. Click the Instance create button.
  7. Select the DispatchingSBC instance type.

    Instance create

  8. Select the SIP server where the PortaSIP dispatching SBC instance and its service IP will reside. Click Save.
  9. Select the ForwardingRegistry group.
  10. From the domestic_forwarding_list list select the billing environment(s) from where customers will provision the DID numbers.

    List of allowed environments

  11. Click the Save button to save the configuration and then the Verify button.
  12. Verify the new configuration and click Check/Apply to apply it.
Note that the Apache service will need to be restarted, therefore apply the configuration during off-peak times.

Complete steps described in Example 1 to grant customers access to your DID inventory for on-demand DID provisioning. Then on another environment configure the on-demand DID provisioning as described in the On-demand DID provisioning from another PortaSwitch handbook.

On this page

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