Home

PortaBilling: User Manual

Contents

1. 12 Pine Street Alt Contact E mail voip x telecom com BCC Send Statistics Full Statistics W Provinge State NJ n PostalCode City m Countg Region 01011 New Brunswick USA Description Mes E 4 Add Vendor gt Tia save fed savenciose coe toga Vendor Name x Telecom Currency USD US Dollar Opening Balance lo E Categorizing and Defaults Billing Period CO v E E 2000 2006 PortaOne Inc All rights Reserved www portaone com 26 Porta 4 Switch Prepaid VoIP Services Hn Add Vendor gt ed save fil savenciose coe O l Vendor Name x Telecorm j Currency USD US Dollar Opening Balance 0 Address Info Additional Info User Interface Login Time Zone 4 Password Aute Web Interface Language en English v ut Access Level Vendor v Output Format Date vvvv Mm Db 2003 12 31 v Time HH24 MI SS User Defined Date amp Time vvvv MM DD HH24 MI SS User Defined Input Format Date PY Y MM D 2003 12 31 Time HH24 MI SS User Defined 3 Fillin the New Vendor form Please note that there are two tabs available on the screen The most important fields are Main form top o Vendor
2. Name Currency Descriptior Short Description Prepaid ca USD What we c Prepaid cards Off peak P Destinatic Free Seco Post Call Login F Connect Fee hi 21 7 wd mo fr v 0 0 0 0 Destinatior Destinati Country Descriptior First In Next In First PricNext P Of peak Off peal Off peak Off peak Forbidd Hidder Discont Effective From 9 00 74 0 amp Go 2 420 CZECH REProper 30 6 0 12 0 12 60 60 0 1 0 1 420601 CZECH RE Mobile 1 1 0 22 0 22 1 1 0 22 0 22 HU 420502 1 221981122 11 am 12 I 4 gt M csv Prepaid cards 1 Ready Sum 420606 66 9 Save the file in Excel You will probably get a warning from Excel that yout file may contain features that are not compatible with CSV Comma delimitedy Ignore this and choose Yes to retain CSV format 10 Close the file in Excel If you performed step 6 then disregard the message Do you want to save the changes you made as this is only due to the fact that your format is not the native Excel XLS format 11 Go back to the PortaBilling web interface and the Edit Tariff screen 12 Click on the Upload button 2000 2006 PortaOne I nc All rights Reserved www portaone com 91 Porta 4 Switch Prepaid VoIP Services 2000 2006 PortaOne Inc All rights Reserved www portaone com 13 Either enter the name of your file manually or click Browse and choose the file 14 Click il Save amp Close You should return to the Edit
3. 2000 2006 PortaOne Inc All rights Reserved www portaone com Porta 4 Switch Prepaid VoIP Services about the outgoing call using Radius Bills the account customer and vendor for the outgoing call Hangs up Sends accounting information about the incoming telephony call Bills the vendor of the incoming telephony service unlocks session for this account Setting up your network components Cisco gateway configuration guidelines Obtain the debitcard script The default Cisco debitcard application is provided free of charge to all users who have a valid Cisco support contract CCO Obtain the latest version of the script 2 0 2 8a Please note that this script does not support any billing tricks such as e Announced and real call duration e Different rates based on the access number e Special rates for the account s first call Please contact PortaOne TCL support at tcl support portaone com for assistance in implementing these features in your script NOTE According to the Cisco licensing agreement PortaOne may not distribute the Cisco debitcard application neither the original nor a modified version Please contact your Cisco representative to obtain the script Place the debitcard script and all the required prompts on your TFTP server For your convenience the TFTP server is already pre configured in the directory t tpboot on the PortaBilling100 slave server Do not send a co
4. Description In the Management section of Admin Index choose Tariffs 1 On the Tariff Management page choose 4 Add 2 Fillin the New Tariff form o Name Short name of the tariff object This is the name you will see later in the select menus o Currency Choose the currency in which your reseller plans to operate NOTE The currency for the tariff is chosen only once and cannot be changed later o Type Choose Managed by your reseller o You may skip all the other parameters as the reseller will be able to adjust them according to his needs o Short Description A short tariff description which will be understandable to your reseller o Description An extended tariff description 3 Click lal Save 4 Repeat steps 1 3 until you have entered all of the tariffs your reseller needs 2000 2006 PortaOne Inc All rights Reserved www portaone com 60 Porta 4 Switch Prepaid Card Reseller Services Create a Product for the Reseller As was the case above with tariffs you need only create a framework for your reseller to enable him to perform further independent product management Li Product Management Name Currency M El i Gl Add Product SI 7 eo S Product Name Prepsid Cards Currency usp US Dollar re sepes i GeneralInfo Maintenance Fee Breakage o m Account Defaut ACL Account seff care m Default Discount Plan None ra In
5. 4aLlILlIll Insert rates in tariff B for the destinations you plan to call Create your prepaid product Create one accessibility entry for this product using the node you created and tariff A Create a vendor Create a connection for this vendor using tariff B Account provisioning Create a customer class which will apply to your prepaid card distributors Create a retail customer who owns the prepaid cards Generate accounts for this customer Testing Try to make a test call 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 9 Porta Switch Prepaid VoIP Services Initial configuration of PortaBilling K TIP When the system has just been installed use username pb root and passwotd pb root to login The following steps are normally performed only once after the system has been installed Visit Company Info on the main menu Enter information about your A company and set up a base currency Of course this does not limit your operations to this currency only However on reports such as cost revenue different currencies will be converted to the one you specify here NOTE Once you set up a base currency it cannot be changed If you make a mistake you will have to start with a new PortaBilling environment From the main menu choose Users and create login entries for users who will be working with the system It is not recommended that the default PortaBilling roo
6. Ep 7 Off Peak Description From 21 00 until 08 00 Workdays of any month OR Weekend of any month Destination Group Set v Free Seconds 0 Post Call Surcharge 0 Login Fee 0 Connect Fee 0 Round Charged Amount XXXXX XXXXX Formula Short Description Reseller s Tariff fir Mike Description 2000 2006 PortaOne I nc All rights Reserved www portaone com 52 Porta 4 Switch Prepaid Card Reseller Services HET Edit Resellers Tariff tel Save i Save amp Close Close amp B Rates Test MJ Logout El Log Name Resellers Currency USD Type Ordinary GeneralInfo Web Upload amp Download Email Upload notepad Off Peak Period startstop hr 21 7 wd mo fr wd sa su e Off Peak Description From 21 00 until 08 00 Workdays of any month OR Weekend of any month Destination Group Set v Free Seconds 0 Post Call Surcharge 0 00000 96 Login Fee 0 00000 USD Connect Fee 0 00000 USD Round Charged Amount XXXXX XXXXX Formula Short Description Reseller s Tariff fir Mike Description In the Management section of Admin Index choose Tariffs 1 On the Tariff Management page choose H Add 2 Fill in the New Tariff form o Name Short name of the tariff object This is the name you will see later in the select menus o Currency Choose the currency in which you will charge your reseller NOTE The currency for the tariff is chosen only once and ca
7. NOTE The Access Code feature requires modification of Cisco platform application scripts see Help item on the Accessibility screen for more information The Access 2000 2006 PortaOne Inc All rights Reserved www portaone com 95 Porta 4 Switch Prepaid VoIP Services Code feature on the Quintum platform requires the ACCESSCODE feature available in the recent firmware 4 he Info digits menu allows you to apply different tariffs depending on the type of line from which your customer originates a call If you are unsute whether your telecom sends such information leave the default value ANY 5 Click lal Save to save this accessibility entry 6 Repeat steps 1 5 if you want to define more accessibility entries 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 1 In the Management section of the Admin interface choose Vendors 2 On the Vendor Management page choose Add i 4 Add Vendor gt Tid save il swveecte coe toot USD US Dollar W B Venda Name x Telecorn x Opening Balance o ddress Info Additional Info E Compliny Name E Currency Contact Phone Mir Shis E First Naame He Fax Last Name E Addres Alt Phone
8. by clicking on the corresponding tab 4 Press Sl Add to add a new connection 5 Fill in the connection information If you send traffic to the vendor via telephony choose the node and enter an optional port pattern If you send traffic via VoIP enter the remote IP address Choose the tariff which defines your termination costs for this connection vendor Description and Capacity are mandatory for all connection types 6 Click lel Save 7 Repeat steps 3 6 to add more connections to the same vendor then click Close in order to exit to the Vendor Management screen 8 Repeat steps 2 7 to add connections for other vendors Create a Customer Class Customet class provides the ability to define a group of parameters in a centralized way then apply those parameters to many customets at once If you have already created a customer class that you can use for prepaid card distributors skip this step and go to the next one 1 In the Management section of the Admin interface choose Customer Classes 2 On the Customer Class Management page choose BJ Add 2000 2006 PortaOne Inc All rights Reserved www portaone com 9 g Porta 4 Switch M Ed if G4 Name Enterprise Prepaid VolP Services Add Customer Class m save m Save amp ciose B cose S ooa Managed by Administrator only iv General Info Invoice Template Terms Invoice Grace Period Invoice Notification Intervals Invoice Re send Inte
9. set LongDistancePrefix set CarrierPrefixPattern set INTernationaLPrefix 1 set MAXDNlength 20 set MINDNlength 10 SLot Sb2Z set Online 1 1 PUBlicNumberingPlan set CountryCode set AreaCode HuntLDNDirectory publ add AccountID 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 1 Porta 4 Switch Prepaid VoIP Services Basic prepaid service Please refer to the PortaBilling100 Web Reference Guide PDF file for detailed instructions on how to navigate and operate the web interface as well as detailed explanations of particular fields Checklist Print the following page and use it to check off the operations you have completed while performing system setup according to the instructions in this chapter Please be sure to perform all of the operations all of the boxes must be checked otherwise the service will not work Operation Done General configuration Enter company data under Company Info Specify a base currency For any other currency you plan to use specify the exchange rate soutce and define exchange rates Create all the required destinations Netwotk configuration Create a node for your gateway Configure your gateway Rating configuration Create a tariff A which will be applied to prepaid card users Insert rates in tariff A for the destinations you plan to call Create a tariff B which describes your termination costs SS m m dW Se LLL LL LILDD QLA L
10. enter the URL here e g http www myproduct com Your customers will be able to go there from their self care page o Description Your description of the intended use of this product Maintenance Fee tab o Period Surcharge application interval will be shown in call history as a separate line each time it is charged None disables the maintenance fees o Fee Surcharge amount o Effective from Apply the specified maintenance fee only after a certain date no fees assessed until then choose Immediately to start applying charges as soon as possible 3 Click lal Save 4 Click on the Accessibility tab to edit this product s accessibility Enter Node and Tariff into the product s accessibility list The accessibility 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 With the Accessibility tab selected click on the Add icon In the Accessibility entry window select the node where your IVR will be running and choose the appropriate tariff 3 You can also use an access number for Accessibility in the Access code field For example if you have a node with two access numbers local 12345 and toll free 1800 12345 you can set up the product s accessibility in such a way that if a customer calls via a toll free line he will be billed using a different tariff one which includes surcharges
11. o Associated number Redirect number discussed in the Use the Redirect Number Feature section of the PortaBilling Administrator Guide Leave this empty o UM enabled Follow Me enabled and other IP Centrex features Leave these unchecked for prepaid cards 5 Click Generate Accounts a confirmation screen will indicate that your information has been accepted 6 Click 99 Close to return to the account administration page NOTE Account generation tasks are executed every few minutes and it may take a while to generate large numbers of accounts Generated cards will be distributed via email to tbe user who created them a File Edit View Insert Format Tools Data Window Help 18 x D zc E b XU nan Q f MD il 10 BzUEz mH S 5 A A2 cards2004 06 Ctrl PIN VoIP Password Web login Web Password 496225764325 dscesw6 1 2 1 496225764325 3 cards2004 06 2 961621702495 961621702495 rabpmsy 4 cards2004 06 3 302660300680 302660300680 tk2tycp 5 cards2004 D5 4 5988794583427 598 94893427 zbxqpbz B cards2004 D5 5 660845510715 850845510713 ugvtnl3 cards2004 D5 5 128805511972 128805611972 xbwocjp 8 cards2004 D5 7 137892055599 137892055599 vufyllht 9 cards2004 D5 B8 261488561202 251488581202 8rmdtiz 10 cards2004 06 9 669342708396 669342708396 u mmym 11 cards2004 06 10 194888784846 194888784845 wbemfp8 12 rardsnn4 n amp 11 18054RQ7RORO 182548878282 Alli M 4 gt gt I AccountsPrepaidcardt
12. 09 03 Connection to vendor not found Jun 05 18 09 03 No connection from vendor 2000 2006 PortaOne Inc All rights Reserved www portaone com 3 Porta 4 Switch Prepaid VoIP Services Jun 05 18 09 03 Accounting response Jun 05 18 09 03 Done This completes processing for the request Jum 05 18 09 03 Processing request BE verl 245 2 4 p1d85499 NAS IP Address User Name Called Station Id Calling station rd Acct Status Type Service Type h323 gw id h35323 call origin h323 call type h323 setup time h323 connect time h323 disconnect time h323 disconnect cause h323 volice qualTty h323 cont id call id JSCEFERBZDESILISS 29 9749 Acct Session Id ApcOct InpuLt OGLets ACCU DOULDUL ODCLSOLS Acct Input Packets Acct Output Packets ACCLU Session Time Acct Delay Time h3s23 T1ncomrng cont axd subscriber sessrlon protocol gw rxd cdn h323 1L1vr out h323 1vr out h323 Twr out h323 remote address release source remote media address gw rxd cgn gw collected cdn gw final xlated cdn gw final xlated cgn charged units disconnect text peer address info type peer id peer if index logical if index codec bytes coder type rate ontime rv playout remote udp port remote media udp port vad enable receive delay round trip delay hiwater playout delay lowater playout delay gapfill with interpolation gapfill with prediction gapfill with redundancy 2000 2006 PortaOne I nc All rights Reserved Foe Zoe is O
13. Customer John Prepaid Pr ER add E account Generator cose toot Account ID Batch SIP Status Advanced cards 2006 07 v ANY v Gheuucoounbs search Batch cards 2006 07 Pages 12 3 Selected 50 Started O Depleted 0 TE DIN Balance Open ri C EB Activation Date 2006 05 16 YYYY MM Ctrl CDRs AccountiD days USD Balance USD Limit USD TT Type Product Status SIP O 1017255645 10 00000 10 00000 Debt Perad Q 05 16 YYYY MM Cards EB Expiration Date Eram MM 1093983428 10 00000 10 00000 Debit H C Lifetime days 4 Prepaid Opening Balance 10 00000 USD 1071300873 10 00000 10 00000 Debit Sar Block Unblock O Redirect Numb 1040718652 Prepaid C Redirect Number Sieru 1069667365 i Debit Prepaid Cards UM Enabled Expiration Date 2007 05 16 ra L1 1029123815 Expiration Date 2007 05 16 Cards Preferred L1 en English will be applied to specified control numbers Dai Language 1048299031 origi Prepaid 49 Cards Fi Time Zone Europe Prague Ctrl 2 6 10 20 ARE YOU SURE D 1056118304 Prepaid Cards Update Jum un unu ER ER EE E ME ERATKAN Prepaid Cards 1 On the left side of the screen click the checkbox next to the fields which you would like to update and enter the new values 2 You can update a whole batch or only update individual accounts by entering their control number or control number range i
14. Prepaid cards distributor 20 balance 0 00000 1imit none from 193 28 87 3 into the current request Jun 05 18 09 03 PrepareNexecute GetActiveLegIdByAcct Jun 05 18 09 03 PrepareNexecute DeleteActiveLeg Jun 05 18 09 03 Force unlock requested by NAS Jun 05 18 09 03 Scheduling 59153211058 for logout call lifetime reduced to 15 gun 05 18 09 03 Logging out account 59153211059 96 from 465F5B2BR F42F11DA 8274BDDO 75CFFB2D Jun 05 18 09 03 Set lifetime with 15s to Mon Jun 5 18 09 18 2006 Jun 05 18 09 03 Looking up vendor connection Jun OS 18 09 03 Trying to match connection for call Jun 05 18 09 03 Looking for a connection VoIP originate Jun 05 18 09 03 Outgoing VoIP matching by the remote IP address 70 68 128 186 env 4 Jun 05 18 09 03 Found connection 3 PortaVendor to vendor PortaVendor Connection found so the call should be billed Jun 05 18 09 03 Pound vendor connection Jun 05 187097037 Charging call Jun 05 18 09 03 Checked 2006 06 06 03 06 24 Europe Prague against hr 21 7 wd mo fr wd sa su 1 Jun 05 18 09 03 Checked 2006 06 06 03 09 03 Europe Prague against hr 21 7 wd mo fr wd sa su 1 Jun 05 18 09 03 Start of call is peak level 1 Jun 05 18 09 03 End of call is peak level 1 Verifying whether peak or off peak rate should be applied Jun 05 18 09 03 Can reuse the already initialized charge Jun 05 h3e709 037 Calculatumg account s charge by tariff Prepaid Cards Jun 05 187
15. RADIUS on the Quintum CMS gateway you must execute the following commands in admin mode config config ri 1 To set the authentication port config RadiusInfo 14 set pap 1812 To set the accounting port contig RadriusIntfto ls set pacp 1813 To set the ip address replace the ip address with that of the PB 100 master server config RadiusInfo 1 set psipa 192 168 100 211 You must set accounting type to 2 one accounting record per call leg config RadiusInfo 1 set at 2 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 0 Porta Switch Prepaid VoIP Services NOTE Do not configure a RADIUS routing server unless you have one or else the RADIUS records will not be delivered to PortaBilling For mote information on these commands please refer to the Tenor CMS Command Line Interface reference guide To configure RADIUS on the new generation of Quintum gateways AX DX seties you must execute the following commands in admin mode Ethernet EthernetInterface set IPAddress IP set SubnetMask NetMask StaticlPRouteDir add 0 0 0 0 NetMask 0 0 0 0 Gateway RouterIP 5 TimeSetver TimeServer set UTCOffset Hours set PrimaryServerIPAddr 192 43 244 18 set SecondaryServerIPAddr 131 188 3 222 Radius RadiuslInfo UserServer set PrimaryServerIPAddr RadiusIP set SharedSecret SecretKey set AccountingType Z2 Unit olte set Country 1 GateWay set OutgoingIPRouting 1 DialPlan
16. Tariff screen where a message will inform you of the status of the import Also you will receive an email confirmation about the tariff upload If any operation failed you will receive the portion of data which was not uploaded as an attachment so you can try to import it later You can verify your work using the Edit Rates feature After you have done so go to the Main Menu by clicking on the Home icon Test the rate configuration optional 1 While in the Edit Tariff window click on the Test button to go to the Test Call Rating screen HEC Test Call Rating Date and Time Phone number 17787654321 Simulate call charges based on the call duration Simulate authorization based on the available funds Call duration 10 10 HH MESS MESS or SS 2 Type in the Site number for which you would like to test the rating as well as the estimated call duration then click on the Test button g A Test Call Rating mj dose i toot D vvvv MM DD HH24 MI SS Result of the testing Daio ond Time 2006 05 15 16 12 47 Formula Phone number 17787654321 Expanded Formula MIN 1 SEQ 1x1x0 05 amp 1xNx0 05 Simulate call charges based on the call duration Charged amount 0 50834 USD Simulate authorization based on the available funds Real charge history 1x1x0 05 609x1x0 05 Call duration 10 10 HH MESS MESS or SS 3 You will now see the estimated amount charged for this call as well as a detailed explanation
17. conf id here otherwise leave this empty o Destination The phone number you are looking for or a destination pattern first digits and a percent sign for example 420 o From To Date The date range Click Trace a Call Advantage of this method You can see all call attempts including unsuccessful calls with disconnect reasons displayed Also you can see the billing history for a call For administrator convenience accounts CDRs can be also reached from the Account Management window by clicking the CDR icon for an account 2000 2006 PortaOne Inc All rights Reserved www portaone com 49 Porta I4 Switch Prepaid VolP Services Common Symptoms Problems Common Symptom Problem Description Solution Radius debug on NAS shows There are several reasons why requests but PortaBilling communication may be Radius debug does not unsuccessful 1 Wrong radius server IP configuration in NAS Verify and correct 2 Wrong radius port s configuration in NAS Verify and correct 3 IP network problems Verify that yout network is configured cotrectly including cables and firewalls PortaBilling Radius debug Verify and correct Node IP address shows requests arriving but says in PortaBilling Consider any request from unknown client propagation delay which may require 15 minutes Arriving PortaBilling Radius Verify if PortaBilling Node Radius debug showing requests displays key configu
18. heogout Bi too Effective From Destination Now v Country Interval sec Price USD min Effective From Edit Destination YYYY MM DD 7 Delete Description First Next First Next E HH24 MI SS 2000 2006 PortaOne Inc All rights Reserved www portaone com 5 4 Porta I4 Switch Prepaid Card Reseller Services HET Resellers tariff rates E Add save Gose tariff Logout Bl tog Effective From Destination Now wi Country Interval sec Price USD min jEffective From Edit Destination yvvy mm pp amp 4 Delete Description First Next First Next en SEE fe ir e HH24 MESS CZECH REPUBLIC Peak 30 6 0 12 0 12 immediately Proper Off Peak 30 6 0 10 0 10 DngBdggl E 420 CZECH REPUBLIC Peak 30 6 0 12000 0 12000 2006 05 29 Proper Off Peak 30 6 0 10000 0 10000 16 15 19 1 On the Tariff Management page you will see a list of available tariffs Click the Rates icon next to the name of the tariff When you are in Tariff Management for a particular tariff click on Rates in the toolbar 2 In the Edit Rates screen click amp Add 3 Fillin the required information o Destination The destination prefix may be entered directly e g 47 for Norway or you can access the destinations directory by clicking the Destination link in the column header Here you can find the desired prefix by country name NOTE The phone prefix you are trying to create a rate for must alr
19. in control when informing them of rate changes For example at the beginning of the month you may choose to enter a rate change effective the first day of the following month however you can notify the customer of this only one week in advance Please use the checklist on the following page to ensure that you have performed all the required operations in the correct sequence 2000 2006 PortaOne Inc All rights Reserved www portaone com 50 Porta 4 Switch Prepaid Card Reseller Services Checklist Print the following page and use it to mark the operations you have completed while performing system setup according to the instructions in this chapter Please make sure that you perform all of the operations all of the boxes must be checked otherwise the service will not work Operations to be performed as an administrator Operation Done General and network configuration Perform the general and network configuration as described in the Basic prepaid service section Rating configuration Create a tariff A which will contain the wholesale rates you apply to yout reseller Insert rates in tariff A for the destinations to which you will allow your reseller to send calls Create a customer class to be applied to your resellers Create a reseller and apply tariff A to him on the Additional Info tab Specify a username and passwotd for the reseller to access the self care interface Create a tar
20. name of the tariff When you are in Tariff Management for a particular tariff click on Rates in the toolbar 2 In the Edit Rates screen click Add 3 Fillin the required information o Destination The destination prefix may be entered directly e g 47 for Norway or you can access the destinations directory by clicking the Destination link in the column header Here you can find the desired prefix by country name NOTE The phone prefix you are trying to create a rate for must already exist in Destinations Interval First First billing unit in seconds Interval Next Next billing unit in seconds Price First Per minute price for first interval Price Next Per minute price for next interval Off peak Interval First First billing unit in seconds for off peak time Off peak Interval Next Next billing unit in seconds for off peak time Oo Off peak Price First Per minute price for first interval of off peak time o Off peak Price Next Per minute price for next interval of off peak time O O 0 X O0 O NOTE Off peak fields appear only if an off peak period has been defined for the tariff o 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 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 current
21. of the rating process 4 Press the Close button to return to the Edit Tariff window Create all required tariffs Repeat the Create Tariff and Enter Rates steps until you have created e A tariff for each account s billing scheme For example if you plan to charge your customers more when they access toll free lines instead of local ones you need two tariffs i e Normal and Using Toll free line 22 Porta 4 Switch Prepaid VoIP Services e A tariff with the termination costs for each termination partner you have e If you have resellers also create tariffs that you will use for charging each of them Do not create tariffs which will be applied to your resellers subscribers yet First create customers and then return to this step Make sure that when creating these subscriber tariffs you choose Managed by NNN in the Type menu where NNN is the name of the corresponding reseller For more details see the Setting up a prepaid card reseller service section Create 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 two steps product definition and creation of the accessibility list Li Product Management Search Gea Name Currency Managed By Description Delete O A Add Product gt save dose ooo Poot O Currency General Info Maintenance Fee Br
22. one PortaBilling will then automatically adjust the time 2000 2006 PortaOne Inc All rights Reserved www portaone com 66 Porta Switch Prepaid Card Reseller Services o Formula s Launches the wizard for creating a custom rating formula o Hidden Forbidden or Discontinued These flags are optional Click the lel Save button in the toolbar or the m icon on the left end of the tow Repeat if you need to enter mote rates Managing rates offline NOTE Templates are available in PortaBilling a powerful tool for uploading rates from custom format data files However in this particular example we assume that you are preparing data in the default PortaBilling format A rates table may be prepared using a spreadsheet processor i e Microsoft Excel and easily imported into PortaBilling This 1s very convenient if you wish to make many changes For example you might want to increase all prices by 10 If you are not in Tariff Management for your tariff go to the main menu click on Tariffs and then click on the tariff name In the Edit Tariff window move the mouse over the Download button and hold it there until a popup menu appears Choose the Now menu item and click on it This will download the current set of rates empty and will also provide you with an overview of the file structure You will see the File Download dialog and be prompted to save the file or open it from its current location We recommend that y
23. save close Tariff oo Blogo Bog Effective From Destination ae wj Cereri Group County Country Interval sec Price USD min Effective From Edit Destination M vvvy mm pp VE S ug Q detete Description First Next First Next HH24 MI SS HE Prepaid cards tariff rates gt E ada save 8 cose Ear tow Bios Effective From Destination now Mj Cereri Group County Country Interval sec Price USD min Effective From Edit Destination as Yre MM DD VA 4 fig eee Description First Next First Hext HH24 MI SS CZECH REPUBLIC Peak 1 1 022 0 22 immediately p Mobile Off Peak 0 22 0 22 CZECH REPUBLIC Peak 30 6 0 12000 0 12000 2004 07 25 Proper Off Peak 60 60 0 10000 0 10000 21 28 52 1 On the Tariff Management page you will see a list of available tariffs Click the Rates icon next to the name of the tariff When you are in Tariff Management for a particular tariff click on Rates in the toolbar 2 In the Edit Rates screen click i Add 3 Fillin the required information o Destination The destination prefix may be entered directly e g 47 for Norway or you can access the destinations directory by clicking the Destination link in the column header Here you can find the desired prefix by country name NOTE The phone prefix you are trying
24. such id Jum 05 19206 13 Copied account 591535211059 96 debtTt balance T0 00000 or customer Prepaid cards distributor 20 balance 0 00000 1imit 2none from 193 28 87 3 into the current request Thanks to the PortaBilling call cache you do not need to look up the account in the database once again Jun 05 18 06 13 Checking if this call comes through a VoIP from vendor connection Jun 05 18 06 13 No VoIP from vendor connections were found Jun 05 18 06 13 Account 59153211058 is already logged in same session Jun 05 18 06 13 Account has an empty password skip the password check Jun 05 18 06 13 Applying override translation rule on CLD Jun 05 18 06 13 Translation s 3164 applied 160462825085 unchanged Internal PortaBilling number translation Jun 05 19 34 28 Applying customer dialing translation rule on CLD Jun 05 19 34 28 Translation local _to_e164 _ cc gt 420 1p gt 00 s cc 420 ip 00 applied 0016046282508 16046282508 The customer s translation rule is now applied i e the number is converted from the format the customer dialed with 00 into E 164 format Jun 05 18 06 13 Setting up a new charge with tariff Prepaid Cards Jun 05 18 06 13 Checked 2006 06 06 03 06 13 Europe Prague against hr 21 7 wd mo fr wd sa su 1 Jun 05 18 06 13 Start of call is peak level 1 Off peak period check yes off peak rates will be applied to this call Jun 05 18 06 13 PrepareNexecute GetPricePerDesti
25. the self care pages at all until a login ID has been assigned for his account Oo Password Auto generated means that a random password for web access will be assigned for each account these passwords will be included in the CSV file with account information Empty means that no password will be assigned so account ownets will be able to login to the web interface simply by providing their account ID PIN o Time zone When an account owner accesses the web self care pages to see a list of his calls the time will be shown in the time zone most appropriate for him o Web interface language The language to be used on the account s self care web interface Call Features tab o Preferred IVR language This is a custom attribute which is transferred to the IVR Leave English here if you are not sure whether your IVR supports it o Associated number Redirect number discussed in the Use the Redirect Number Feature section of the PortaBilling Administrator Guide Leave this empty o UM enabled Follow Me enabled and other IP Centrex features Leave these unchecked for prepaid cards 5 Click Generate Accounts A confirmation screen will indicate that your information has been accepted 6 Click 99 Close to return to the account administration page NOTE Account generation tasks are executed every few minutes it may take a while to generate large numbers of accounts A The generated cards will be distributed
26. the gateway used by the customer to access the IVR h323 1vr out tpUransactronlbp ser NAS Pore 0 This is an authentication request also called first authentication since there is no Called Station I D attribute The purpose is to verify that such an account really exists in the database and to return account attributes such as account balance Jun 05 18 04 54 h323 conf id 465F5B2B F42F11DA 8274BDDO 75CFFB2D 4 call id Jun 05 18 04 54 Found a call in cache with such id Jun 05 18 04 54 PrepareNexecute AccountAuth Jun 05 18 04 54 Found Account 59153211058 96 debit balance 10 00000 of customer Prepaid cards distributor 20 balance 0 00000 1imit 2none The line above confirms that such an account has indeed been found in the database Jun 05 18 04 54 Account 59153211058 is not logged in yet Jun 05 18 04 54 Account has an empty password skip the password check Jun 05 18 04 54 Attempt to charge account with a login fee Jun 05 18 04 54 Logging in account 59153211058 96 to 465F5B2B F42F11DA 8274BDD0 75CFFB2D Jun 05 18 04 54 Account 59153211058 logged in setting call lifetime to 1800 sec Since this is a debit account the session is locked and the call lifetime is increased to prevent multiple login attempts Jun 05 18 04 54 Updating account usage of 159153211058 with Mon Jun 5 18 04 54 2006 The first use date for the account Is updated Jun 05 18 04 54 PrepareNexecute UpdateAccountUsage Jun 05 18 04
27. to avoid problems with the prepaid card print shop PortaBilling will not generate account numbers with a leading zero Also PortaBilling will only allow generation of a batch with feasible parameters e g it is impossible to generate a batch of 1 000 accounts with ID length 4 and ID starting at 55 2000 2006 PortaOne Inc All rights Reserved www portaone com 32 Porta I4 Switch Prepaid VolP Services o Starting ID Only available in Sequential generation and is always numeric o VoIP Password To improve security you can use an account password during authentication in addition to a PIN Not all IVRs support this feature If you choose Empty no password will be assigned to the account and the password check will be switched off during authentication Choosing Empty is recommended by default If you decide to use passwotds then please use the Auto generated digits only option since then the passwotd can be entered in the IVR via phone keys o Batch A batch is a management unit for accounts The batch name is alphanumeric You can type a new name here or use the existing name in order to generate more accounts for the same batch Additional Info tab o E Commerce Enabled If checked this will allow your debit card owners to make online payments via the PortaBilling web interface Leave unchecked o Discount Plan Applies a specific discount plan to this group of accounts Leave as Product Default
28. via email to the user who created them 2000 2006 PortaOne Inc All rights Reserved www portaone com 7 5 Porta 4 Switch a File Edit View Insert Format Tools Data Window Help Oe 6AY BAS o amp rf5 Mg anal Prepaid Card Reseller Services vv 1 Batch Ctrl a cards2004 06 3 cards2004 06 4 cards2004 06 5 cards2004 06 B cards2004 06 7 cards2004 06 8 cards2004 06 9 cards2004 06 10 cards2004 06 11 cards2004 06 NANG M 4 gt gt I AccountsPr Read A CSV file with information about the new accounts will be attached PIN CO 4 C Ch amp w Ne 11 epaid cards2004 06 See a a a Se Se ee npn E VoIP Password VVeb login 496225764325 961621702495 302660300680 598794893427 850845510713 128805511972 137692055599 261488561202 669342708396 194898784846 1825 4RQ7RORO 496225754325 dscesw6 961621702495 ra5pmsy 302660300680 tk2tycp 598794893427 zbxqpbz 850845510713 ugvtnl3 128806611972 xbw6cjp 137892055588 vufyl1ht 261488581202 8rmdtiz 669342708396 u mmym 194898784846 wbemfp amp 15D cardtestPrepaidc 2000 2006 PortaOne Inc All rights Reserved www portaone com Web Password IKI Sum 9 92452E 11 76
29. 000 Effective From 2006 05 24 YYYY MM DD In the Management section of the Admin Index page choose Products 1 On the Product Management page click on the name of the product in the list 2 Change values in the Edit Product form General Info tab o Breakage A leftover balance which is considered useless for statistical purposes Accounts with a balance below breakage will count as depleted This does not affect account authentication or authorization so the account can still make calls if there is enough money left to cover at least the first interval o 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 value is Account self care pre defined ACL which allows all possible operations o Info 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 pages o Description Your description of the intended use of this product 2000 2006 PortaOne Inc All rights Reserved www portaone com 70 Porta I4 Switch Prepaid Card Reseller Services Maintenance Fee tab o Period Surcharge application interval will be shown in call history as a separate line each time it is charged None disables maintenance fees
30. 09703 Call to 160462845081 with duration 159 seconds will be charged for 180 seconds and cost is 0 3 0 1 3x60x0 05 20 by rate 93 using 10649831771 as seed The account charge is calculated note that in addition to normal per minute charges a connection fee and a post call surcharge have been applied Jun 05 18 09 03 Setting up a new charge with tariff PortaOne Jun 05 18 09 03 Using peak rate since no off peak is defined Jun 05 18 09 03 PrepareNexecute GetPricePerDestination Jun 05 18 09 03 Calculating vendor s charge by tariff PortaOne Now your termination costs to the vendor are calculated Jun 05 18 09 03 Call to 16046282508 with duration 159 seconds will be charged for 162 seconds and cost is 0 064 1x30x0 02 22x6x0 02 by rate 92 using 10649831771 as seed Jun 05 18 09 03 Charging account for the call Jun 05 18 09 03 Inserting CDR Jun 05 18 09 03 PrepareNexecute InsertAccountCDR Jun 05 18 09 03 Charging debit account 59153211059 0 3 Jun 05 18 09 03 PrepareNexecute UpdateDebitAccountBalance The CDR is inserted and the account s balance is modified Jun 05 18 09 03 Debit account of retail customer bill only the account Since this is a debit account the customer s balance is not affected Jun 05 18 09 03 Charging vendor for the call Jun 05 18 09 03 Charging vendor 3 PortaVendor 0 064 Jun 05 18 09 03 Inserting CDR Jun 05 18 09 03 PrepareNexecute InsertVendorCDR Jun 05 18 09 03 PrepareNexecut
31. 54 Authentication acknowledge response Here is an overview of all the information sent back to the gateway h323 credit amount 10 00 h323 billing model 1 noZo LVr 1n Tariff Prepaid Cards h323 1vr in PortaBilling AccountBalance 10 00000 323 1wvr omn PortaBilling ProductBreakage 0 10000 h3223 i1vr in available funds 10 00 h323 return code 0 h323 currency USD h323 preferred lang en Jun 05 18 04 54 Done This completes processing for the request Jun 05 18 06 13 Processing request BE verl 245 2 4 pid85499 NAS IP Address 193 28 87 3 User Name 59153211058 Called Station Id 16046282508 Called Station ld contains the destination number dialed by the user Calling Stabtrion ld 14257891107 Service Type Login User h323 conf id 465F5B2B F42F11DA 8274BDDO 75CFFB2D Password h325 1vr out PortaBilling Seed 10649791024 h323 i1Vvr out PortaBilling Original CLD 4041234567 h3s23 1vr out transactrionrDb 3627 2000 2006 PortaOne Inc All rights Reserved www portaone com 35 Porta 4 Switch Prepaid VoIP Services Since Called Station l D is present this is an authorization or second authentication request The purpose is to determine whether the account is allowed to call this phone number and what the maximum allowed call duration is Jun 05 18 06 13 h323 conf id 465F5B2B F42F11DA 8274BDDO 75CFFB2D 4 call id Jun 05 18 06 13 Found a call in cache with
32. 6 PortaOne Inc All rights Reserved www portaone com 72 Porta 4 Switch Prepaid Card Reseller Services Generate Accounts NOTE Before generating accounts for a production system read the section on Provisioning prepaid accounts 1 Go to the Subcustomets screen the screen which contains a list of customers It should look like the screenshot below ec Subcustomer Management search CDRs Name Accounts Currency Type Creditlimit Balance E mail Status Delete Daid Q USD Retail 0 00000 david email com x ec Accounts of Subcustomer David E Add E AccountGenerator cose Logout SIP Status any w GShowAccounts search ec Account Generator for Subcustomer David fr E cenerte ee towout Number of accounts i000 Product USD Prepaid Cards v Blocked F Opening Balance 10 Account Info Additional Info Life Cycle User Interface Call Features Type 9 Debit Credit voucher Generation method Random Sequential DID Inventory ID prefix 98 ID lenath 10 Bn VoIP Password Empty Auto generated Auto generated digits only david 2008 New batch m 2 Next to the customer name click on the Account or SJ icon in the Accounts column which will take you to the account management for that customer Click on the Account Generator 4 Fill in the Account Generator form o Number of Accounts Number of accounts prepaid card
33. 9 Debit Credit Voucher Generation method Random Sequential DID Inventory ID prefix ID length 12 VoIP Password Empty Auto generated Auto generated digits only cards2006 2007 New batch v d 2 Next to the customer name click on the Account k or 2 icon the one in the Accounts column which will take you to the account management for that customet Click on the Account generator 4 Fillin the Account generator form o Number of accounts Number of accounts prepaid cards to be generated o Product Choose the product which you would like your accounts to have o Blocked It is normal practice to generate all your prepaid cards as blocked so they cannot be misused before being sold to the dealer or end customer You can always activate the whole batch of cards or an individual card later oO Opening balance The initial balance on the card m Account info tab o Account type Account type select Debit for prepaid service oO Generation method Choose Random here this will assign every account a unique randomly generated PIN o ID prefix If you would like all of the generated accounts to start with the same digit string e g 98 enter it here Thus if you enter 98 and an ID length of 10 account IDs PINs will look like this IINNNNNNNN where N random digits o IDlength All account IDs PINs will be numerical and of the specified length In order
34. CARD 10 EASY CALL 5 Accounts in each batch are automatically numbered by control numbers starting with one If you are generating more accounts for an existing batch PortaBilling will continue control number assignment from the next available number in the sequence Available account management options Single account Whole batch batch list of control numbers batch range of control numbers It s a good idea to print the batch and control number on the prepaid card and keep a card distribution register so that later you can block some specific cards in case of fraud or give extra promotional credit to some customers You can also distribute all of your cards as blocked so that the dealer will call your support and request card activation only once the card is sold to a customer Of course the dealer should not be able to see the PIN at any time this is why we need an alternate way of identifying a card i e by batch and control number In the Management section of Admin Index choose Customers click the accounts link next to the customer and then select the batch name from the select menu Or alternatively you can go to Account info in the main menu and choose the customer and batch you want to work with You should then see a batch operation screen similar to the one below 2000 2006 PortaOne Inc All rights Reserved www portaone com 4 4 Porta 4 Switch Prepaid VoIP Services E Accounts of Retail
35. H J K L M N 0 E a as 1 Name Currency Descriptior Short Description 2 Prepaid ca USD What we c Prepaid cards 3 4 Offpeak P DestinaticFree Seco Post Call Login F Connect Fee 5 hi 21 7 wd mo fr v 0 0 0 0 6 DestinatiorDestinaticCountry Descriptior First In Next In First PricNext P Off peal Off peal Of peak Of peak Forbidd Hidder Discont Effective From 8 4201 CZECH REProper 30 6 012 0 12 60 60 0 1 0 1 25 07 04 21 28 9 420601 CZECH RE Mobile 1 1 0 22 10 22 1 1 0 22 0 22 25 07 04 21 36 10 11 ES M4 gt M csv Prepaid cards 1 Read 5 Edit the file by adding more rows with rate data so that it looks like the screenshot below 6 Note that the columns Country and Description are for reference purposes only and are ignored during import Also when using the default template you must fill in the data in the Off peak columns even if your tariff does not have an off peak period use the clipboard to easily copy values for the four peak columns 7 Also note that you may only use those phone prefixes which you have already defined as destinations see Create Destinations above 8 Make sure that you clear the values in the Effective From column which means that the new rates are effective immediately or enter a future date there Otherwise if you retain past dates then these rates will fail to upload a File Edit View Insert Format Tools Data Window Help es Sx Duc E amp T X IS AE 4 MB arial BH A
36. Life Cycle tab O Activation date Account activation date Expiration date Account expiration date O Lifetime Relative expiration date account will expire on first usage date life time days If you do not want to use this feature leave the field blank O User Interface tab oO Login If you choose Account ID default your customer will use his account ID PIN to login to the self care pages If you choose Empty the account owner will not be able to use the self care pages at all until a login has been assigned for his account Oo Password Auto generated means that a random password for web access will be assigned for each account these passwords will be included in the CSV file with the account information Empty means that no passwotd will be assigned so account owners will be able to login to the web interface simply by providing their account ID PIN o Time zone When an account owner accesses the web self care pages to see a list of his calls the time will be shown in the time zone most appropriate for him o Web interface language The language to be used on the account self care web interface 2000 2006 PortaOne Inc All rights Reserved www portaone com 33 Porta 4 Switch Prepaid VoIP Services Call Features tab O Preferred IVR language This is a custom attribute which is transferred to the IVR Leave English here if you are not sure whether your IVR supports it
37. Name Short name for the vendor object will be used on the web interface o Currency The currency in which this vendor charges you O Opening balance Starting balance for the vendor default is zero Additional info o Billing period Split period for vendor statistics User Interface o Time zone The time zone which the vendor uses for his billing period Statistics will be divided into periods according to this time zone 4 Click gl Save amp Close 5 Repeat steps 2 4 to add all of your vendors Define connections 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 1 Inthe Management section of the Admin interface choose Vendors 2 Click on the Connections icon next to the vendor name 2000 2006 PortaOne Inc All rights Reserved www portaone com 9 Porta 4 Switch Prepaid VoIP Services G Vendor Management CDRs Hame Connections Currency Balance E mail Delete O X Telecom USD 0 00000 voip x HN Vendor X Telecom connections PSTN from Vendor VoIP from Vendor PSTN to Vendor VoIP to Vendor Remote IP RTP Proxying Transl Rule Outgoing Rule CLI Transl Rule Account Tariff Description Capacity 192 168 0 1 Optimal f Termination x X Telecom 24 Edit Load 3 Choose the connection type PSTN to Vendor VoIP to Vendor etc
38. PORTA ONE Porta 4 Switch Handbook prepaid and Part postpaid services Maintenance Release 12 www portaone com Porta I4 Switch Prepaid Billing Copyright notice amp disclaimers Copyright 2000 2006 PortaOne Inc All rights reserved PortaSwitch Handbook Prepaid and Postpaid Services July 2006 Maintenance Release 12 V1 12 12 Please address your comments and suggestions to Sales Department PortaOne Inc Suite 400 2963 Glen Drive Coquitlam BC V3B 2P7 Canada Changes may be made periodically to the information in this publication Such changes will be incorporated in new editions of the guide The software described in this document is furnished under a license agreement and may be used or copied only in accordance with the terms thereof It is against the law to copy the software on any other medium except as specifically provided in the license agreement The licensee may make one copy of the software for backup purposes No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or by any means electronic mechanical photocopied recorded or otherwise without the prior written permission of PortaOne Inc The software license and limited warranty for the accompanying products are set forth in the information packet supplied with the product and are incorporated herein by this reference If you cannot locate the software license contact your PortaOne rep
39. Tariff Name repa ards Currency USD General Info Notepad Off Peak Period startstop hr 21 7 wd mo fr e Off Peak Description From 21 00 until 08 00 Workdays of any month Destination Group Set Free Seconds 0 Post Call Surcharge 0 00000 96 Login Fee 0 00000 USD Connect Fee 0 00000 USD Round Charged Amount XXXXX Xxooo Formula Short Description Mike Prepaid Cards Tariff Description In the Management section of Admin Index choose Tariffs 1 On the Tariff Management page click on the name of the existing tariff 2 If necessary modify the tariff parameters Oo Off peak Period Defines the off peak period Click on the Off peak period wizard icon to summon the wizard which will help you construct the correct period definition Click Help to get more information on period format definition If you do not differentiate between peak and off peak rates just leave this field blank oO Off peak Description Description of the off peak period automatically filled in by the off peak period wizard You do not have to fill in this field o Destination Group Set If you wish to enter rates in the tariff not for each 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 o Free Seconds The number of free seconds granted for each call In order to claim free seconds the length of the c
40. ab O Credit limit If left empty there is no credit limit for this customer User Interface tab o Time zone The time zone in which the customer will see his CDRs and which will also define his billing period For example if you choose America New_York here and the billing period is Monthly this means the billing period will start on the first day of the month at 00 00 New York time o Web Interface Language The language to be used on the customer self care web interface 3 Click gl Save amp Close Generate Accounts NOTE Before generating accounts for a production system read the section on Provisioning prepaid accounts 1 Go to the Customets screen the screen which contains a list of customers It should look like the screenshot below G Customer Management Representative Search d Type in smarcal E E Hame Accounts Subcustomers Currency Type Creditlimit Balance E mail Status Delete John Prepaid RI USD Retail 0 00000 jhismartcall com SIP Status Advanced amv v search 2000 2006 PortaOne I nc All rights Reserved www portaone com 31 Porta 4 Switch Prepaid VoIP Services E M Account Generator for Retail Customer John Prepaid fe E cenerste coe 77773 Number of accounts 1000 Product USD Prepaid Cards v Blocked L1 Opening Balance 10 Account Info Additional Info Life Cycle User Interface Call Features Type
41. ady defined as destinations see Create Destinations above 8 Make sure that you clear the values in the Effective From column which means that the new rates are effective immediately or enter a future date there Otherwise if you retain past dates then these rates will fail to upload i File Edit View Insert Format Tools Data Window Help E x Du EE GRY XB o r f M C arial 10 BIUEZSH 9 A A10 420602 zl xo Name Prepaid ca USD What we c Prepaid cards Currency Descriptior Short Description 1 2 3 4 Offpeak P DestinaticFree Seco Post Call Login F Connect Fee 5 hi 21 7 wd mo fr v 0 0 0 6 8 9 Destinatior Destinatic Country DescriptiorFirst In Next In First PricNext P Of peak Off peal Off peak Off peak Forbidd Hidder Discont Effective From CZECH REProper 30 6 012 0 12 60 420601 CZECH REMobile 1 1 0 22 0 22 1 420602 1 1 0 22 0 22 1 022 022 Tug 12 I 4 gt MH csv Prepaid cards 1 Ready Sum 420606 66 9 Save the file in Excel You will probably get a warning from Excel that A yout file may contain features that are not compatible with CSV Comma delimited Ignore this and choose Yes to retain CSV format 10 Close the file in Excel If you performed step 6 then disregard the message Do you want to save the changes you made as this is only due to the fact that your format is not the native Excel XLS format 11 Go back to the PortaBill
42. all must be at least one billing unit first interval see the Enter Rates section above o Post Call Surcharge Percentage of the amount charged for the call o Login Fee Amount to be charged immediately after the first user authentication 1 e after the user enters his PIN o Connect Fee Amount to be charged for each connected call with a non zero duration o Round Charged Amount Instead of calculating CDRs with a 5 decimal place precision round up CDR amount values e g 2000 2006 PortaOne Inc All rights Reserved www portaone com B 4 Porta I4 Switch Prepaid Card Reseller Services XXXXX XX000 means rounding to cents so that 1 16730 becomes 1 17 o Formula The default rating formula which will be applied to every new rate created in the tariff If you leave this empty old style rating will be used o Short Description 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 For example for a tariff named Cust ABC Easy Call 1800 the short description will provide better information for your reseller ABC who will be using this tariff such as EasyCall via a toll free number This field is mandatory if you are unsure what to enter here use the same wording as for the name of the tariff o Description Extended tariff description 3 Click l Save 4 Repeat steps 1 3 until you have adjust
43. annot view accessibility information You may define it for him as follows 1 With the Accessibility tab selected click on the 3 Add icon 2 In the Accessibility entry window select the node where your IVR will be running and choose the appropriate tariff 3 You can also use an access number for Accessibility in the Access code field For example if you have a node with two access numbets local 12345 and toll free 1800 12345 you can set up the product s accessibility in such a way that if a customer calls via a toll free line he will be billed using a different tariff one that includes surcharges NOTE The Access Code feature requires modification of Cisco platform application scripts see the Help item on the Accessibility screen for more information The Access Code feature on the Quintum platform requires the ACCESSCODE feature available in the recent firmware 2000 2006 PortaOne Inc All rights Reserved www portaone com 62 Porta I4 Switch Prepaid Card Reseller Services 4 The Info digits menu allows you to apply different tariffs depending on the type of line from which your customers originate calls If you are unsute whether your telco sends such information leave the default value ANY 5 Click lel Save to save this accessibility entry 6 Repeat steps 1 5 if you want to define more accessibility entries Create Vendors If you have already created vendors as a part of the basic prepaid service setup yo
44. ans rounding to cents so that 1 16730 becomes 1 17 o Formula The default rating formula which will be applied to every new rate created in the tariff If you leave this empty old style rating will be used o Short Description 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 For example for a tariff named Cust ABC Easy Call 1800 the short description will provide better information for your reseller ABC who will be using this tariff such as EasyCall via a toll free number This field is mandatory if you are unsure what to enter here use the same wording as for the name of the tariff o Description Extended tariff description 3 Click l Save 4 Repeat steps 1 3 until you have entered all of the tariffs 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 9 Porta 4 Switch Prepaid VoIP Services Enter Rates Rates are per destination prices Please refer to the System Concepts chapter 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 1s better HEC Prepaid cards tariff rates Add fel Save 9 Close Tariff amp Log gt Badd i
45. ave amp Close 5 Repeat steps 2 4 until all of your nodes have been entered NOTE There is some propagation delay between the database and the Radius server configuration file but no more than 15 minutes Create 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 HEC Tariff Management gene O 0 0 o tog Type Search OIISEHENEUESONSEMEREN Hame Currency Type Description Rates Delete 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 6 Porta 4 Switch Prepaid VoIP Services HEC Add Tariff fe R Sove el savencose aise Looout B Log Name Prepaid cards Currency USD US Dollar Type Managed by None v General Info Off Peak Period hr 21 7 wd mo fr wd sa su e Off Peak Description From 21 00 until 08 00 Workdays of any month OR Weekend of any month Destination Group Set v Free Seconds Post Call Surcharge o Login Fee 0 Connect Fee o Round Charged Amount XWXKX XXXXX ly Formula Short Description Prepaid cards Description BENHBNEHNENHEHNEHEHEEHEENHENENHEEHEEHENHENHENHENENEHEHEHEHEHEHEEEEHEEHEEHEENNH HE Edit Prepaid cards Tariff in Save fal Save amp Close Close S Download Upl
46. bit Prepaid Cards Account Login E rswordRecovery S 0 o Login Password Change Password Account Info Product Info 1021788568 Recharge Using Voucher Call history iv Carona Prepaid VolP Services Advanced search Batch cards 2006 07 cards 2006 07 cards 2006 07 cards 2006 07 cards 2006 07 AK cards 2006 07 cards 2006 07 cards 2006 07 e ase o y Da revvs o0 i From 1021788569 Eg From Date Eg To Date Call history gt close Download cy Bl cORs togout Account Total Charged Time min sec 13 30 Total Charged Total Credits Total Transactions 2 To Country 353851430615 IRELAND Mobile 1021788569 3 48300 USD 2 18567 USD Description Balance 4 33133 USD Opening Balance 10 00000 USD Charged by Type From To Y Date Time 2006 03 09 09 26 57 All transactions to date 2005 09 15 00 00 00 2000 2006 PortaOne Inc All rights Reserved www portaone com Prepaid Cards product Debit 2005 05 15 00 00 00 2006 05 17 00 00 00 Charged time min sec Amount USD 13 30 0 00 3 48300 2 18567 41 Porta 4 Switch Prepaid VoIP Services Login with the account s web access login and password After that you will be able to see the account s self care menu Choose the date range for which you want to see a list of calls and click Show CDR In the results table you will see call charges a
47. ch czech czech czech czech dial peer voice 201 pots application czech incoming called number 201 port 0 D dial peer voice 202 pots application russian incoming called number 202 port 0 D dial peer voice destination pat Session protoco Session target 2000 2006 PortaOne I nc All rights Reserved www portaone com 60 voip tern 2 l sipv2 Sip server n Dftpi as app porta debitoard tel n pin len O0 n language 1 en n language 2 ru n eet locatrion xu 0 tFftpi sJ tel prompts ru Hn set location en 0 tTUtpr tol prompts en tftpi Jues app porta debitcarg tel pin len 0 language 1 en language 2 cz set location cz 0 tftp set location en 0 tftp tocl porompts oz tcl prompts en Porta I4 Switch Prepaid VolP Services Quintum configuration guidelines To configure RADIUS on the Quintum Tenor first generation you must execute the following commands config config radius To set the authentication port config radius authenticationport p 1812 To set the accounting port config radius accountingport p 1813 To set the ip address replace the ip address with that of the PB 100 master server config radist host p 192 168 100 211 You must set accounting type to 2 one accounting record per call leg config radius accountingtype 2 For mote information on these commands please refer to Section IV Command Line Reference in the Tenor user manual To configure
48. customer will be billed 2000 2006 PortaOne Inc All rights Reserved www portaone com 71 Porta 4 Switch Prepaid Card Reseller Services O Opening balance Starting balance for the customer the default is zero O Customer Class Choose the customer class you have created in the previous step Address info tab o Email Email address for distribution of accounting information After the billing period is over a list of CDRs and other statistics will be sent to this address o Bec Blind carbon copy in email may be used for debug and archiving purposes o Summary only Distribute summary only and do not attach details file could be useful with a vety large amount of calls Additional info tab o Billing period Frequency of distribution of accounting information For more details about different available billing periods see the PortaBilling Administrator Guide Payment info tab O Credit limit If left empty there is no credit limit for this customet User Interface tab o Time zone The time zone in which the customer will see his CDRs and which will also define his billing period For example if you choose Ametrica New Yotk here and the billing period is Monthly the billing period will start on the first day of the month at 00 00 New Yotk time o Web Interface Language The language to be used on the customer s self care web interface 3 Click zl Save amp Close 2000 200
49. duct currency Only tariffs which have the same currency will be permitted in the accessibility list o Managed by If you plan for this product to be used for your reseller s accounts so that the reseller himself can change the parameters of this tariff and create new accounts with this product choose the customer s name from the menu Otherwise choose Administrator only here General Info tab o Breakage Leftover balance which is considered useless for statistical purposes Accounts with a balance below breakage will 2000 2006 PortaOne Inc All rights Reserved www portaone com 9 4 Porta I4 Switch Prepaid VolP Services be counted as depleted This does not affect account authentication or authorization so the account can still make calls if there is enough money left to cover at least the first interval o 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 value is Account self care pre defined ACL which allows all possible operations o Default Discount Plan Leave None as the selected entty since discount plans are typically used for postpaid services Please refer to the description of volume based discounts in the PortaBilling Administrator Guide for more details o Info URL If you have an external server with a description of product features
50. e UpdateVendorBalance 2000 2006 PortaOne Inc All rights Reserved www portaone com 29 Porta 4 Switch Prepaid VoIP Services The CDR is inserted and the vendor s balance is modified Jun 05 18 09 03 Accounting response Jun 05 18 09 03 Done Verify call history for an account To view the CDR of an account go to Customers select the Customer owning the accounts and click on the Accounts icon or alternatively select the Account Info link from the Main Menu You can also go to the account self care page accessible via the Accounts menu item in the Home popup menu The only difference is that account s owner does not have the option of seeing incomplete failed calls when using the self care pages 2000 2006 PortaOne Inc All rights Reserved www portaone com 40 Porta 4 Switch i Accounts of Retail Customer John uro o gn gt E Add Account Generator B Close D Logout SIP Status mil Pages 1 2 CDRs AccountiD Idle days Currency Balance Credit Limit Type 10 00000 10 00000 10 00000 10 00000 fo e fo fo fo fo fe fe 1001740693 1003408685 1007464475 1007524572 1008646084 1009363017 1017255645 1021788569 ANY 2 USD USD USD USD USD 80 10 00000 10 00000 10 00000 4 33133 Product Prepaid Cards Prepaid Cards Prepaid Cards Prepaid Cards Prepaid Cards Debit Debit Debit Debit Debit Debit Prepaid Cards Debit Prepaid Cards De
51. eady exist in Destinations Interval First First billing unit in seconds Interval Next Next billing unit in seconds Price First Per minute price for first interval Price Next Per minute price for next interval Off peak Interval First First billing unit in seconds for off peak time Off peak Interval Next Next billing unit in seconds for off peak time Oo Off peak Price First Per minute price for first interval of off peak time Oo Off peak Price Next Per minute price for next interval of off peak time 09 O O O 0 O NOTE Off peak fields appear only if an off peak period has been defined for the tariff o 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 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 current one PortaBilling will then automatically adjust the time 2000 2006 PortaOne Inc All rights Reserved www portaone com 55 Porta 4 Switch Prepaid Card Reseller Services o Formula Vk Launches the wizard for creating a custom rating formula o Hidden Forbidden or Discontinued These flags are optional 4 Click the l Save button in the toolbar or the m icon on the left end of the tow 5 Repeatif you need to enter more rates Managing rates offline This step is id
52. eakage 0 1 Default Discount Plan None a B Info URL http vww inydomain com prepaid Description Prepaid Cards E 2000 2006 PortaOne Inc All rights Reserved www portaone com 93 Porta 4 Switch Prepaid VoIP Services 3 EF Add Product gt W save ase o ProductName Prepaid Cards l Currency USD US Dollar z Manage By Administrator only El d r r General Info Maintenance Fee 5 Effective From YYYY MM DD immediately E M Edit rr Cards Product lt gt Ada i save fel Ssve amp Close Close B RateLookup PM Logout Log a Pr odug Name Prepaid Cards Managed By Administrator only a General Info Maintenance Fee Online Signup Accessibility Subscriptions Notepad Access Code Info Digits T Delete Edi Node ariff fed cisco cw m j mv ue osn Prepaia cards X E G FJ Edit Prepaid Cards Product gt E Add tel Save fel Saves close Close Bl Ratelookup OD Logout E tog Product Name Prepaid Cards Managed By Administrator only General Info Cisco cw In the Management section of the Admin Index page choose Products 1 On the Product management page click the 3 Add icon 2 Fillin the Add product form o Product name Product object name O Currency Pro
53. ed all of the tariffs Enter Rates Rates are per destination prices Please refer to the System Concepts chapter 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 ec Mike Prepaid Cards tariff rates E Add i Save amp dose Tariff Poot O Effective From Destination Now v Country Interval sec Price USD min T Effective From Destination YYYY MM DD 75 Delete Description First Next First Next i E Zi w e HH24 MESS Edit 2000 2006 PortaOne Inc All rights Reserved www portaone com 65 Porta 4 Switch Prepaid Card Reseller Services ec Mike Prepaid Cards tariff rates E ada i Save cose tail MB tout Effective From Destination Now v Country Interval sec Price USD min T Effective From Edit Destination YYYY MM DD 75 Delete Description First Next First Next fe s HH24 MLSS CZECH REPUBLIC Peak 30 6 0 12 0 12 immediately mo Proper Off Peak 60 60 0 10 0 10 Ood E CZECH REPUBLIC Peak 30 6 0 12000 0 12000 2006 05 25 420 Proper Off Peak 60 60 0 10000 0 10000 23 34 14 1 On the Tariff Management page you will see a list of available tariffs Click the Rates icon next to the
54. emplates are available in PortaBilling a powerful tool for uploading rates from custom format data files However in this particular example we assume that you are preparing data in the default PortaBilling format A rates table may be prepared using a spreadsheet processor i e Microsoft Excel and easily imported into PortaBilling This 1s very convenient if you wish to make many changes For example you might want to increase all prices by 10 1 Ifyou are not in Tariff Management for your tariff go to the main menu click on Tariffs and then click on the tariff name 2 In the Edit Tariff window move the mouse over the Download button and hold it there until a popup menu appears Choose the Now menu item and click on it This will download the current set of rates empty and will also provide you with an overview of the file structure 2000 2006 PortaOne Inc All rights Reserved www portaone com 90 Porta 4 Switch Prepaid VolP Services PIN 3 You will see the File Download dialog and be prompted to save the file or open it from its current location We recommend that you first save the file to the folder you will be using in the future to store tariff data files then open it in Excel 4 You should see something similar to the screenshot below amp 9 File Edit View Insert Format Tools Data Window Help ES Sex D c E amp l tvT 2 OBS BFF 2 MB arial 10 BLU Z2 2 8 a A AB El 420 A B C D E IP G
55. entical to the one previously described in the Basic prepaid service chapter Create a Customer Class Customer class provides the ability to define a group of parameters in a centralized way then apply those parameters to many customers at once If you have already created a customer class that you can use for prepaid card distributors skip this step and go to the next one 1 Inthe Management section of the Admin interface choose Customer Classes 2 On the Customer Class Management page choose Add HEB Add Customer Class gt td Save m saveaciose cose Logout Name Prepaid Card Distributor J Managed by Administrator only v General Info Invoice Template Do not create invoice w Terms Due on receipt Iw Invoice Grace Period 14 Days Invoice Notification Intervals 14 7 3 Invoice Re send Intervals 0 7 14 Re collect Intervals 0 3 10 Suspension Warning Time 15 Days Suspension Time 21 Days Closing Time 35 Days Charge Credit Card When The Billing Period Is Closed Description Prepaid Card Distributor Class 3 Fill in the Name parameter the other fields can be left empty for now 4 Click zl Save amp Close 2000 2006 PortaOne Inc All rights Reserved www portaone com 5B Porta 4 Switch Prepaid Card Reseller Services Create a Reseller The reseller entity you are about to create will define your relationship with a business partner who is reselling your services and will allow him
56. es Also once the billing period is over this email address will be used to deliver of a list of CDRs and an invoice to your reseller o Bec Blind carbon copy in email may be used for debug and archiving purposes o Summary Only Distribute summary only and do not attach details file could be useful with a very large amount of calls Additional info tab o Billing Period Frequency of distribution of accounting information For more details about different available billing periods see the PortaBilling Administrator Guide Payment info tab O Credit Limit If left empty there is no credit limit for this reseller so you will probably want to enter a value here User Interface tab o Time Zone The time zone in which the reseller will see his CDRs and which will also define his billing period For example if you choose America New_York here and the billing period is Monthly the billing period will start on the first day of the month at 00 00 New York time o Web Interface Language The language to be used on the customet s self care web interface 3 Click gl Save amp Close 2000 2006 PortaOne Inc All rights Reserved www portaone com 5 g Porta 4 Switch Prepaid Card Reseller Services Create a Tariff for the Reseller This tariff will be used by the reseller to charge his subcustomers The reseller will perform the actual tariff configuration on the self care interface You just need to prov
57. estPrepaidc 4 Ready Sum 9 92452E 11 A CSV file with information about the new accounts will be attached Tip In case the original email message was lost or accidentally deleted the file containing generated accounts is stored on the slave PortaBilling server in the user porta admin home directory sub directory cards Test everything together Start Radius debug on NAS Make sure the PortaBilling radius server is running Try to make a call and use one of the accounts Browse information in the PortaBilling log file type less var log porta billing log Or alternatively find this call in Trace call then click on View details and View log E um Example of a normal debug session Jun 05 18 04 54 Processing request BE ver1 245 2 4 pid85499 There is a copy of all the incoming attributes in the log NAS IP Address TL93 28a 0 led 2000 2006 PortaOne Inc All rights Reserved www portaone com 3 4 Porta 4 Switch Prepaid VoIP Services ISDN AIDA NAS Port Name NAS Port Type Async User Name 391553211058 The User Name attribute contains the PIN number entered by the user Calling Station Id 114257891107 Service Type Login User h323 conf id 465F5B2B F42F11DA 8274BDD0 75CFFB2D h323 conf id is the unique ID for every call Password h323 1vr out PortaBilling Original CLD 4041234567 This is a special PortaBilling attribute which reports the original access number on
58. fo URL http www rmyliornain com prepaid LN Description Prepaid cards E n Add Product Weekly Fee po p E C Effecti e FOM inmediate YYYY MM DD mn 2000 2006 PortaOne Inc All rights Reserved www portaone com 61 Porta 4 Switch Prepaid Card Reseller Services Gi Edit Prepaid Cards Product gt Gadd save i Save close ose E rate tooku PU Logout B Log a Producgllame Prepaid Cards Managed By Mike Prepaid a General Info Online Signup a M Node Access Code Cisco GW HE Edit Prepaid Cards Product gt B aa ia save id savencose B Cose B Rate tookup MD Logout E Log Product Name Prepaid Cards Currency USD Managed By Mike Prepaid Edit Node Info Digits Tariff Cisco GW Prepaid Cards In the Management section of the Admin Index page choose Products 1 On the Product Management page click the Add icon 2 Fillin the Add Product form o Product name Product object name o Currency Product currency Only tariffs which have the same currency will be permitted in the accessibility list o Managed by Choose your reseller from the list 3 Click l Save 4 Click on the Accessibility tab to edit this product s accessibility Enter node and tariff into the product s accessibility list The reseller will not have access to information about your network and therefore c
59. further independent service management e g creating his own accounts Hes Add Customer gt Ted save i savencose coe Mi ooo Customer Hame Mike Prepaid USD US Dollar Blocked F Type Prepaid Card Distributor Address Info Additional Info Payment Info User Interface Company Mame Contact Mr MS J Phone First Name Fax Last Name Alt Phone Address Alt Contact E mail mike mydomain com BCC Send Statistics Full Statistics w Province State Postal Code Description City Country Region In the Management section of Admin Index choose Customets 1 On the Customer Management page choose 3 Add 2 Fill in the New Customer form Please note that there are several tabs with extra information available on the screen The most important fields are Main form top o Name Short name for this reseller this will be used on the web interface o Currency The currency in which this reseller will be billed O Opening Balance Starting balance for the customer the default is zero o Type Choose Reseller here o Customer Class Choose the customer class you have created in the previous step 2000 2006 PortaOne Inc All rights Reserved www portaone com 57 Porta 4 Switch Prepaid Card Reseller Services Address info tab o Email Make sure you enter the reseller s valid email address here otherwise he will not be able to receive files with the PINs he generat
60. ide him with a framework by pre allocating a tariff i 4 Tariff Management Description Rates Delete Oe na Add Tariff gt i save i Save amp ciose cose Logout E Log Name Mike Prepaid Cards Currency USD US Dollar Type Managed by Mike Prepaid vw General Info Off Peak Period startstop hr 21 7 wd mo fr wd sa su PA E Off Peak Description From 21 00 until 08 00 Workdays of any month OR Weekend of any month Destination Group Set v Free Seconds Post Call Surcharge Login Fee Connect Fee Round Charged Amount XXXXX XXXXX Formula Shor Description Mike Prepaid Cards Tariff Description 2000 2006 PortaOne Inc All rights Reserved www portaone com 59 Porta I4 Switch Prepaid Card Reseller Services E 4 Edit Mike Prepaid Cards Tariff bel save al save a close Close Download amp Upload Rates 9 Test M Logout El Log Name Mike Prepaid Cards Currency USD Managed by Mike Prepaid General Info Web Upload amp Download Off Peak Period startstop hr 21 7 wd mo fr wd sa su e Off Peak Description From 21 00 until 08 00 Workdays of any month OR Weekend of any month Destination Group Set r3 Free Seconds 0 Post Call Surcharge 0 00000 Login Fee 0 00000 USD Connect Fee 0 00000 USD Round Charged Amount XXXXX XXXXX Formula Short Description Mike Prepaid Cards Tariff
61. iff B which will be applied to your reseller s subscribers make sure this tariff is marked as Managed by the reseller Create a prepaid product to be used by your reseller make sure this product is marked as Managed by the reseller Create one accessibility entry for this product using the node you created earlier and tariff B Perform vendor configuration according to the instructions in the Basic prepaid service section Operations to be performed as a reseller Account provisioning Go to the customer self care web page and log in using the credentials provided Create a subcustomer who owns the prepaid cards Generate accounts for this subcustomer Testing Try to make a test call 2000 2006 PortaOne Inc All rights Reserved www portaone com 51 Porta 4 Switch Prepaid Card Reseller Services General and Network Configuration for PortaBilling Please follow the steps described in the Baste prepaid service chapter Create a Tariff for Charging the Reseller This tariff will be used to charge the reseller so it should contain your selling rates for the reseller HEC Tariff Management emma cep PP Logout B tos EEE Ee OS OB HEC Add Tariff gt W save m saveaclose cose Logout Bl too Name Resellers E Currency USD US Dollar iv Type ordinary v General Info Of Peak Period startstopihr 21 7 wd mo fr wd sa su
62. information 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 5 Porta I4 Switch Prepaid VoIP Services 1 In the Management section of the Admin Index page choose Nodes 2 In the Node management window click the S Add icon 3 Fillin the New Node form o Node name A short descriptive name for this node will be used in the select menus o H323 ID h323 id recommended hostname domainname o VoIP Password If you plan for this node to send calls to other nodes where the default Cisco remote IP authentication script 1s used enter cisco here o NAS IP Address IP address of the gateway o Auth Translation rule Leave this empty for now see the Translation Rules section of the PortaBilling Administrator Guide o Manufacturer Select Cisco or Quintum o Type VoIP node type select VOIP GW o RIP proxying Leave the default selection Optimal for more details regarding NAT traversal see the PortaSIP Administrator Guide o Radius Client Select if this node will be communicating with the billing system o Radius Key If this node is a radius client enter the shared sectet here must be the same as that configured in NAS as a key in the radius server configuration o Radius Source IP See the Error Reference source not found section for more information Unless your gateway has multiple netwotk interfaces the value here should be the same as the NAS IP Address 4 Click il S
63. ing web interface and the Edit Tariff screen 12 Click on the Upload button 13 Either enter the name of your file manually or click Browse and choose the file 14 Click l Save amp Close You should return to the Edit Tariff screen where a message will inform you of the status of the import Also you will receive an email confirmation about the tariff upload If any operation failed you will receive the portion of data which was not uploaded as an attachment so you can try to import it later You can verify your work using the Edit Rates feature After you have done so go to the Main Menu by clicking on the Home icon Test the rate configuration optional 1 While in the Edit Tariff window click on the amp Test button to go to the Test Call Rating screen 2000 2006 PortaOne Inc All rights Reserved www portaone com B 9 Porta 4 Switch Prepaid Card Reseller Services ec Test Call Rating Date and Time Now Phone number 17787654321 Simulate call charges based on the call duration O Simulate authorization based on the available funds Call duration 10 10 HH MI SS MESS or SS Test E 2 Type in the phone number for which you would like to test the rating as well as the estimated call duration then click on the Test button E Test Call Rating gt ase o y D 3 yyYY MM DD HH24 MESS Result of the testing Date and Time 2006 05 26 10 48 26 p Formula Ph
64. ion voice lt app name gt check low balance disconnect nocalls no Example call application voice porta check low balance nocalls 2000 2006 PortaOne Inc All rights Reserved www portaone com 49 Porta I4 Switch Prepaid Card Reseller Services 2 Prepaid Card Reseller Services Porta I4 Switch Prepaid Card Reseller Services Setting up a prepaid card reseller service This is vety similar to the general prepaid set up described above Only a few additional comments are necessary Resellers are not allowed to create new tariffs or products In addition to security considerations this is because accessibility to a product must be configured in order to create it properly The person doing this must be well acquainted with your VoIP network structure gateways access lines etc Your reseller will not have this knowledge in fact you will probably not even want to share such information with him Therefore your admin staff will create tariffs and products for him and configure the products accessibility The correct sequence of actions is as follows 1 Create the tariff you will use to charge the resellers Ordinary type 2 Create the customer as a reseller assigning this tariff to him 3 Create tariffs and products for his subscribers making sure that you mark them as Managed by that customer For improved security resellers are not able to view their own rates on the web interface so that you are
65. j Get default set Upload P Logout E tog gt ABCDEFGHIJKLMNOPQRSTUVWXYZ Country Subdivision Description Delete CZECH REPUBLIC v Not Applicable Prague x CZECH REPUBLIC Prague x 4 Click lel Save 5 Repeat for any additional destinations you would like to add Uploading a set of destinations from a file 1 In the Management section of Admin Index choose Destinations 2 Click on Get default set to download a set of destinations as a CSV Comma Separated Values file Ed Microsoft Excel destinations csy JEN File Edit wiew Insert Format Tools Data Window Help Acrobat DOS H SR GRY BE J naru A E A zb Me worm F fe AEENM E D E F 9 4 Action Prefix Country two letter S0 code Description 2 33 AF Froper 93229 AF Kabul 932290090 AF Operator 93321 AF Kandahar 9344000 AF Herat City 9344001 AF Herat City 9344002 AF Herat City 935051 AF hMazar I Eharf 93702 AF Mobile 93708 AF Mobile 355 AL Proper 35538 AL habile 3554 AL Tirana 35542 AL 3 Open this file in Microsoft Excel or any other suitable program Edit the data if required 4 Save the file and close it in Excel 5 Switch back to the PortaBilling web interface and click Upload on the Destinations screen Gi Destinations Upload gt td save tl Savea cose B close MB Logout File C Demo destinations csv 2000 2006 PortaOne Inc All rights Reserved www p
66. l origin and call type define which call leg you are receiving information about 2000 2006 PortaOne Inc All rights Reserved www portaone com 36 Porta Switch Prepaid VolP Services h323 setup time 04 04 44 226 EEST Tue Jun 6 2006 h323 connect time 04 04 44 238 EEST Tue Jun 6 2006 h323 disconnect time 04 09 03 223 EEST Tue Jun 6 2006 The three attributes above define call initiation call connect and call disconnect time respectively h323 disconnect cause 10 This call was disconnected normally the user hung up h323 voice quality e Uu h323 ocont 1d 465F5B2B F42F11DA 8274BDDO 75CFFB2D Acct Session Id 0000063E Acct Input Octets 129836 Acct Output Octets 272020 Acct Input Packets 7387 Acct Output Packets 8398 Acct Session Time 259 Acct Delay Time Q 465RPSBAZ2B FAZELIIDA 9Z274BDDO T7TSCEPFBAD h3s23 T1ncomrng cont a2d subscriber RegularLine gw rxd cdn ton 0 npi 0 4041234567 calling party category g transmission medium req E UND h323 ivr out TPorLaBlilling Sessronrunlock h323 Tvr out Tariff Unknown release source 4 gw rxd cgn Trouco npl 0pDItTlB1T0 qil2425 799 ITQ7 gw collected cdn 16046282508T charged units Q disconnect text normal call clearing 16 peer address 14257891107 info type speech peer id EDO peer if index 218 logical if index 126 acom level 20 coder type rate qT729br8 n
67. lication can perform authentication using the ANI number of an incoming call leg If authentication is successful the IVR does not ask for a PIN and starts with the balance announcement Configuration syntax call application voice app name ani authentication lt yes no gt Example call application voice porta ani authentication yes Normally i ANI authentication fails the IVR will prompt the user to enter a PIN number However this may be disabled so that the script is then used to provide ANI only service Configuration syntax call application voice app name card authentication lt yes no gt Example call application voice porta card authentication no Number translation and abbreviated dialing expansion As a part of the authorization process the IVR application receives a translated destination number from PortaBilling and then initiates an 2000 2006 PortaOne Inc All rights Reserved www portaone com AG Porta I4 Switch Prepaid VolP Services outgoing call to this number instead of the one originally dialed by the customer This permits the following e Applying various number translation schemes on the billing side e g the same access number and the same IVR application can be used fot customers with different dialing habits Customer A may dial the phone number as 0114202123456 while customer B dials it as 004202123456 PortaBilling will apply the respective customer s translation rules and retur
68. ll IVRs support this feature If you choose Empty no password will be assigned for the account and the password check will be switched off during authentication Choosing Empty is recommended by default If you decide to use passwords then please use the Auto generated digits only option since then the password can be entered in the IVR via phone keys o Batch A batch is a management unit for accounts A batch name is alphanumeric You can type a new name here or use the existing name in order to generate more accounts for the same batch Additional Info tab o E Commerce Enabled If checked this will allow your debit card owners to make online payments via the PortaBilling web interface Leave unchecked o Discount Plan Applies a specific discount plan to this group of accounts Leave as Product Default Life Cycle tab O Activation date Account activation date o Expiration date Account expiration date 2000 2006 PortaOne Inc All rights Reserved www portaone com 7 4 Porta 4 Switch Prepaid Card Reseller Services O Lifetime Relative expiration date account will expire on first usage date life time days If you do not want to use this feature leave the field blank User Interface tab oO Login If you choose Account ID default your customer will use his account ID PIN to login to the self care pages If you choose Empty the account owner will not be able to use
69. n the Ctrl field K TIP If you click on the control numbet leftmost column it will be automatically inserted into the Ctrl field 3 Letus assume you would like to unblock accounts and add 5 to their balance You should then click the checkboxes next to Modify balance and Block Unblock enter the balance adjustment value and pick the new account status 4 Click the Update batch button 5 Confirm OK in the popup window NOTE Balance adjustment will be reflected in call history as a separate line 2000 2006 PortaOne Inc All rights Reserved www portaone com 45 Porta I4 Switch Prepaid VolP Services Special features of the PortaOne calling card application Here is a list of features not available in Cisco s standard calling card application app debitcard 2 0 2 8 tc1 including information on how they can be configured in the PortaOne IVR Credit account support PortaOne s IVR application can work with both debit and credit accounts For credit accounts the amount of available funds computed by PortaBilling as credit limit balance is played So for an account with a credit limit of 100 and a balance of 75 the amount of available funds 1s 25 If both an account and a customer have been assigned a credit limit then the available funds for the account and customer will be computed according to this same formula with the smaller amount returned to the IVR ANI authentication PortaOne s IVR app
70. n the normalized number 4202123456 This significantly simplifies configuration of outgoing dial peers on your Cisco gateway since outgoing calls are always in the same format e Translating short dialed numbers e g 101 into complete phone numbets accotding to a list of dialing abbreviations defined for the customer Multi currency support The default Cisco application will always play only one currency i e that associated with the specific language You can change the TTS module configuration so that dollars will be played for English and crowns for Czech but you cannot allow customers with balances in dollars and pounds to access the same gateway and work with the English IVR as some of them are bound to hear the wrong currency name PortaOne s IVR application in tandem with PortaOne TTS modules can dynamically switch the currency announced based on the currency code h323 currency for a particular account supplied by the billing This allows you to use the same access number for products in different currencies Configuration syntax call application voice lt app name gt multi currency lt yes no gt the default setting is no Example call application voice porta multi currency yes Balance announcement suppression This allows you to disable announcement of an account s current balance and instead proceed to prompt for the destination numbet Configuration syntax call application voice app name bala
71. nation Jun 05 18 06 13 Compute maximum call duration for leg Account 59153211058 to destination with funds 10 00000 account funds 10 00000 Based on the account s current balance the maximum call duration is calculated Jun 05 18 06 13 Maximum call duration 9840 announced as 12000 0 14 164x60x0 05 0 20 by rate 93 using 10649831771 as seed Because the rate uses tricky options the announced call duration is different from the real call duration Jun 05 18 06 13 Limited call duration for Debit account enhance call lifetime with 9900s to Mon Jun 5 20 51 13 2006 Jun 05 18 06 13 Enhance lifetime with 1800s to Mon Jun 5 20 51 13 2006 Jun 05 18 06 13 Authentication acknowledge response h323 billing model 1 hs2z3servr 1n Tariff Prepaid Cards h323 1vr in POortaBlLling Cblrl4257991107 h323 Twr ln PortaBilling CompleteNumber 16046282508 h323 3vr in DURATION 9840 h323 return code 0 h323 currency USD h323 credit time 12000 h323 preferred lang en dun 05 X906 U L5 Done This completes processing for the request Jun 05 18 09 03 Processing request BE verl 245 2 4 p1d85499 NAS IP Address Toe Owl Le NAS Port Name ISDN 2 D 23 NAS Port Type Async User Name 59153211058 Called Station Id 16046282508 Callrng Statrion rd 14257891107 Acct Status Type Stop Service Type Login User h323 gw id begemot h3s23 call orrgimn answer h323 call type Telephony Cal
72. nce suppression lt yes no gt Example call application voice porta balance suppression yes 2000 2006 PortaOne Inc All rights Reserved www portaone com 4 Porta I4 Switch Prepaid VolP Services Time announcement suppression This allows you to disable announcement of the maximum allowed call duration and instead just start connecting the call Configuration syntax call application voice app name time suppression lt yes no gt Example call application voice porta time suppression yes Last number redial The customer may redial the last number by simply pressing the star key when beginning to enter the destination number NOTE Once you have already entered some digits of the destination number the star key may be used to reset the current entry and start entering the phone number from the beginning Configuration syntax call application voice app name redial enable lt yes no gt Example call application voice porta redial enable yes Disallow calls when balance is too low If an account s current balance is lower than the breakage threshold specified in the product configuration the IVR may disable outgoing calls There are two ways to block outgoing calls e Play an announcement and disconnect the incoming call leg e Allow the user to dial the destination number but do not actually initiate the outgoing call giving just a fast busy signal instead Configuration syntax call applicat
73. nd other fees such as maintenance fees or refunds if any The report can be also downloaded by clicking the amp Download csv icon Check call history If you want to see a list of all calls going through the system or perhaps only those for some particular destination you can do this in Call Trace Hn Call Trace gt cose obees 173 Destination 5 10 min H323 conf id From 2006 05 15 YYYY MM DD 00 00 00 HH24 MI SS E To 2006 05 16 YYYY MM DD 00 00 00 HH24 MI SS Y Connect Disconnect Duration CLI ani CLD dnis Country Description TOW E I MS Amount Account Customer 2006 05 15 2006 05 15 0 36 0 11820 18667478647765 380674206354 UKRAINE Mobile 22 41 37 22 42 13 USD 18667478647765 PortaOne 18667478647765 380674206354 UKRAINE Mobile 70080515 20060515 0 00 0USD 18667478647765 PortaOne 2006 05 15 2006 05 15 0 11 0 09850 18667478647765 380674206354 UKRAINE Mobile 22 40 03 22 40 14 USD 186674738647765 PortaOne CZECH 2006 05 15 2006 05 15 deuil eeu REPUBLIC Prague 16 27 33 16 27 33 0 USD 38099001 turist cust 2006 05 15 2006 05 15 3122280355252 801056668011 Apollo Phone 15 02 55 15 02 55 z QUSD 3122280355252 ktop est 2 E 3122280355252 801058668011 Apolo Phone A pa QUSD 3122280355252 top est In the Helpdesk section of Admin Index choose Trace a Call Fill in the check phone number form o h323 conf id If you need to trace a specific call enter the h323
74. nnot be changed later o Type Choose Administrator Only here o Off peak Period Defines the off peak period Click on the Off peak period wizard icon to summon the wizard which will help you construct the correct period definition Click Help to get more information on period format definition If you do not differentiate between peak and off peak rates just leave this field blank o Off peak Description Description of the off peak period automatically filled in by the off peak period wizard You do not have to fill in this field o Destination Group Set If you wish to enter rates in the tariff not for each 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 o Free Seconds The number of free seconds granted for each call In order to claim free seconds the length of the call must be at least one billing unit first interval see the Enter Rates section above o Post Call Surcharge Percentage of the amount charged for the call 2000 2006 PortaOne Inc All rights Reserved www portaone com 53 Porta I4 Switch Prepaid Card Reseller Services o Login Fee Amount to be charged immediately after the first user authentication i e after the user enters his PIN o Connect Fee Amount to be charged for each connected call with a non zero duration o Round Charged Amount Ins
75. o Fee Surcharge amount o Effective From Apply the specified maintenance fee only after a certain date no fees assessed until then choose Immediately to start applying charges as soon as possible 3 Click il Save amp Close Create a Subcustomer A subcustomer is an owner of accounts The subcustomer s contact information is used to distribute account usage information call statistics invoices and so on At least one subcustomer object is required to contain the actual accounts prepaid cards ec Add Subcustomer gt m save tel saveaciose B cose Logout Customer Name David Currency USD US Dollar Blocked F Opening Balance Type Retail Customer Class Retail Customer Address Info Additional Info Payment Info User Interface Call Features Company Name Contact Mr MS J Phone First Name JA Fax Last Name Alt Phone Address Alt Contact E mail david email com BCC Send Statistics Full Statistics M Province State Description Postal Code City Country Region In the Management section of Admin Index choose Subcustomers 1 On the Subcustomer Management page choose El Add 2 Fillin the New Customer form Please note that there are several tabs with extra information available on the screen The most important fields are Main form top o Name Short name for the customer object will be used on the web interface o Currency The currency in which this
76. o Loo 16046282508 1420789911077 Stop Login User begemot originate VOLE 04 06 19 533 EEST Tue Jun 6 2006 04 06 24 481 EEST Tue Jun 6 2006 04 09 03 211 EEST Tue Jun 6 2006 eg pe 465F5B2B F42F11DA 8274BDDO 75CFFB2D JFA2FDO63F FA42F11DA 8277BDDO 00000640 156500 129836 7925 7387 50 Q A465F5B2B FA42F11DA 8274BDDO 75CFFB2D RegularLine gipv2 ton 0 npi 0 4 444444444 PortaBilling Original CLD 444444444 PortaBilling Seed 10649791024 PortaBilling Session unlock 70 68 128 186 TAI 70 68 128 186 Urtons0 mpilsUDlITIl81 0T 14257591107 16046282508T rton 0 mnpux 0 75 160462982508 OUront0 4101 0 DpD1321 9720 95 1422517091107 Q normal call clearing l6 16046282508 speech 910 225 Q 20 ino eo 154850 5060 35422 disable og que 364 ms 9T ms OT ms t0 me 610 ms VS ms www portaone com 38 Porta Switch Prepaid VolP Services gapfill with silence 20 ms early packets 14 late packets 23 lost packets 2 Acct Authentic RADIUS Exec Program Log porta balling pl Jun 05 18 09 03 h323 conf id 465F5B2B F42F11DA 8274BDDO 75CFFB2D 4 call id 7F2FD63F F42F11DA 8277BDD0 75CFFB2D0193 28 87 3 4 Jun 05 19 09 03 Found a call in cache with such id Jun 05 18 09 03 Copied account 59153211058 96 deb1t balance 10 00000 of customer
77. oad Rates GS Test _ B Logout E Log Name Prepaid cards Currency USD Managed by None General Info Web Upload amp Download Off Peak Period hr 21 7 wd mo fr wd sa su e Off Peak Description From 21 00 until 08 00 Workdays of any month OR Weekend of any month Destination Group Set v Free Seconds o Post Call Surcharge 0 00000 9 Login Fee 0 00000 USD Connect Fee 0 00000 USD Round Charged Amount XKXXX XXXXX Formula Short Description Prepaid cards Description In the Management section of Admin Index choose Tariffs 1 On the Tariff Management page choose Add 2 Fillin the New Tariff form o Name Short name of the tariff object This is the name you will see later in the select menus o Currency Indicates in which currency the pricing information is defined All pricing information for a single tariff must be defined in the same currency NOTE The currency for the tariff is chosen only once and cannot be changed later 2000 2006 PortaOne I nc All rights Reserved www portaone com 1 7 Porta I4 Switch Prepaid VolP Services o Type If you plan for this tariff to be used for your reseller s accounts so that the reseller himself can edit rates in this tariff choose Managed by NNN where NNN is the reseller s name Otherwise if this tariff 1s for the retail customer s accounts direct customers of your com
78. oise level 4294967237 Volos rx duration 136050 ms tx duration 154970 ms Acc t Authentic TRADIUS NAS Port 0 Exec Program Log porta billing pl Jun 05 18 09 03 h323 conf id 465F5B2B F42F11DA 8274BDDO J5CFFB2D 4 call id Jun 05 187097033 Found a call inm cache with such id Jun 05 18 09 03 Copying access CLD 4041234567 into request s PortaBilling Original CLD attribute Jum 05 18709 03 7 Copied account 591532l105e 96 debrt balanoces9 7 ot customer Prepaid cards distributor 20 balance 0 00000 1imit 2none from 193 28 87 3 into the current request Jun 05 18 09 03 PrepareNexecute GetActiveLegIdByAcct Jun 05 18 09 03 PrepareNexecute DeleteActiveLeg Jun 05 18 09 03 Force unlock requested by NAS Jun 05 L9 09 053 Scheduling 59153211059 for logout call lifetime reduced to 15 For the answer telephony call leg the account debit card session is unlocked since the customer hung up the incoming session thus there will be no more outgoing calls Jun 05 18 09 03 Set lifetime with 15s to Mon Jun 5 18 09 18 2006 Jun 05 18 09 03 Looking up vendor connection Jum 05 18 09 03 Trying to match connection for call Jun 05 18 09 03 Looking for a connection Telephony answer Checking for a PSTN from Vendor connection Jun 05 18309 03 Telephony matching by the node IP 193 29 97 3 port ISDN 2 D 23 and CLD 4041234567 Jun 05 18 09 03 Unknown node IP or no telephony connections for this node Jun 05 18
79. one number X 17787654321 Expanded Formula MIN 1 SEQ 30x1x0 05 amp 6xNx0 05 9 Simulate call charges based on the call duration O Simulate authorization based on the available funds Call duration 10 10 HH MESS MESS or SS Test Charged amount 0 51 USD Real charge history 1x30x0 05 97x6x0 05 3 You will now see the estimated amount charged for this call as well as a detailed explanation of the rating process 4 Press the 9 Close button to return to the Edit Tariff window Modify Product If necessary you may modify certain product parameters e g maintenance fee amounts and scheduling ec Product Management gt dse o y Oooo Search Name Currency Description Prepaid Cards USD Prepaid Cards 2000 2006 PortaOne Inc All rights Reserved www portaone com 69 Porta 4 Switch Prepaid Card Reseller Services ec Edit Prepaid Cards Product gt E save tl Savea cise B cose B ratetookup Logout Product Name ress Cards Currency USD Breakage 0 05000 USD Account Default ACL Account self care Default Discount Plan None Info URL http www mrmydomain com prepaid Description Prepaid Cards cc Edit Prepaid Cards Product gt Tid sive i savea cise cose B ratetookup B Logout Product Name repaid Cards Currency USD E General Info Maintenance Fee Online Signup Subscriptions Notepad Period Weekly Iv Fee 0 05
80. ortaone com 1 4 Porta 4 Switch Prepaid VoIP Services 6 Type in the filename of the file you have edited or click on the Browse button and select the file 7 Click ml Save amp Close Create Nodes This step is only required if you have not entered your gateways into the system before In this case you must enter your gateways as nodes PortaBilling requires some key information about your network equipment such as IP address h323 id Radius shared secret etc HEBZ Node Management Oves Ono al Manufacturer Type RADIUS Client Delete cisco gw mydomain com Manufacturer VoIP peed cisco j Type NAS IB Address 192 168 0 99 IE RTP Proxying Hostngme Icisco gw E Doman mydomain com a Auth fransl Rule RADIUS Client RADIUS Key secret RADIUS Source IP 192 168 0 99 RADIUS Dictionary Cisco E Node Management RADIUS Client O Yes No 9 AI Show Nodes Name h323 id IP Manufacturer Type RADIUS Client Delete tisco qw cisco gw mydomain com 192 168 0 99 Cisco VOIP GW x Microsoft Internet Explorer Submitted information is being cached in the biling engine and will not take effect immediately Default caching time is 10 minutes Please contact your system administrator for more
81. ou first save the file to the folder you will be using in the future to store tariff data files then open it in Excel You should see something similar to the screenshot below File Edit View Insert Format Tools Data Window Help D zc E amp l Y X Bal c o wr 55 MEQ arial 10 BLU F 2 2 8 5 A CZECH REProper 30 6 0 12 0 12 60 60 0 1 0 1 25 07 04 21 28 CZECH RE Mobile 1 1 0 22 0 22 1 1 D 22 0 22 25 07 04 21 35 11 12 I 4 gt MH csv Prepaid cards 1 Ready Name Currency Descriptior Short Description Prepaid caUSD What we c Prepaid cards Off peak P DestinaticFree Seco Post Call Login F Connect Fee hr 21 7 wd mo fr v 0 0 Destinatior DestinaticCountry Descriptior First In Next In First PricNext P Off peak Off peal Off peak Off peak Forbidd Hidder Discont Effective From 420 gt 6 Edit the file by adding more rows with rate data so that it looks like the screenshot below Note that the columns Country and Description are for reference purposes only and are ignored during import Also when using the default template you must fill in the data in the Off peak columns 2000 2006 PortaOne Inc All rights Reserved www portaone com 67 Porta I4 Switch Prepaid Card Reseller Services even if your tariff does not have an off peak period use the clipboard to easily copy values for the four peak columns 7 Also note that you may only use those phone prefixes which you have alre
82. pany or for your termination costs to the vendor choose Administrator Only here o Off peak Period Defines the off peak period Click on the Off peak period wizard icon to summon the wizard which will help you construct the correct period definition Click Help to get more information on period format definition If you do not differentiate between peak and off peak rates just leave this field blank o Off peak Description Description of the off peak period automatically filled in by the off peak period wizard You do not have to fill in this field o Destination Group Set If you wish to enter rates in the tariff not for each 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 o Free Seconds The number of free seconds granted for each call In order to claim free seconds the length of the call must be at least one billing unit first interval see the Enter Rates section above o Post Call Surcharge Percentage of the amount charged for the call o Login Fee Amount to be charged immediately after the first user authentication i e after the user enters his PIN o Connect Fee Amount to be charged for each connected call with a non zero duration o Round Charged Amount Instead of calculating CDRs with a 5 decimal place precision round up CDR amount values e g XXXXX XX000 me
83. py of the script to PortaOne Basic router configuration The latest telephony IOS and DSP firmware is highly recommended It is also recommended that the hostname be the same as h323 id hostname h323 id ip domain name default domain NOTE VSA h323 gw id hostname domain 2000 2006 PortaOne Inc All rights Reserved www portaone com 7 Porta 4 Switch Prepaid VoIP Services NTP NOTE It is very important to have reliable time services Also make sure that the time zone abbreviation is one of the standard ones supported by PortaBilling ntp server lt name IP gt ntp server lt name IP gt ntp master 5 clock timezone your time zone 1 clock summer time your summer time zone recurring your rules AAA aaa new model aaa authentication login h323 group radius aaa authorization exec h323 group radius aaa accounting connection h323 stop only group radius VoIP interface interface your interface to the world h323 gateway voip interface h323 gateway voip h323 id h323 1d NOTE f you want to use a virtual interface then add the line h323 gateway voip bind srcaddr IP Outgoing SIP server Sip ua aaa username proxy auth Sip server dns hostname of your PortaSIP server Enable gateway functionality gateway Enable gateway accounting For older IOS versions gw accounting h323 vsa For newer IOS versions 12 2T or 12 3 gw accounting aaa acct template callhi
84. r releases The online copy of this guide is always up to date and integrates the latest changes to the product You can access the latest copy of this guide at www portaone com resources documentation Conventions This publication uses the following conventions Commands and keywords are given in boldface Terminal sessions console screens or system file names are displayed in fixed width font Caution indicates that the described action might result in program A malfunction or data loss NOTE Notes contain helpful suggestions about or references to materials not contained in this manual X Timesaver means that you can save time by performing the action desctibed in the paragraph OW Tips provide information that might help you solve a problem 2000 2006 PortaOne Inc All rights Reserved www portaone com 3 Porta 4 Switch Prepaid VoIP Services 1 Prepaid VoIP Services Prepaid services enable Internet telephony service providers ITSPs to offer calling card services that customers can pay for in advance The market for prepaid services includes tourists immigrant communities mobile populations such as military personnel and people with limited credit histories who cannot otherwise get a private telephone line in their homes These users can all gain immediate access to long distance or international calling services from wherever they are located by using prepaid calling cards purchased at supermarkets and o
85. ration 1s the same as a failed to decrypt message NAS radius key shared secret PortaBilling replies with Verify product accessibility list and authentication reject account status Debug session looks normal but The most common reason for this NAS hangs up or says nothing is the lack of a particular prompt on after receiving authentication IVR prompt servers This situation confirmation may occur only for specific monetary or time values Account balance not decreased Verify that the NAS is transmitting after successful call and call stop accounting records Set does not appear in call history accountingtype 2 for Quintum or gw accounting h323 vsa for Cisco Advanced prepaid service with roaming Deploying prepaid card products with roaming is easy with PortaBilling Just install additional NAS in different geographical locations and enter the corresponding Nodes in PortaBilling Then create tariffs which reflect yout service charges for different geographical locations and extend the product accessibility list using new nodes and tariffs 2000 2006 PortaOne Inc All rights Reserved www portaone com 43 Porta I4 Switch Prepaid VolP Services Provisioning prepaid accounts PortaBilling account management is based on batches and control numbets A batch is a named set of accounts By giving descriptive names to batches you can keep your accounts well organized Examples of batch names FLEX
86. resentative for a copy All product names mentioned in this manual are for identification purposes only and are either trademarks or registered trademarks of their respective owners 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 Porta 4 Switch Table of Contents Prepaid Billing Prepaid Billing lesser eene eene eene eee 0 PPh CS nosse bean UUEMENEE EUM NEM ME MM R eee 3 1 Prepaid Vol P Servicee scccccsssssscccccesessssssssseeeees 4 Typical prepaid service scenario esee 5 Setting up your network components senes 7 Basic prepaid SOL VIC ane mane snr rem nnn Deen Te M cde 12 Provisioning prepaid accounts uuu sss 44 Special features of the PortaOne calling card application 46 2 Prepaid Card Reseller Services 49 Setting up a prepaid card reseller service sss 50 2000 2006 PortaOne Inc All rights Reserved www portaone com Porta 4 Switch Prepaid Billing Preface This document provides PortaBilling100 users with step by step instructions and examples for setting up various prepaid and postpaid services on a VoIP network Where to get the latest version of this guide The hard copy of this guide is updated at major releases only and does not always contain the latest material on enhancements occurring between mino
87. rvals Re collect Intervals Suspension Warning Time Suspension Time Closing Time Charge Credit Card When The test invoice I Due on receipt 14 Days 14 7 3 0 7 14 0 3 10 15 Days 21 Days 35 Days Billing Period Is Closed Description Enterprise Customer Class 3 Fill in the Name parameter the other fields can be left empty for now 4 Click zl Save amp Close 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 Even if your company owns and distributes all of its prepaid cards you will need at least one customer object for your company 2000 2006 PortaOne Inc All rights Reserved www portaone com 99 Porta 4 Switch Prepaid VoIP Services Hee Add Customer E sive Saveaciose cose toot Customer Name John Prepaid Currency USD US Dollar Blocked C Type Retail Customer Class Prepaid Card Distributor Address Info Additional Info Payment Info User Interface Call Features Company Name Contact Mr Ms J Phone First Name tL Fax Last Name Alt Phone Address Alt Contact E mail jh smartcall com BCC Send Statistics Full Statistics Province State Postal Code City Country Region Description In the Management section of Admin Index choose Customets 1 On the Customer Management page choose 3J Add 2 Fillin the Ne
88. s to be generated o Product Choose the product which you would like your accounts to have 2000 2006 PortaOne Inc All rights Reserved www portaone com 73 Porta 4 Switch Prepaid Card Reseller Services o Blocked It is normal practice to generate all prepaid cards as blocked so they cannot be misused before being sold to the dealer or end customer You can always choose later to activate the whole batch of cards or an individual card O Opening Balance The initial balance on the card Account info tab o Account Type Select Debit for prepaid service o Generation Method Choose Random here this will assign every account a unique randomly generated PIN o ID Prefix If you would like all of the generated accounts to start with the same digit string e g 98 enter it here Thus if you enter 98 and an ID length of 10 account IDs PINs will look like this IINNNNNNNN where N random digits o ID Length All account IDs PINs will be numerical and of the specified length In order to avoid problems with printing prepaid cards PortaBilling will not generate account numbers with a leading zero Also PortaBilling will only allow generation of a batch with feasible parameters e g it is impossible to generate a batch of 1 000 accounts with ID length 4 and ID starting at 55 O VoIP Password To improve secutity you can use an account password during authentication in addition to a PIN Not a
89. service at this location Upon success returns account s 2000 2006 PortaOne Inc All rights Reserved www portaone com 5 Porta 4 Switch Prepaid VolP Services balance and other data Also keeps information about this call in memory to prevent multiple logins with the same account ID If authentication is unsuccessful asks to re enter PIN or hangs up Otherwise tells customer his current balance and prompts him to enter phone number he wishes to call Enters destination number Attempts to authorize call to the destination Sends authorization request using Radius protocol User Name equals PIN Called Station ID equals number dialed by customer Checks that account is allowed to call this destination calculates maximum possible call duration based on account balance and rate for this destination If authorization has failed prompts user to enter another number or hangs up Otherwise tells customer maximum allowed call duration and tries to call destination number Determines call route according to rules dial peers or gatekeeper information attempts to connect the call When call is connected sets timer to the maximum call duration Speaks on the phone Warns customer when he has only 1 minute left and if timer hits zero and customer is still talking disconnects the call After call is disconnected sends accounting information
90. story detail NOTE VSA does not work for all platforms Radius IMPORTANT NOTE Ports 1645 1646 are the traditional Radius ports used by many vendors without obtaining an official IANA assignment The official assignment is now ports 1812 1813 and users are encouraged to migrate to these new ports when possible 2000 2006 PortaOne Inc All rights Reserved www portaone com g Porta 4 Switch call call call call call call call call call call call call l application application application application application application application application application application application application Cisco notes command Keep in mind Defaults in radius server radius server radius server radius server voice card controller voice port Prepaid VolP Services radius server commands will be available only after issuing aaa new model UDP port for RADIUS accounting server default is 1646 see note above UDP port for RADIUS authentication server default is 1645 see note above Default ports for Cisco are 1645 1646 etc services are 1812 1813 host name IP auth port 1812 acct port 1813 key key vsa send accounting vsa send authentication Depends on your hardware configuration call application voice amp dial peers russia russia russia russia russia russia voice voice voice voice voice voice voice voice voice voice voice voice czech cze
91. t user pb root be used for any operations other than initial set up Make sure you are able to login as the newly created user and change the password for the pb root user If you plan to do billing in more currencies than one define them in the Currencies section and specify exchange rates in Exchange Rates Create destinations This step is only required if you have not defined the necessary destinations before There are two ways to insert new destinations into the system e One by one using the l Add functionality on the web interface e Bulk update by uploading destinations from a file NOTE A file with the default destination set is supplied with PortaBilling You can X download it and then upload it to the server However it may be possible that your business requires different types of prefixes so please check the data in the file before uploading Creating destinations one by one 1 In the Management section of Admin Index choose Destinations 2 Click on the amp Add button 3 Fill in the required information This includes the phone prefix and country Country subdivision is optional You can use the Description column to store some extra information 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 3 Porta 4 Switch Prepaid VoIP Services about the destination for example if it is a mobile or fixed number HEB Destinations gt El Add i save Close S Download S
92. tead of calculating CDRs with a 5 decimal place precision round up CDR amount values e g XXXXX XX000 means rounding to cents so that 1 16730 becomes 1 17 o Formula The default rating formula which will be applied to every new rate created in the tariff If you leave this empty old style rating will be used o Short Description 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 For example for a tariff named Cust ABC Easy Call 1800 the short description will provide better information for your reseller ABC who will be using this tariff such as EasyCall via a toll free number This field is mandatory if you are unsure what to enter here use the same wording as for the name of the tariff o Description Extended tariff description 3 Click l Save 4 Repeat steps 1 3 until you have entered all of the tariffs Enter Rates Rates are per destination prices Please refer to the System Concepts chapter 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 HE Resellers tariff rates Badd ted save Cose Taf O
93. ther types of retail outlets 2000 2006 PortaOne Inc All rights Reserved www portaone com 4 Porta I4 Switch Prepaid VolP Services Typical prepaid service scenario In an ITSP internal network infrastructure prepaid services are implemented through a debit card application that works in conjunction with the following VoIP NAS Interactive Voice Response IVR prompt server PortaBilling This combination of services enables a carrier to authorize voice calls and debit individual user accounts in real time Customer interaction Customer dials access number Customer is asked to enter prepaid card number Customer enters prepaid card number Customer is provided with information about current balance and asked to enter destination number Customer dials destination number Customer is provided with information about maximum permitted call duration Call is connected After disconnect Customer s balance is reduced System components interaction Customer GW IVR PortaBilling Dials the access number Accepts the call and launches the IVR Plays voice prompts Welcome asks user to enter his PIN Enters his PIN Attempts to authenticate this PIN Sends authentication request using Radius protocol User Name equals PIN Checks that such account exists in the database that it is not blocked or expired and that it is allowed to use the
94. to create a rate for must already exist in Destinations o Interval First First billing unit in seconds o Interval Next Next billing unit in seconds 2000 2006 PortaOne Inc All rights Reserved www portaone com 1 g Porta Switch Prepaid VoIP Services O Price First Per minute price for first interval O Price Next Per minute price for next interval o Off peak Interval First First billing unit in seconds for off peak time Oo Off peak Interval Next Next billing unit in seconds for off peak time Oo Off peak Price First Per minute price for first interval of off peak time o Off peak Price Next Per minute price for next interval of off peak time NOTE Off peak fields appear only if an off peak period has been defined for the tariff o 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 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 current one PortaBilling will then automatically adjust the time o Formula Vh Launches the wizard for creating a custom rating formula o Hidden Forbidden or Discontinued These flags are optional 4 Click the lel Save button in the toolbar or the lal icon on the left end of the row 5 Repeatif you need to enter more rates Managing rates offline NOTE T
95. u may proceed to the next step Otherwise please consult the instructions in the Create Vendors section of the Basic prepaid service chapter Actions to be Performed by the Reseller At this point you have finished with the administrator part of the work You just need to send the reseller his login credentials for the PortaBilling self care interface while the rest of the tasks described below will be performed by the reseller himself They are listed here for your convenience only normally the reseller will use the instructions in the self care guide Login to Self care Interface Open the customer self care page in a browser by default http lt your porta billing slave server name gt 8444 and type in the usetname password which was provided to you NOTE Sometimes administrators try pressing the Logout button on the admin interface and then logging in using the reseller s username and password This will not work since you are still in the admin realm to which your reseller does not have access You must login from the customer s self care interface Modify Tariff The reseller can adjust various parameters of a tariff e g off peak period or rounding cc Tariff Management Name Currency Description Rates Mike Prepaid Cards USD Mike Prepaid Cards Tariff 5 2000 2006 PortaOne Inc All rights Reserved www portaone com 63 Porta 4 Switch Prepaid Card Reseller Services ec Edit Mike Prepaid Cards
96. w Customer form Please note that there are several tabs with extra information available on the screen The most important fields are Main form top o Name Short name for the customer object will be used on the web interface o Currency The currency in which this customer will be billed O Opening balance Starting balance for the customer default is zero o Type Choose if this is a reseller or retail direct customer Normally most of your customers would be retail customers Only if a customer is reselling your services while you are providing services and billing to his subscribers would he be created as a reseller o Customer Class Choose the customer class you created in the previous step Address info tab o Email Email address for distribution of accounting information After the billing period is over a list of CDRs and other statistics will be sent to this address 2000 2006 PortaOne Inc All rights Reserved www portaone com 30 Porta Switch Prepaid VoIP Services o Bce Blind carbon copy in email may be used for debug and archiving purposes o Summary only Distribute summary only do not attach details file might be useful when the amount of calls is very large Additional info tab o Billing period Frequency of distribution of accounting information For more details about different available billing periods see the PortaBilling Administrator Guide Payment info t

Download Pdf Manuals

Related Search

Related Contents

Operating Instructions  取扱説明書 ご使用前に必ず、ご確認ください  PSH - Manual de Instruções (português).pmd  参考資料です  

Copyright © All rights reserved. Failed to retrieve file