Cisco BBSM 5.3 Configuration Guide
15 - Configuring Credit Card Billing
Download this chapter
15 - Configuring Credit Card Billing15 - Configuring Credit Card Billing
give_us_feedback

Table Of Contents

Configuring Credit Card Billing

Configuring the Credit Card Server Options

Entering the Merchant ID

Testing the Credit Card Interface


Configuring Credit Card Billing

If you are using credit card billing, you must configure a credit card authorization server by using the Credit Card Server web page on WEBconfig. This section also describes how to enter the merchant ID for each site and test the credit card interface.

As of BBSM 5.3, the credit card policy changes. Previously, the policy would terminate the user's session when he or she exceeded the authorization amount. (The authorization amount defaults to $10.00.) Now, the end user is never disconnected, even if he or she exceeds the authorization amount.

You must modify the approval amount to meet your needs. Most credit card companies, including the CyberSource billing server that is used on BBSM, do not allow charges to be posted in excess of the approval amount. If you are charging $0.50 per minute and your average user stays online for 30 minutes, you probably want to use about $30 to $50 for your approval amount so the charges will post even for above average users. The approval amount is the most you can charge one user for his or her Internet session.

The approval amount is set in the page. For instructions on modifying this value, refer to the Cisco BBSM 5.3 SDK Developer Guide.

Configuring the Credit Card Server Options

Follow this procedure to configure the credit card billing options.

Step 1 From the Dashboard, click WEBconfig. The BBSM Server Settings web page appears.

Step 2 In the NavBar, navigate to the Credit Card Servers web page by choosing Billing > Credit Card > Server. The Credit Card Servers web page appears. (See Figure 15-1.)

Figure 15-1 Credit Card Servers Web Page

Step 3 Configure the credit card options, as described in Table 15-1 and click Save.

Table 15-1 Credit Card Server Options

Field
Description

Billing Server

Enter the IP address or FQDN for the credit card server.

Connect Timeout

Enter the number of seconds during which BBSM attempts to connect to the credit card server. The default is 30 seconds.

Buttons

Defaults

Displays the default parameter settings.

Requery

Refreshes the web page (click before saving changes).

Save

Saves the changes made to the web page.


Entering the Merchant ID

If you are using credit card billing, you must specify the merchant ID for the credit card server by using the Credit Card Site web page. Follow this procedure to enter this ID.

Step 1 From the Dashboard, click WEBconfig. The BBSM Server Settings web page appears.

Step 2 In the NavBar, navigate to the Credit Card Server web page by choosing Billing > Credit Card > Site x. The Credit Card web page appears. (See Figure 15-2.)

Figure 15-2 Credit Card Site Web Page

Step 3 Enter the merchant ID and click Save. This identifier specifies the merchant, such as the hotel or hotspot owner, that originates the charges being sent to the credit card billing service provider, such as CyberSource. If the credit card billing service provider is CyberSource, the merchant ID must be alphanumeric and a maximum of 30 characters. Other credit card billing service providers may have different rules for the format of the merchant ID.

Note For the ICS Credit Card accounting policy that ships with BBSM, the merchant ID has to match the name of the key files generated under c:\opt\ics\keys directory.

Testing the Credit Card Interface

Follow this procedure to test the credit card interface before deploying BBSM. (BBSM performs credit card authentication and billing through the CyberSource ICS billing server.)

Step 1 Set up an account for testing. At the CyberSource website, www.cybersource.com/register, fill out the form to obtain the free testing account.

Step 2 Wait for a response email from CyberSource that contains the merchant ID.

Step 3 Download the ecert program from CyberSource and use it to create the needed keys.

a. From a DOS window, navigate to the c:\opt\ics\keys directory.

b. Enter this command:  Ecert <merchant ID>.

See the following example:

C:\opt\ics\keys>ecert sclink1
The application will now send the newly created key pair and
certificate request to the server.

Merchant id, sclink1
Server host name, setup.ic3.com
Server port number, 80

This process will add your new keys into the test environment.

Certificate generation completed successfully

Merchant password data written to, C:\opt\ics\keys\sclink1.pwd
Merchant certificate data written to, C:\opt\ics\keys\sclink1.crt
Merchant private key data written to, C:\opt\ics\keys\sclink1.pvt
Server certificate data written to, C:\opt\ics\keys\
CyberSource_SJC_US.crt

You are now ready to access the CyberSource test server. Upon request
CyberSource will activate your newly generated keys in the production
environment. At that time a CyberSource employee will verbally confirm your
password as given below, please make a note of it.

Certificate generation verification password, 9999-9999-9999-99999-99999

C:\opt\ics\keys>

Step 4 On the Dashboard, click WEBconfig. The BBSM Server Settings web page appears.

Step 5 Enter the billing server address and connect timeout:

a. Navigate to the Credit Server web page by choosing Billing > Credit Card > Server.

b. In the Billing Server Address field, enter the IP address of the signed credit card server; for example, ic2test.ic3.com.

c. In the Connect Timeout Seconds field, enter the number of seconds that the credit card attempts to validate a credit card before rejecting the end user's input and click Save.

Step 6 Enter the currency type:

a. On WEBconfig, click BBSM Server Settings. The BBSM Server Settings web page appears.

b. From the drop-down menu, enter the local currency type that the credit card server uses. The default is USD and click Save.

Step 7 Enter the merchant ID:

a. Navigate to the Credit Server web page by choosing Billing > Credit Card > Site x.

b. In the Merchant ID field, enter the merchant ID and click Save.

Step 8 Choose the appropriate page set—Minute ICS or MinuteICSClear:

a. Navigate to the Access Points or Switches web page (depending on you usage) by choosing Network Elements > Access Points (or Switches) > Site x.

b. To access the Network Element Port Settings pop-up window, click Port Settings.

c. From the Page Set drop-down menu, choose MinuteICS or MinuteICSClear:

–If you have SSL installed, choose MinuteICS.

–If you do not have SSL installed, choose MinuteICSClear.

d. Click Save.

Step 9 From a laptop, verify that you can access the Internet through the Credit Card page:

a. On a client connected to BBSM, open the browser. The Credit Card window appears.

b. Enter names and addresses. Each field on the form must be filled in, although the data does not have to be real.

c. For the Credit card number, enter 4111111111111111 (the number 4 followed by 15 ones)

d. For the expiration date, enter 2005.

e. Click Submit. You will soon be connected to the Internet. When you have accessed the Internet, browse for 2 minutes and then disconnect.

Step 10 Verify successful transactions on the CyberSource side:

http://icstest.ic3.com/cs/search_request.pl

a. Use your merchant ID and password to login.

b. Do a search for ALL, Today's Requests.

c. Check under services that you get an Auth and a Bill.