Hosted Billing and GK Quick Start Guide
Tuesday, 17 April 2007

Table of Contents

Appendices

Introduction

Data Tech Labs Hosted Billing and Gatekeeper service provides advanced routing, rating and management of H.323 VoIP traffic. All the functions and tools are web-based and can be accessed from any computer having a compatible Web Browser Installed. We recommend using Microsoft Internet Explorer 5.0 or higher. Other web browsers should also work.

The system consists of two parts:
  • Node Manager - routing tool (H.323 gatekeeper).
  • Arrow Billing - rating and account management tool (Prepaid/post paid billing).
show top

Before You Start

In order to be able to log in and operate the Hosted Billing and Gatekeeper service, you should have access to the following information:
  • Arrow Billing Login URL
  • Arrow Billing Login username and password
  • Login URL for Endusers for Arrow Billing
  • Node Manager Login URL
  • Node Manager Login username and password
  • Gatekeeper IP address and H.323 ID
Please make sure that you have all these information before you proceed to next steps.

show top

Initial Configuration

Node Manager configuration

Please log into Node Manager with the provided username and password.

General Guidlines

The links on the left navigation menu provide you access to all the functionalities of Node Manager. Please note that the changes you make in Node Manager will not be applied until you hit the link Apply Configuration. Gatekeeper will only be notified once you have clicked on this link. Apply status indicator displays the status of configuration (Applied/Not Applied).

Identifying Routing Destinations

The initial step is to create a list of destinations you are going to route to. Click on the link Destinations in the left navigation menu. A sample list of destinations will be shown as a result. You can add to this list and/or delete any of the existing entries. You just have to make sure that all the country codes you would like to route to are being added. You can add either the country code or the country code followed by area code. A couple of entries each of which is valid is shown below:
  • 880 - Bangladesh
  • 88017 - Bangladesh mobile
However, if you are going to route to A-Z (all countries) you do not need to create an entire list of country codes. Simply add 9 entries each with the first digit of the respective continental code. The simplest way of doing this is illustrated here:
  • 1 - USA/Canada/Carribean
  • 2 - Africa
  • 3 - Europe
  • 4 - Europe
  • 5 - South America/Carribean
  • 6 - Asia/Australia/Pacific
  • 7 - Russia/CIS
  • 8 - Asia
  • 9 - Asia

Terminating Gateways

Click on the link Gateways to see the list of existing terminating gateways as well as create new ones. The traffic will be routed only to the gateways in this list. You should always remove or edit the sample entries in the production environment. To create a new gateway, click on Add New Gateway. The required fields to be filled are the following:
  • Alias - identification of the gateway. This field must be unique for each gateway and should contain letters, numbers and/or underscore sign (_). Spaces and other special symbols are not allowed.
  • IP Address - destination gateway IP address. The port is 1720 always.
  • Prefix - add optional tech prefix if the gateway requires it. Do not add country code here. For instance if you are routing to Bangladesh Mobile (code 88017) and your gateway asks to route calls in the format of 44488017, enter only 444 in prefix field.
  • Comment - any text for your internal use
  • Enabled - check this box to activate gateway. Unchecked box will stop routng to this Gateway.
After providing values to the above fields click on the button Add gateway. The list of gateways will appear. Enter into the newly created gateway again to add supported destinations and follow the link Add New Destination. This will display the drop down menu of Destinations. Simply follow this step for all the destinations for which you want this gateway to receive the traffic.

Originating EPs

In general, it is not necessary to create specific Originating Endpoints. This is needed only in cases when you want to give some tech prefix to originator. Click on the link Originating EPs in the left navigation menu. Sample Originating EP "All" is provided for convenience which you can use for Originators that do not need any prefix. For example, make a call to Bangladesh mobile and gateway with prefix 444 will do like this:
  1. Edpoint will dial : 88017xxxxxxxx
  2. Getekeeper will add 444 and route number to destination like this: 44488017xxxxxxxx

Create Route

The last step in Node Manager is to create route. Follow the link Routes and click on Add New Route. A simple two-step process will prompt to create a route:
  1. Choose Originating EP and Destination.
  2. Select the gateway to route through. Provide equal priorty to distribute calls evenly between gateways. Set lower priority (higher number) to exclude Gateway from routing.
The Route map wil show you all the routes you have created. Repeat this procedure for other destinations and originators if needed.

Apply Configuration

Click on the link Apply Configuration to submit all the modifications to the gatekeeper. Routing will take effect immediately at this point.

show top

Arrow Billing Configuration

General Guidlines

Arrow Billing provides authorization of callers. Without proper configuration of Arrow Billing no calls will be allowed through the system. As usual items in Arrow Billing are accessible through links on the left navigation menu. However, modification of entries in Arrow Billing will take effect immediately.

Rate Tables

Create proper rate table. You have two options to create a rate table:
  1. Create rate table manually. To accomplish this, please click on the main menu item Rates. You can either modify the existing blank sample rate "Rate1" by clicking on its name or create a new table by clicking on the submenu item Create New Rate Table. You will be prompted to type the table name and description. Please note that the field Rate Table Name cannot be left blank. You can also create the table based on another existing table and specify the change per minute rates by a percentage.
  2. to add an entry in Rate table, click on its name and then on the link Add New Rate Item (Destination). The page for New Base Rate Item will open.
  3. Available fields for new destination are as follows:
    1. Destination code - destination country code, example 1, 44 or 91
    2. Description - destination country name as it will appear in reports
    3. Base tariff/rate per minute - basic rate to be applied per minute
    4. Currency - list of currencies added in the system
    5. Increment seconds - the number of seconds in the pulse, applied after the minimum charge seconds. The users have to pay for each pulse.
    6. Grace period seconds - the number of initial seconds for which no rate is applied. Used to prevent false calls.
    7. Minimum charge seconds - all calls having duration shorter than this value will be rounded up and charged to this value.
  4. Click on the button Add Item.
  5. Repeat steps 2 to 4 for other destinations.

Customer Account

Create Your Customer Company and Accounts.
  1. Create the company of the client. Click on the main menu item Companies -> Add New Company. Fill in Company Name and other credentials optionally and hit Add Company when finished.
  2. Create VoIP account. Click on the negivation menu item Accounts and then on the submenu item Add VoIP Account. The page for adding a VoiP Account will appear.
    1. Account/Number/Alias - this field is the primary means of authentication of caller accounts. It must be filled with a valid phone/card number or H.323 alias or ANI. Only digits are allowed for phone/card numbers and ANI while for H.323 alias, digits, letters and special characters (_, @) are allowed.
    2. Password - account password. For accounts registering to gnugk gatekeeper, this should be the same as Account/Number/Alias.
    3. IP Address - required if the account is identified by its IP address.
    4. E.164 Number - this number is used to prevent endpoint registration with voluntary phone numbers when using H.323 alias authentication.
    5. Authentication type - main authentication method of accounts, such as IP Address, ANI/Number, H.323ID, H.323ID + E.164 Number, or Telephony Trunk ID.
    6. Account Group - a means of easier reporting and mass modification of accounts from Account Groups in the main menu. It does not have any impact on authentication or billing process.
    7. Enable Web Login - this checkbox field controls user access to the system via end-user login screen.
    8. Web Login Username - this text field lets you provide the username to access the end-user screen.
    9. Web Login Password - in this field you can type the password to access the end-user screen.
    10. Language - this field lets you choose the language to be used for accessing the account.
    11. Company - this drop-down menu allows assignment of the account to a particular Company. This is necessary when a Standalone Account is being attached to some existing company.
    12. Agent - this drop-down menu defines the ownership of accounts. It allows assignment of accounts to a particular agent.
    13. Reseller - reseller also defines the ownership of accounts. It allows assignment of accounts to a particular reseller.
    14. Currency - default currency of account.
    15. Starting Credit - this text box represents the initial amount of fund granted to the account at the moment of the creation of accounts.
    16. Credit Limit - credit Limit is the maximum negative balance of account that is allowed. This value is always positive.
    17. Account Status - this field can enable the account to receive services or disable the account to reject the services. It can also make the account available for immediate use or make it pending to indicate temporarily unavailability.
    18. Rate - the Rate Table used by this account.
    19. Prepaid - prepaid/postpaid mode. Checking this option will reset the Credit Limit of the account to zero. Account will need positive balance to place calls.
    20. Account is Master - sets this account as Master. If account is master for other accounts, they are authenticated against its credentials and calls are charged to Master Account.
    21. Master Account - this field works with the previous one. If the account is not master, you can select a Master Account for it from this drop-down menu.
    22. Expires - expiry Date of the account.
    23. Recurring Service - recurring service to be applied to this account.

Billing System configuration is done.

show top

Testing

General Guidlines

In order to make test calls, Node Manager must be configured for proper routing and the account for testing party must also be present and configured in Arrow Billing.

Testing Procedure

Make a test call. After the call is made, go to Calls -> Traffic Log to see if the entry was created.
  1. If the entry does not exist, there may be a couple of reasons for it:
    1. The Originating traffic is not reaching the gatekeeper.
    2. The Originating party is sending prefix which does not exist in Node Manager. Please configure Node Manager accordingly.
  2. If the entry does exist, please see disconnect cause for the call. If the disconnect cause is "0", possibly (but not always) the settings in Arrow Billing do not allow the caller to make call. Please see Arrow Billing configuration above and Appendix A as well for requirements to successfully authenticate the call.
  3. If you see the entry, click on Call Detail in the navigation menu item Billing to see if it was properly rated. Lack of CDR entry indicates that the steps were not properly followed in creating rate tables and/or customer accounts.
show top

Appendix A. Summary of Requirements for Successful Authorization and Authentication Message

  1. Account/Alias matches endpoint H323ID
  2. Password matches endpoint password (or h323id for gnugk gatekeeper)
  3. Account Status is "Enabled".
  4. Account Balance is higher than Credit limit (note that credit limit always is positive number).
  5. Called Destination exists in Rate table.
show top

Appendix B. How to Create Reseller Account

  1. Login to Arrow Billing with your username and password.
  2. Go to Companies (main menu item).
  3. Click on Add Company (submenu item of Companies)
  4. In the new page fill in at least the Company name (any text you like, you wil be able to change it later) and other optional information.
  5. Hit the button Add Company.
  6. You will then be directed to the modification page of the newly added company in which you will see a link Reseller Accounts - Add New. Click on the link.
  7. Make Account Status enabled or disabled (if disabled, the customers of the reseller will not be able to make calls)
  8. Select rate table - this is the rate table for this reseller (rate at which we sell calls to the reseller)
  9. Select the currency of the reseller.
  10. Press the button Add new Reseller Account.
  11. Now you will see a new section Reseller sell rates below the button. This shows the rate tables (with option to delete) this reseller can give to corresponding accounts. Click on the link Add New.
  12. select a rate table and press Add New.
  13. When you are done with creating reseller account, click on Return to Company Details.
  14. Now you are back to company editing page. Here you need to give the reseller some credit. There are 2 possibilities:
    1. The reseller has paid you some money:
      1. Click on the submenu item Payments.
      2. Enter amount, select currency and click on Add Payment.
      3. After payment is done, click on Edit Company to get back to company modification page.
    2. The reseller did not pay, but you want to give some credit:
      1. In the box Credit limit, enter amount and hit the button Edit Company. In this case NEVER check the box Prepaid.
  15. At this point you need to give the reseller access to the Billing System.
  16. Go down the page and find Web Accounts - Add New. Click on this link.
  17. In the new page please assign some username and password which the reseller will use to access the Billing System.
  18. Fill login name and password (twice to confirm password).
  19. In the section Privileges check these boxes: Accounts- view, edit, add, delete; Companies - view, edit, add, delete; Call Reports - view; Billing Reports - view; Payments - view, add; Account PINs - add (if you need to allow generation of PINs by the reseller)
  20. click on the link Add User.
Reseller Account is created. The reseller can now login with the username and password you specified using the same URL which you have and start creating accounts.

show top




Digg!Del.icio.us!Slashdot!Technorati!Free social bookmarking plugins and extensions for Joomla! websites! title=