PINless Dialing

Overview

Checklist

Initial Configuration of PortaSwitch®

Create a Vendor Tariff

Enter Rates

Managing Rates Online

Managing Rates Offline

Create Vendors

Define Connections

Configure Access from PSTN

Configure the IVR Application

Set up the IVR Application

Customize the Parameters of the IVR Application

IVR Languages

Custom Brand Prompts

Prepaid Card IVR Configuration Parameters

Create a Tariff for End Users

Enter Rates

Test Rate Configuration (Optional)

Create a Product

Create a Customer Class

Create a Customer

Create an Account

Overview

PINless dialing service allows users to make cheap long-distance / international calls from their mobile or landline phones without entering a PIN by simply dialing an access number.

 

When a user signs up for your PINless dialing service, you register their phone number in the system and provide them with the access number they must dial. Then, when the user makes a call, the system recognizes their CLI (ANI), informs the user about their balance and asks them to enter their destination number.

 

You can enable user access to the service using either of these two ways:

 

·       A user signs up for the service. You register the user’s ANI as the PINless dialing account and provide the user with the service access number to dial;

 

·       A user purchases a PINless dialing calling card. You enable ANI authentication and auto registration options for your Prepaid card calling application. When the user dials their access number for the first time they are asked to enter their PIN number and offered to register their ANI. From then on, they are only asked to enter their destination, entirely skipping the PIN number entry step.

 

This document describes how to provide PINless dialing service by creating dedicated PINless dialing accounts.

 

Let’s say, Amanda Doe signs up for your PINless dialing service. You add her mobile number 16041112222 as a PINless dialing account and provide her with a service access number. When Amanda dials the access number from her mobile, she hears what her current balance is and is asked to enter her destination number. After she dials the destination number, the system informs Amanda about the maximum permitted call duration and connects the call. When the call ends, the system deducts the correct amount from Amanda’s balance.

 

Also, Amanda is granted access to the self-care portal, so she can keep track of her calls on her own and top up her balance as necessary by using her credit card.

 

Checklist

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

 

Operation

Done

Rating configuration (Vendor)

 

Create a tariff A, which describes your termination costs

[     ]

Insert rates in tariff A for the destinations your customers will call

[     ]

Create a vendor

[     ]

Create a connection for this vendor using tariff A

[     ]

Configure the vendor that provides the IVR access number

[     ]

Configure a “Calls from Vendor via SIP” connection to the vendor that provides the IVR

[     ]

IVR Application configuration

 

Define your access number and associate the Prepaid card calling application with it

[     ]

Enable the ANI authentication option for the Prepaid card calling application

[     ]

Rating configuration (Customer)

 

Create a tariff B, which will be applied to customers

[     ]

Insert rates in tariff B for the destinations to which the customers will call

[     ]

Create your PINless calling product

[     ]

In the rating list (of the prepaid product) include an entry that will contain the PortaSIP® node, access number and tariff B containing the PINless calling rates

[     ]

Account provisioning

 

Create a customer class defining the Prepaid cards holder business model

[     ]

Create a prepaid customer who owns the PINless account

[     ]

Create a PINless account for this customer

[     ]

 

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.

Create a Vendor Tariff

A tariff is a single price list for call services. A tariff combines:

·       Conditions which are applicable to every call regardless of the called destination.

·       Per destination rates.

 

1.     On the navigation menu to the left, select Service catalog and click Tariffs.

 

Open the Tariffs panel.

 

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 (for example, GlobalNet Termination).

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

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

·       Service – Choose Voice Calls here.

·       Applied to – Choose Vendor in the Applied to list.

·       Routing – Leave the Routing option enabled for this tariff.

 

3.     Click Save.

 

Add a new vendor tariff.

Enter Rates

Rates are per-destination prices. Please refer to the Call Billing Parameters section in the PortaBilling Administrator Guide®  for more details on billing parameters.

Managing Rates Online

Managing rates online is very convenient for maintaining existing rate tables, as well as for reference purposes. In the case of new price lists or major updates, the offline method is better.

 

1.     On the vendor tariff’s panel (GlobalNet Termination), click Rates.

2.     On the Add rate panel, fill in the rate details:

·       Destination – Select a destination prefix from the list or type it in directly, e.g. 420 for Czech Republic.

NOTE:  You must create an entry for certain phone prefixes in the Destination register before creating a rate for them in the tariff.

·       Route category – You can split your available routes into several categories, such as “High quality,” “Premium,” etc., then create routing plans for your customers. Use the Default route category for now.

·       Preference – The routing priority for the specific destination. 10 is the highest priority, 0 is the lowest (i.e. do not use this destination for routing at all). For now, you can just set all of your vendor rates at preference 5, and the system will organize available routes according to cost (LCR).

·       Huntstop – When enabled, instructs the system to not try any routes with a lower preference.

·       Interval First – Type a first billing unit in seconds.

·       Interval Next – Type the next billing unit in seconds.

·       Price First – Type a per minute price for a first interval.

·       Price Next – Type a per minute price for the next interval.

NOTE: Off-peak fields appear only if this tariff has already been assigned an off-peak period on the General info panel.

·       Effective from – If you want this rate to take effect sometime in the future, you can either type in a date manually, or use the calendar.

NOTE: When using the calendar, you can specify that the date you are entering is in a different time zone than your present one. PortaBilling® will then automatically adjust the time.

3.     Click Save.

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

 

Add a new rate.

Managing Rates Offline

You also can upload rates from a .csv or .xls file – please consult the Rate Import section for more details.

 

timesaver Perform the Create Tariff and Enter Rates steps described above until you have created a tariff with the termination costs for each termination partner you have; these tariffs are created as “Applied to: Vendor”.

Create Vendors

This step is only required if you have not entered information about your vendors into the system before. Vendors are your termination partners or the providers of incoming toll-free lines and DID numbers.

1.     In the left upper corner click  to open the navigation menu.

2.     On the navigation menu, select Infrastructure, then select Vendors.

3.     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 (for example, GlobalNet).

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

 

4.     Click Save.

 

Add a new vendor.

Define Connections

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

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

·       Description –Type a descriptive name for this connection. It will be displayed in the list of connections.

·       Service type – Select Voice Calls.

·       Type of connections – Select SIP.

·       Direction – Select To vendor.

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

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

·       Identify gateway by – Choose how to identify the gateway: IP, gateway ID or both. Specify the IP address and / or ID of the vendor’s gateway or switch.

 

3.     Click Save.

 

Add

4.     Repeat these steps to add more connections to this vendor.

Configure Access from PSTN

Since the main purpose of this service is to give your customers access to your prepaid application from PSTN (by dialing your access number from their landline or mobile phone), you have to ensure that calls to that access number are delivered properly to your network and then handed over to PortaSIP® Media Server.

 

Please refer to the instructions in the Incoming Calls from PSTN section for complete details about how to set up the vendor and the connection.

Configure the IVR Application

First you need to define that when a call is made to the access number of your prepaid calling card service, PortaSIP® launches the corresponding IVR application for handling the call.

Set up the IVR Application

Set up the IVR Application for the virtual PortaBilling® environment where you use this application.

1.     In the  Routing section of the PortaBilling® main page, choose IVR Applications.

2.     Click the add Add button.

3.     In the Name field, type a name for the IVR application. In the Application Type list, select Prepaid card calling.

 

Add a PINless dialing IVR application

 

4.     Click on the application’s name to further configure this IVR application.

 

Select the application

 

5.     To add the access number, click the add Add icon.

6.     In the Access Number field, type your prepaid calling card access number.

7.     Click save Save.

8.     Repeat steps 6–7 to add more access numbers.

 

Add access number

 

timesaver You can associate multiple access numbers using the Quick Upload tool:

1.     Click the Quick Upload button and type in or paste the list of access numbers.

2.     When you are done, click Next and then Upload.

 

Access numbers quick upload wizard

 

Of course, you can clone multiple entities in order to customize the application parameters (such as IVR languages or whether ANI authorization is performed), according to your requirements.

Customize the Parameters of the IVR Application

In order to support PINless dialing, the prepaid application should have the ANI Authentication feature enabled. Then if the ANI number of the incoming call matches the ID of an account, this account is the one placing the call (and will be charged when the call is completed). The customer will immediately be asked to enter a destination, skipping the PIN entry step.

 

Enable ANI Authentication

NOTE:  The Manual Authentication option must be disabled for this scenario.

When you provide both residential VoIP and PINless dialing services, you will have two types of accounts in the system, and the account ID will contain the phone number:

·       “Normal” SIP accounts. When someone in your network dials the number, the system will recognize that the call should be delivered to one of the IP phones connected to PortaSwitch® – and will never be sent out to the PSTN.

·       ANI accounts. The situation here is exactly the opposite: when someone in your network dials this number, the call will be sent out to the PSTN.

 

In order to avoid confusion between these two types of accounts (which may result in calls being routed improperly) and allow both your administrators and the PortaBilling® routing engine to clearly distinguish between ANI accounts and regular SIP accounts, the PINless account role has been introduced.

 

When you create an account with the PINless account role, PortaBilling® automatically adds the suffix '@ani' for your ANI authentication accounts.

For example, if you would like to allow your customer to use his cell phone with ANI 16041112222 for ANI authentication, you would create the PINless account 16041112222@ani for this customer.

 

You can also set up the ANI translation rule as a regular expression in the ANI Translation Rule field.

 

On the IVR Settings tab, type s/$/@ani/ in the ANI Translation Rule. This will instruct the system to add @ani suffix to the ANI number of the incoming call and search for a ANI@ani account (e.g. 16041112222@ani) for authentication and authorization.

 

Add ANI translation rule

IVR Languages

Configure in which languages the IVR will communicate with the customer.

 

Customize the IVR language

 

Include the languages

 

1.     Click the wizard icon near the Languages field to launch the dialog box for the language selection.

2.     In the Available languages box, select the language (or several languages) you wish to use for voice prompts. In this case, the IVR’s first prompt will be the language selection prompt “Please press 1 for English, 2 for Russian, 3 for German, etc.” To choose all languages at once, select the line All available on top. Then click the Include-> button. The selected languages will appear in the Selected box.

You can also change the language order using Up and Down buttons.

3.     Press Ok to save finalize the language selection.

Custom Brand Prompts

Configure the IVR application to use your brand prompts instead of default ones. Please refer to the How to Configure Custom Brand Prompts section for a detailed configuration description.

Prepaid Card IVR Configuration Parameters

See the APPENDIX A.  PortaSIP® Media Server IVR Applications Preferences section of the PortaSIP® Media Applications Guide to read more about the prepaid card IVR configuration parameters.

NOTE: There is a helpful tool-tip for each option. Just point your mouse to the desired option to invoke it.

Create a Tariff for End Users

1.     On the navigation menu, select Service catalog and click Tariffs.

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, (for example, SIP Phone Subscribers).

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

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

·       Service – Select Voice Calls.

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

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

 

3.     Click Save.

 

Add a customer tariff

 

4.     On your customer tariff’s panel (PINless dialing), click General info.

5.     On the General info panel, fill in the following information:

·       Default off-peak period – If you do not differentiate between peak and off-peak rates, just choose None; otherwise, select one of the previously defined off-peak periods.

·       Destination group set – If you wish to enter rates in the tariff not for every individual prefix, but for a whole group of prefixes at once, you should create a destination group set and destination groups beforehand. Leave this select menu empty for now.

·       Round up to, decimal places – Instead of calculating xDRs with a 5-decimal-place precision, round up xDR amount values (e.g. to cents, so that 1.16730 becomes 1.17).

·       Default formula – Default rating formula, which will be applied to every rate created in the tariff. If you leave this empty, the “old-style” rating will be used.

·       Short description – Type a short tariff description. This will be shown in the rate lookup on the admin interface and the self-care pages for your accounts and customers.

·       Description – Type an extended tariff description.

 

6.     Click Save.

Enter Rates

1.     On your customer tariff’s panel (PINless dialing), click Rates.

 

Add rates

 

2.     On the Add rate panel, fill in the rate details:

·       Destination – Select a destination prefix from the list or type it directly, e.g. 420 for Czech Republic.

NOTE: You must create an entry for certain phone prefixes in the Destination register before creating a rate for them in the tariff.

·       First interval, seconds – Type a first billing unit in seconds.

·       Next interval, seconds – Type the next billing unit in seconds.

·       First price – Type a per minute price for the first interval.

·       Next price – Type a per minute price for the next interval

·       Off-peak first interval – Type a first billing unit in seconds for off‑peak time.

·       Off-peak next interval – Next billing unit in seconds for off‑peak time.

·       Off-peak first price – Type a per minute price for first interval for off‑peak time.

·       Off-peak next price – Type a per minute price for next interval for off-peak time.

NOTE: Off-peak fields appear only if this tariff has already been assigned an off-peak period on the General info panel.

·       Rate formula – Type a custom rating formula.

·       Effective from – If you want this rate to take effect sometime in the future, you can either type in a date manually, or use the calendar (click on the DD-MM-YYYY link).

NOTE: When using the calendar, you can specify that the date you are entering is in a different time zone than your present one. PortaBilling® will then automatically adjust the time.

3.     Click Save.

4.     Repeat these steps to enter more rates.

Test Rate Configuration (Optional)

1.     While on your customer tariff panel, click Test.

2.     Type in the phone number for which you would like to test the rating, as well as the estimated call duration, and then click Test.

3.     You will now see the estimated amount charged for this call, as well as a detailed explanation of the rating process.

 

Test rates

Create a Product

Prepaid cards will be issued for a specific product. Products are a powerful feature that defines different ways to bill an account. Product definition is always done in these steps: product definition, service definition and configuration, and creation of the rating list.

 

1.     On the navigation menu, select Service catalog and click Products.

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

·       Name – Type an internal product name that will be shown on the administrator interface.

·       Name visible to end users – Type a name of the product that will be shown to end users on their self-care interfaces.

·       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 PINless from the list.

 

3.     Click Save.

 

Create a product

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:

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

2.     On the Services panel, click Add a service.

3.     In the Select services to add dialog box, select Voice calls and click Add.

 

Add the service

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.

 

1.     On your product’s panel, click Charges, then click Usage charges.

2.     On the Usage charges panel, click Add.

3.     Fill in the required information:

·       Service – Select Voice Calls.

·       Node – Select the PortaSIP® node.

·       Access code – Type the access number that you have added for the IVR application. (e.g. 18665552288).

·       Tariff – Choose the tariff that will be applied to your prepaid calling card customers.

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

NOTE: If you use several access numbers for the IVR application, you must add a rating entry for each of them.

 

Define usage charges

 

4.     Click Save.

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.

Create a Customer Class

A customer class provides the ability to define a group of parameters in a centralized manner, and then apply those parameters to many customers simultaneously.

 

1.     On the navigation menu, select Sales, then select Customer classes.

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 Prepaid cards holder from the list.

·       Managed by – Select Administrator only.

 

3.     Click Save.

 

Create a customer class

Create a Customer

A customer is an owner of accounts. The customer’s contact information is used to distribute account usage information, call statistics, invoices, and so on. Since PINless dialing is a prepaid service, in this example we will describe how to create a prepaid customer.

 

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.

·       Business model – A business model defines what type of service is to be provided to the customer. Select Prepaid cards holder 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 (PINless dialing customers).

·       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 - Select Prepaid.

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

·       Available Funds – Specify the amount a customer has paid you when signing up.

 

Add a customer

Personal info

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.

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.

3.     Click Save.

 

Add customer information

Create an Account

An account identifies the end user who uses the service. In the case of the PINless dialing service, the account is a PINless account with a unique @ani suffix.

 

1.     On your customer panel, click Accounts.

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

·       ID – Type the customer’s mobile number (e.g. 16041112222).

·       Account role – Select PINless.

·       Product – Select the product you just created (PINless dialing).

·       Activation date – Leave the default value as is. The account will immediately be activated.

·       Type – Select Credit.

·       Balance control – Select Subordinate.

 

Add an account

 

3.     Click Save.

 

 

Amanda can now use the service.

 

Give Amanda the customer self-care portal credentials (login: amandadoe, password: yUS867) so that she can keep track of her calls, balance and top up her funds on her own, as needed.

 

Log in to the customer self-care