Add Rate Patterns to Rate Table
For a Rate Table to be effective it must contain at least one rate pattern or destination number. RadiusCat recognizes a complete destination telephone number or any number of digits starting from the beginning of the number, called a pattern.
For example, lets say you want to allow calls to the Toronto which start with the area code 416, but you would like charge a special rate of 20¢ @ minute for calls destined to numbers starting with 416368 which is for "Toronto Location A" and 30¢ @ minute for "Toronto Location B" with telephone numbers starting with 416987 and all other Toronto calls to be charged at a rate of 10¢ @ minute. To achieve this you would create a Rate Table with 3 separate patterns like below:
Pattern Description Rate
416 Toronto All $0.10
416368 Toronto Location A $0.20
416987 Toronto Location B $0.30
RadiusCat would Authorize calls against this Rate Table as follows:
If RadiusCat received a call for authorization with a destination telephone number of 4163681234, RadiusCat would try to match all digits of that telephone number starting from the right (last digit) and moving towards the left. The authorization search process can be simulated as follows:
RadiusCat would search for 4163681234.....no match would be found in the Rate Table
RadiusCat would search for 416368123.....no match would be found in the Rate Table
RadiusCat would search for 41636812.....no match would be found in the Rate Table
RadiusCat would search for 4163681.....no match would be found in the Rate Table
RadiusCat would search for 416368.....match would be found in the Rate Table
The closest pattern that matches the destination number received for authorization is 416268 and so the RadiusCat would authorize the call at a rate of 20¢ @ minute.
Likewise if RadiusCat received a call for authorization with a destination telephone number of 4167851234, RadiusCat would try to match all digits of that telephone number in the following manner:
RadiusCat would search for 4167851234.....no match would be found in the Rate Table
RadiusCat would search for 416785123.....no match would be found in the Rate Table
RadiusCat would search for 41678512.....no match would be found in the Rate Table
RadiusCat would search for 4167851.....no match would be found in the Rate Table
RadiusCat would search for 416785.....no match would be found in the Rate Table
RadiusCat would search for 41678.....no match would be found in the Rate Table
RadiusCat would search for 4167.....no match would be found in the Rate Table
RadiusCat would search for 416.....match would be found in the Rate Table
If absolutely no match is found for a destination number received for authorization RadiusCat will return an "Invalid Destination Number" message to the Quintum Tenor (RADIUS Client).
Follow the steps below to add destination pattern to a Rate Table:
- Add destination pattern
Enter the new destination pattern by clicking on the empty cell under the Pattern column and start typing the rate pattern. A rate pattern must contain numbers only and must not contain empty spaces.
Note:
A destination pattern can be the complete destination telephone number or any continuous part of the number starting from the beginning of the number. Eg, a destination telephone number of 6139876541 could be represented by any of the following patterns:
6
61
613
6139
61398
613987
6139876
61398765
613987654
6139876541
Next click on the empty cell under the Description column and type the description for the telephone number or rate pattern you just entered. This should be a description that will help you to identify a rate pattern. In the picture below the rate pattern entered consist of a complete telephone number which means all calls to that particular number will be charged at the rate defined.
- Define additional rate pattern detail
Define the additional details for the rate pattern as follows:
· Billing Initial Length: [default 60 seconds] This is a numeric value which represents the number of seconds for the minimum billing length for each call authorized for this rate pattern. Eg: If a call lasted 10 seconds and the value defined here is 60 then that call would be billed for a duration 60 seconds and not 10 seconds.
· Billing Incremental Length: [default 60 seconds] This is a numeric value which represents the number of seconds which represent the billing increments (billing chunks) which will be used for calculating the cost for this call. Eg: If destination rate pattern is defined with a rate of $0.30 @ minute and a Billing Initial Length value of 60 seconds then an authorized call lasting 1 minute and 20 seconds (80 seconds) would be rounded up to the next 60 seconds and charged at total duration of 2 minutes (120 seconds) at $0.60, however with a Billing Initial Length value of 30 seconds that same call would be rounded up to the next 30 second increment and billed at 130 second at $0.45.
· Day Start: [default 7:00 AM] This is a time value which represents the start of day time billing hours. All calls authorized between Day Start and Eve Start hours will be treated as a day hour call and billed at the rate defined in Day Increment Charge.
· Day Initial Charge: [default $0.0500 (5¢)] This is a numeric (money) value which represents the amount of money that will be charged initially for a call authorized for this destination during the day time hours. This is a one time amount and is separate from the incremental amount charged.
· Day Incremental Charge: [default $0.0500 (5¢)] This is a numeric (money) value which represents the amount of money that will be charged at the Billing Incremental Length intervals for a call authorized for this destination during the day time hours.
If this value is 0 RadiusCat will authorize a maximum talk time of 12 hours (720 minutes).
· Eve Start: [default 1:00 PM] This is a time value which represents the start of evening time billing hours. All calls authorized between Eve Start and Night Start hours will be treated as an evening hour call and billed at the rate defined in Eve Increment Charge.
· Eve Initial Charge: [default $0.0500 (5¢)] This is a numeric (money) value which represents the amount of money that will be charged initially for a call authorized for this destination during the evening time hours. This is a one time amount and is separate from the incremental amount charged.
· Eve Incremental Charge: [default $0.0500 (5¢)] This is a numeric (money) value which represents the amount of money that will be charged at the Billing Incremental Length intervals for a call authorized for this destination during the evening time hours.If this value is 0 RadiusCat will authorize a maximum talk time of 12 hours (720 minutes).
· Night Start: [default 8:00 PM] This is a time value which represents the start of evening time billing hours. All calls authorized between Night Start and Day Start hours will be treated as a night time hour call and billed at the rate defined in Night Increment Charge.
· Night Initial Charge: [default $0.0500 (5¢)] This is a numeric (money) value which represents the amount of money that will be charged initially for a call authorized for this destination during the evening time hours. This is a one time amount and is separate from the incremental amount charged.
· Night Incremental Charge: [default $0.0500 (5¢)] This is a numeric (money) value which represents the amount of money that will be charged at the Billing Incremental Length intervals for a call authorized for this destination during the night time hours.
If this value is 0 RadiusCat will authorize a maximum talk time of 12 hours (720 minutes).
· Connection Fee: [default $0] This is a numeric (money) value which represents the amount of money that will be charged every time a call is successfully authorized and connected to the destination telephone number called.
· Compensate: [default 0 seconds] This is a numeric value which represents the number of seconds that will be subtracted from the total duration of a call authorized. This in effect is way of compensating the caller in situations where you are aware that it may take a few seconds to get connected to a particular destination number while billing has started. Eg, if a caller total duration for a call is 60seconds and the Compensate value is 10 seconds then that caller would only be billed for (60 - 10) 50 seconds.
· Tax: [default 0 %] This is a decimal value which represents the tax that is associated to calls made to this destination. Every destination pattern from the same rate table can have a different tax associated with it.
Note that this is a destination tax and is meant for those countries/destinations where a tax is applicable based on calls directed to that destination.
· Maximum: [default 0] This is a decimal value which represents the maximum amount of money that you would like charge for calls to this destination.
- Save rate pattern
Once you have verified the all the values for your new destination pattern you can now save the rate.
Save your new destination pattern by clicking the button at the top of the page. You will be prompted with the following confirmation message box:
Click OK to accept the message and your Rate Table grid should now resemble the one below in the picture:
You have now successfully added a new destination pattern to your rate table.
http://svkwiki.com/wiki/Add-Rate-Patterns-to-Rate-Table

