Table of Contents

License Agreement

Program Credits
Software Manual
Payment Method Management
 Configuring available payment methods is quite simple. All of the controls are in the Orders and Payment | Manage Payment Methods function.

If you plan on using the recurring billing function of the software, please refer to the 'Recurring Billing' section at the bottom of this page.

First, you have to decide which type of order process best suits your site. You can choose more than one of the following methods:

Contact Customer

No payments accepted online. The customer is notified that you will contact them via telephone to discuss payment options.

Offline Processing (Credit Card & Switch/Solo Cards)

Collect credit card and/or Switch/Solo card information on your own secure server, encrypt the numbers and then email the primary order email address an encrypted decrypt key. Credit card numbers can then be decrypted using the Manage Online Orders function.

Accept Checks or Purchase Orders

You can allow your users to pay by check or purchase order by presenting them with a printable/faxable version of their order which can be sent in to you for payment.

Process Payments Through PayPal

You can accept payments with your PayPal account. If users don't have their own account, they will be prompted by PayPal to create one.

Process With A Payment Gateway

Collect credit card information on your own secure server and have an online processing partner validate and process the order or use an online processing partner's secure order form for credit card number entry. Both methods are supported and are easilly configurable.

Currently a large listing of payment processors are supported:
  1. Authorize.Net (SIM & AIM)
  2. Cardservice Linkpoint (HTML & API)
  3. Verisign (Payflow Link)
  4. iTransact
  5. WorldPay (WorldDirect)
  6. Bank Of America
  7. Planet Payment
  8. RTware
  9. 2CheckOut (Authnet)
  10. Wells Fargo (Secure Source & BOA)
  11. PaySystems
  12. ViaKlix
  13. GoRealtime.Com
  14. ECHOnline
  15. EFSNET
  16. InternetSecure
  17. Caledon
  18. PlugNPay
  19. SurePay
  20. SkipJack
  21. PSiGate
  22. Netbilling
  23. BluePay (API)
  24. NOCHEX
  25. SECPay
  26. Protx
  27. Spectre
  28. FirstPay
To configure this software package to work properly with your online processing partner's methods, every bit of information that is transmitted can be configured. In some cases, namely the interfaces that do not use a third party payment gateway, it is not necessary to make any modifications.

If you are using a third party payment gateway, you will need to edit the 'Form Content' field to include your login information for that gateway. Login information fields are surrounded by HTML comments:

<!-- ### -->
<INPUT TYPE="HIDDEN" NAME="LOGIN" VALUE="your_username">
<!-- ### -->
You will need to replace the string 'your_username' with the username your processor assigned you.

Since all pieces of transmitted information are configurable and this package is an open source the opportunity is here to configure this package for processors other than those that are provided in the package. There is an insert function available in the administrator utility to allow you to configure a processor that is not currently supported. Just follow a similar processor's entry as an example if you choose to create a new one.

In addition, the secure server payment script is entered in the Global Settings function separately so it is possible to post information from this program to another secure script, even an ASP script on an NT web server. The information collected there can be sent, for validation, off to your online processing partner's site before returning to your non-secure site for order fulfillment. The possibilities are endless. This program is capable, however, of running securely on it's own.

If your selection was to use offline processing, you will need to select the credit cards you wish to accept. The cards indicated here will be selectable in a drop-down box on the credit card entry screen during the order process. If you selected to use an online processing partner's order form this information will be collected on their site.

Setting Up Specific Online Processors

Several online processors are listed below because their setup requires additional configuration using the admin functions on their site or require the entry of a key or password in addition to the entry in the 'Form Content' section of a username. Review the instructions below.

If your processor is not listed below with specific instructions, no configuration on their site using their admin utility is necessary. The following processors do not require additional setup, however do require that your password be entered in addition to your username. Passwords are entered in the 'Transaction Key/Password' field and are encrypted for your security.
  1. SECPay
  2. EFSNET
  3. Protx
  4. Caledon
  5. FirstPay
  6. SurePay
The remaining processors below require additional configuration using the processor's site admin utility. Please check the required module list at the bottom of this section to ensure that your processor does not require any additional software modules or programs to run.

Authorize.Net AIM & Wells Fargo (Authnet Interface)

  1. Login to your account at the processor's site and choose the Settings function.

  2. Under the Settings | Test Mode function, set the system to 'LIVE MODE'.

  3. Under the Settings | Transaction Version function, set the Transaction Version to '3.1'.

  4. Under the Settings | Password-Required Mode function, check the box next to 'Require Password for ALL Transactions'.

  5. Under the Settings | Obtain Transaction Key function, provide your 'Secret Answer' and check the box labeled 'Disable Old Transaction key'. After clicking the submit button, you will be presented with your Transaction Key, which you will need to copy.

  6. Under the Settings | Form Fields function, uncheck every checkbox, then check these two: Invoice # - Required and Customer ID - Required.

  7. Logout of your account at the processor's site and login to the administrator utility.

  8. For the Payment Method select the appropriate payment method.

  9. In the Update Payment Method function set the Active Status to Active.

  10. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea. This allows you to locate it quickly. Replace the string 'your_username' with your processor login.

  11. In the 'Transaction Key/Password' field, enter the Transaction Key you created and copied while using the processor interface.

  12. Click 'Submit' and log out of the administrator utility. You are done.
* Please see the note about additional software at the bottom of this page.

Authorize.Net SIM

  1. Login to your account at the processor's site and choose the Settings function.

  2. Under the Settings | Test Mode function, set the system to 'LIVE MODE'.

  3. Under the Settings | Transaction Version function, set the Transaction Version to '3.1'.

  4. Under the Settings | Password-Required Mode function, check the box next to 'Require Password for ALL Transactions'.

  5. Under the Settings | Obtain Transaction Key function, provide your 'Secret Answer' and check the box labeled 'Disable Old Transaction key'. After clicking the submit button, you will be presented with your Transaction Key, which you will need to copy.

  6. Under the Settings | Form Fields function, uncheck every checkbox, then check these two: Invoice # - Required and Customer ID - Required.

  7. Logout of your account at the processor's site and login to the administrator utility.

  8. For the Payment Method select the appropriate payment method.

  9. In the Update Payment Method function set the Active Status to Active.

  10. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea. This allows you to locate it quickly. Replace the string 'your_username' with your processor login.

  11. In the 'Transaction Key/Password' field, enter the Transaction Key you created and copied while using the processor interface.

  12. Click 'Submit' and log out of the administrator utility. You are done.
2CheckOut

  1. For the Payment Method select the appropriate payment method.

  2. In the Update Payment Method function set the Active Status to Active.

  3. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea. This allows you to locate it quickly. Replace the string 'your_username' with your store id number.

  4. Logout of the administrator utility and open a browser session with your online processor. Login to your account and select the Shopping Cart | Cart Details function.

    Set the value for the field named "Return to a routine on your site after caredit card processed" to "Yes".

    For the "Return URL" field, enter in the full path to your script. Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi

  5. Log out of processor's admin utility. You are done.
WorldPay

  1. For the Payment Method select the appropriate payment method.

  2. In the Update Payment Method function set the Active Status to Active.

  3. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea. This allows you to locate it quickly. Replace the string 'your_username' with your Installation ID from WorldPay.

  4. Logout of the administrator utility and open a browser session with your online processor. Login to your account and select the Settings function.

  5. In the Installations section, click the button under Configuration Options for the Installation ID you want to manage.

  6. On the Configuration Options page, enter the full http path to your script (Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi) in the 'Merchant's Shop URL' and "Callback URL" fields. Then check the boxes next to "Callback enabled?" and "Use callback response?". Click the "Save Changes" button.

  7. Log out of processor's admin utility. You are done.
Cardservice Linkpoint (API Only)

  1. When you signed up for your API processing account at linkpoint, you were provided with a key file. The contents of this key file need to be entered into the file /ccp51/data/keys/linkpoint.txt via FTP for this method to work properly.

  2. No other configuration is necessary for this method (other than entering your storename in the Form Content section of the payment method screen as instructed above).
* Please see the note about additional software at the bottom of this page.

Cardservice Linkpoint HTML

  1. Using the administrator, click on Orders & Payment then select the Manage Payment Methods function.

  2. For the Payment Method, select the appropriate payment method.

  3. In the Update Payment Method function, set the Active Status to Active.

  4. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea. This allows you to locate it quickly. Replace the string 'your_username' with your processor login.

  5. Logout of the administrator utility and open a browser session with your online processor. Login to your account.

  6. Go to Customization then Payment Form Settings and make the following changes:

    Delete any text in the "Recipient's Top" and "Recipient's Bottom" textboxes.

    For the "Order Submission Form URL", enter in the full path to your script. Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi

    For the "Thank You Page URL", enter in the same URL as above and check the boxes for "Check here if this url is a CGI script." and "Check if you wish to automatically display specified URL after the LinkPoint HTML receipt page." Make sure both are checked.

    For the "Sorry Page URL", enter in the same URL as above and check the boxes for "Check here if this url is a CGI script." and "Check if you wish to automatically display specified URL after the LinkPoint HTML receipt page.". Make sure both are checked.

    In the "Custom Fields" section, enter in under the column "Name" for #1: "usrnum" and for #2: "tracknum". There is no need to check the boxes for "Make Viewable" or enter anything in the field "Caption" for either of these "Name" entries.

    In the "Customer's Receipt" section, uncheck the box "Check here if you would like to receive a copy of each receipt". You don't want CardService sending anything to your customer as the software does it for you.

    Click "Submit" at the bottom of the page.

  7. Log out of processor's admin utility. You are done.
Bank Of America & Wells Fargo (BoA Interface)

  1. Using the administrator, click on Orders & Payment then select the Manage Payment Methods function.

  2. For the Payment Method, select the appropriate payment method.

  3. In the Update Payment Method function, set the Active Status to Active.

  4. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea to allow you to locate it quickly. Replace the string 'your_username' with your processor login.

  5. Logout of the administrator utility and open a browser session with your online processor. Login to your account.

  6. Using the processor's admin interface, turn off all notification by email, both to you and the customer.

  7. Change your confirmation pages to custom instead of the default page and make the address for both pages 'http://www.yourdomain.com/cgi-bin/cp-app.cgi' or whatever location you have the program located. Regardless, make this the address for *BOTH* your reject and accept confirmation pages in the custom confirmation pages.

  8. Log out of processor's admin utility. You are done.
Verisign Payflow Link

  1. Using the administrator, click on Orders & Payment then select the Manage Payment Methods function.

  2. For the Payment Method, select the appropriate payment method.

  3. In the Update Payment Method function, set the Active Status to Active.

  4. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea to allow you to locate it quickly. Replace the string 'your_username' with your processor login.

  5. Logout of the administrator utility and open a browser session with your online processor. Login to your account. Select the Account Info function.

  6. Go to General - Edit Configuration and make the following changes:

    For Return URL Method, choose POST.

    For Return URL, enter the full http path to your script. Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi

    For Required Fields, check the boxes for Name, Address, City, State, Zip, Country and Email.

  7. Go to Security Options and make the following changes:

    Add the full http path to your script as an "Accepted URL". Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi

  8. Click the submit button at the bottom of the page to update your settings.

  9. Log out of processor's admin utility. You are done.
ECHOnline Credit Card & eCheck

  1. There is no configuration needed using the ECHO administrator utility - just be sure to have your ECHO merchant id and password that were issued to you.

  2. Login to the administrator utility.

  3. For the Payment Method select the appropriate payment method.

  4. In the Update Payment Method function set the Active Status to Active.

  5. Now drop down to the Form Content section and edit the initial value field for your merchant id. This hidden form field is surrounded by HTML comments at the top of the form content textarea. This allows you to locate it quickly. Replace the string 'your_username' with your merchant id.

  6. In the 'Transaction Key/Password' field, enter the password you have been issued for your merchant id.

  7. Click 'Submit' and log out of the administrator utility. You are done.
* Please see the note about additional software at the bottom of this page.

Planet Payment & RTware

  1. Using the administrator click on Orders & Payment then select the Manage Payment Methods function.

  2. For the Payment Method select the appropriate payment method.

  3. In the Update Payment Method function set the Active Status to Active.

  4. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea. This allows you to locate it quickly. Replace the string 'your_username' with your processor login.

  5. Logout of the administrator utility and open a browser session with your online processor. Login to your account and select the Settings function.

  6. Select the General Connection Setup function, then Response String Version. Ensure that the response string version is set to 3.1.

  7. Under the General Connection Setup function, select the Referrer URLs function. Choose to add a URL and on the following page, enter the full http path to your script.

  8. Under the General Connection Setup function, select the Response/Reciept URLs function. Choose to add a URL and on the following page, enter the full http path to your script. You do not need to make this a default Recipient Link or Relay Response URL, but it's acceptable if you choose to do so.

  9. Under the Payment And Receipt Forms function, select the Receipt Method function. Select to use a POST receipt method. Enter the full http path to your script in the Recipient Link URLs field.

  10. Under the Payment And Receipt Forms function, select the Form Fields function. There uncheck every checkbox, then check these two: Invoice # - Required and Customer ID - Required.

  11. Under the Automated Direct Connect function, select the ADC Relay Response function. Enter the full http path to your script in the URL field.

  12. Under the Security function, uncheck the Require Password For All Transactions box.

  13. Under the Email Receipts function, uncheck the Email Transaction Receipt To Customer box.

  14. For the CVV2 Verification and Address Verification functions, select levels that you feel comfortable with.

  15. Log out of processor's admin utility. You are done.
SkipJack

  1. Login to your account at the processor's site and choose the 'Preferences' function.

  2. Select the 'Response Files' function.

  3. Click the 'Send Customer to the following WebPages/URLs' radio button and in the four text boxes provided under that button, enter in the full path to your script. Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi. The same entry goes in all four text boxes.

  4. Logout of your account at the processor's site. You are done.

PSiGate

  1. Integration with PSiGate is simple and only requires you to choose the correct payment method (payment form or secure server) via the administrator. Remember to enter in your Merchant ID in the administrator's Form Content section for the method you choose.

  2. The default PSiGate response method is a GET response. If you have changed this to a POST response at PSiGate, change back to GET.

  3. PSiGate regulations specify that you must inform them whether you will be using their payment form or your own secure server to collect credit card information. Inform them of the method you're using and PSiGate will configure your account correctly.

NetBilling

  1. Under the Fraud Controls function, choose the Fraud Defense sub-function. Under the Enable Fraud Defense heading, make sure that Fraud Defense is Enabled. Under the Order integrity heading, make sure 'Enforce order integrity' is checked. Copy the Order integrity key as you will need it later. Make any other changes to these settings you wish. Click the Apply button.

  2. Under the Security function, choose the Access Security sub-function and for Payment Form Interfaces, make sure that 'Enable Payment Form V2.x (Universal) interface' is checked. Click the Apply button.

  3. Under the Setup function, choose the Website tools sub-function and click 'Browse Sites'. Choose to add a new site at the bottom of the list. Enter a Site Tag, Site Name and URL. Make note of the Site Name you choose. The URL used here is for reference only, so you can enter your main site URL here (not the full http path to cp-app.cgi).

  4. On the same page, next to the site you've added, click the 'Config' link. On the following page, enter your name, phone and email address in the Website Information section. Then, in the Default payment form settings section, enter the full path to your script for the Return URL and GiveUp URL fields. Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi. Also, set the Return Method to POST and the Postback CGI URL to blank. For the Payment options field, make sure 'Accept Credit Card payments for this site' is checked and the Payment Form field is set to the default for your Site Name. Click the Apply button.

  5. Return to the Setup function, then choose the Website tools sub-function and click 'Browse Sites'. Next to the site you added previously, click the 'Email' link. On the following page, in the Email templates sent to merchant section, enter your email address in the 'To' field, and select the any email templates for your site you wish to use for the Standard receipt and Decline notice emails (if you don't want to use the default templates). Click the Apply button.

  6. Logout of your account at the processor's site and login to the administrator utility.

  7. For the Payment Method select the appropriate payment method.

  8. In the Update Payment Method function set the Active Status to Active.

  9. Now drop down to the Form Content section and edit the initial value field for your processor login. This hidden form field is surrounded by HTML comments at the top of the form content textarea. This allows you to locate it quickly. Replace the string 'your_accountnum:your_sitename' with your account number, followed by a colon (:) followed by the Site Name you created using the NetBilling administrator.

  10. In the 'Transaction Key/Password' field, enter the Crypto Hash you copied while using the processor interface.

  11. Click 'Submit' and log out of the administrator utility. You are done.
CyberSource

  1. For the Payment Method select the appropriate payment method.

  2. In the Update Payment Method function set the Active Status to Active. With this processor integration (because a custom script is generated by the processor for you) there is no need to enter your Merchant ID in the Update Payment Method interface.

  3. Logout of the administrator utility and open a browser session with your online processor. Login to your account and select the Settings menu option.

  4. Access the Account Information function in the Settings menu.

  5. In the 'Process Payment Transactions' section, select 'Hosted Order Page (HOP)' from the drop-down menu.

  6. In the 'Duplicate Order Check' section, select 'Decline duplicate orders' by checking the box next to that option.

  7. In the 'Shopping Cart' section, select 'ClickCartPro' from the drop-down menu. If 'ClickCartPro' is not listed, select 'Other' then enter 'ClickCartPro' in the text box below the drop-down menu.

  8. Click the 'Update' button at the bottom of the page.

  9. Access the Hosted Order Page Settings function in the Settings menu.

  10. In the 'Simple Order POST' section, select 'Do not show the Hosted Order Page to my customers' by checking the box next to that option.

  11. In the 'Payment Details' section, de-select 'Display Tax Amount' by un-checking the box next to that option.

  12. In the 'Payment Types | Credit Cards' section, select all credit cards you wish to accept by checking the box next to each card name. In addition, check the 'Display' box for each CVV/CID/CVN option and un-check the 'Require' box for each CVV/CID/CVN option.

  13. In the 'Billing Information' section, check the 'Display' box and un-check the 'Edit' box for the Billing Fields.

  14. In the 'Shipping Information' section, check the 'Display' box and un-check the 'Edit' box for the Shipping Fields.

  15. In the 'Appearance | General' section, enter your company name in the 'Company Display Name' field and select the color scheme you wish to use by choosing it from the 'Color Scheme' drop-down menu.

  16. In the 'Appearance | Order Page' section, enter any HTML you wish to use for the 'Header' and 'Footer'. Leave the 'Background Image URL' field blank.

  17. In the 'Appearance | Receipt Page' section, enter the full http path to your script (Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi) for the 'Receipt Response URL' field.

  18. In the 'Appearance | Decline Page' section, enter the full http path to your script (Example: http://www.yourdomain.com/cgi-bin/cp-app.cgi) for the 'Decline Response URL' field.

  19. In the 'Email | Addresses and Options' section, check the box next to the 'Send Merchant Receipt Email' field and enter your email address in the merchant's 'To Address' field. Un-check the box next to 'Send Customer Receipt Email'. For the customer email section, you can leave the 'From Address' and 'From Name' fields blank.

  20. In the 'Email | Appearance' section, you can leave the 'Header' and 'Footer' fields blank.

  21. Click the 'Update' button at the bottom of the page.

  22. Access the Security Keys function in the Settings menu.

  23. In the 'Generate HOP Script' section, select the Perl option, and save that script to your computer's hard disk drive. Make a note of the location of that script. It's named 'HOP.pm'.

  24. Access the Smart Authorization function in the Settings menu.

  25. In the 'Smart Authorization' function, there are quite a few options for fraud settings. Set those authorization fields to whatever level you feel most comfortable with.

  26. Click the 'Update' button at the bottom of the page.

  27. Log out of processor's admin utility.

  28. Open up an FTP session with your domain and browse to the ./cgi-bin/library/modules_lib directory. Upload the 'HOP.pm' file you saved to your computer's hard disk drive to this directory on your webserver. Make sure you upload this file in ASCII mode. If you are using a Unix/Linux server, be sure to set permissions on this file to level (chmod) 755. There is no need to adjust permissions levels on Windows server installations.
Additional Software Needed For Some Processors

The following processors integrations require the installation of non-standard Perl modules. The modules that need to be installed by the administrator of the webserver are: Crypt::SSLeay, HTML::Parser, HTML::Tagset, IO::Socket::SSL, libnet, libwww-perl, MIME::Base64, Net_SSLeay and URI. If you attempt to set up a connection with or otherwise use one of the following processors without these modules installed, a 'protocol not supported' error message will be presented.
  1. Authorize.Net (AIM Only)
  2. Wells Fargo (Secure Source Only)
  3. ECHOnline
  4. EFSNET
  5. Caledon
  6. SurePay
  7. BluePay (API)
  8. FirstPay
The following processor integrations require the use of the program cURL. This program is freely available as are the Perl modules above. If you are using a processor that uses the cURL program, ensure that you have the correct path for cURL set up in the Global Settings | Manage Program Settings function.
  1. Cardservice Linkpoint (API Only)
Recurring Billing

This software supports recurring billing transactions. For all payment methods that support recurring billing, the order process is exactly the same for customers.

Manual recurring billing requires that the store owner process the recurring transactions manually either by charging payment cards or sending invoices to customers on a recurring basis. The following payment methods support manual recurring billing:
  1. Contact Customer
  2. Offline (Credit Card)
  3. Offline (Switch/Solo)
  4. Check Payment
  5. Purchase Order
Fully automatic recurring billing requires no action by the store owner to process recurring transactions. As part of the order process, the recurring transactions are set up with the processor and automatically set to occur. The following payment methods support fully automatic recurring billing:
  1. Cardservice Linkpoint API - Secure Server
  2. PayPal - Payment Form
Semi automatic recurring billing requires initial action by the store owner to process recurring transactions. As part of the order process, the recurring transactions are set up with the processor, but need to be activated by the store owner. The following payment methods support semi automatic recurring billing:
  1. Authorize.Net AIM Credit Card - Secure Server
  2. Wells Fargo (Authnet) Credit Card - Secure Server
For these semi automatic recurring billing payment methods, follow the instructions below to activate the recurring billing:
  1. Login to your account at the processor's site and choose the Settings function.

  2. Once transactions have settled, access the 'Search and Download' function and search for the transaction you would like to make recurring. All transactions initiated by the software that should be made recurring have an order number ending with an 'R'.

  3. When you choose to view the Transaction Detail page for the order, you will see a link named 'Create ARB Subscription from Transaction'. Click this link and complete the 'Create New ARB Subscription' form to set the transaction up as recurring.

    Please note: As part of the order process, the first month's payment is made to set the order up on the Authorize.net system. You will need to start date to one month in the future to avoid double billing for the first month.


© 2003 Kryptronic, Inc. All rights reserved. This program is distributed under license. The license agreement includes terms and conditions as well as copyright information. ClickCartPro and Kryptronic are registered trademarks of Kryptronic, Inc.

Click here for more information on ClickCartPro.