Topshopper Classic Administration

Configuration Guide
(Use the 'Update' button at the bottom of the Configuration Script to save new settings)

Field Usage Explanation
Security Code There are two types of security code. One gives a thirty day free trial and the other enables the TopShopper Classic scripts to be used without limit on one domain only. Register for your permanent security code.
User Name Choose a personal username
Password Change your password here.
Shopping Cart Header Image (URL) Enter the URL, relative to site root, of an image banner to be displayed at the top of your cart.
e.g. /images/header.gif
Recommended maximum width is 660 pixels.
If this is left blank then your Merchant Name will be displayed instead.
Shopping Cart Footer Image (URL) Enter ther URL, relative to site root, of an image banner to be displayed at the bottom of your cart.
e.g. /images/footer.gif
Recommended maximum width is 660 pixels.
If this is left blank then your Merchant Name will be displayed instead.
URL of Shop Front Script
Enter the URL, relative to site root, back to your shop front.
e.g./shopcart/shoptest/index.asp
URL of Shopping Cart Script
Enter the URL, relative to site root, to your Cart script.
Default =/shopcart /cart.asp 
URL of Check Out Script Enter the URL, relative to site root, to your Checkout script.
Default =/shopcart /checkout.asp
URL of Invoice Script
Enter the URL, relative to site root, to your Invoice script.
Default =/shopcart /invoice.asp
URL of Mailing Script Enter the URL, relative to site root, to your Mailing script.
Default =/shopcart /mailer.asp

URL of Terms & Conditions for Shoppers

Enter the URL, relative to site root, for a page that contains the terms and conditions of your transactions. Default =/shopcart /terms.asp. A default set of terms and conditions is included in this script and is found at /shopcart/includes/inc_terms.asp. These may be sufficient for your needs. If not, you can edit them. Edit carefully without disturbing any ASP scripting. Or simply enter the URL of your own terms.
URL of Directory for 'List' images

If you use 'Dynamic Lists' they can be made to provide links to images of the products in the list. See Integrator's Guide. If this is left blank then the 'dynamic list' omits the image icon. Default=/shopcart/shoptest/images.
Leave this blank if Dynamic Lists are used but no images are provided.

Merchant/Company Name Enter your company name here. It will be displayed in the cart.
Telephone Sales Number Enter a telephone contact number here. Particularly important for merchants who wish to collect credit/debit card information over the phone.
Merchant Identifier Code Leading Letters for Invoice Reference numbers
Default= AA (e.g AA1254)
. Enter some characters that will form the leading letters for the invoice number.
Sales Administrator's E-mail Address
(To Address)
Enter the email address to which purchase requests are sent.
e.g. admin@somedomain.com
This must not be the same address as the Merchant's E-mail address.
Also if both the Sales Administrator's and Merchant's e-mail addresses are redirected to the same place this can cause problems.
Merchant's E-mail Address
(From Address)
Enter the email address of sales department
e.g. sales@shopdomain.com
This will be the address from which the emails to shoppers will appear to come.

It must be an email address having the same domain as the shop. If it is not the same, many e-mail clients will reject the emails sent as SPAM.
Currency Symbol The symbol to use infront or any money value. e.g. £ or $.
Font Face Enter the name of the font face to be used. e.g arial. If this is left blank then the default font is displayed.
Font Size Enter the size of the font to be used e.g 2 If this is left blank then the default font size is displayed. You are recommended to use size 1 to 3 only.
Font Colour
Format #rrggbb

Enter colour of the font. This must be in format #rrggbb .
Only use hex digits - 0 1 2 3 4 5 6 7 8 9 a b c d e f
where '00' is zero intensity and 'ff' is maximum intensity.
For web safe colours only use - 00 33 66 99 cc ff
e.g. #ff0000 = red, #00ff00 = green, #0000ff = blue
      #ff00ff=yellow, #00ffff = greeny blue(cyan) etc.

Background Colour
Format #rrggbb (Leave blank for transparent)

Enter colour of the background. Format #rrggbb .
Only use hex digits - 0123456789abcdef
e.g. #cccccc = light grey, #000066 = dark blue

Highlight Colour
Format #rrggbb
Enter colour of the highlighted cells. Format #rrggbb
Only use hex digits - 0123456789abcdef
e.g. #660000 = dark red, #ccffcc = light green
Navigation Image Set Choose your navigation image set. When you update you will see the new image type.
Post & Packing State (On or Off) Switch on post & packing here. If it is 'off' then postage is shown as 'included'.
Postage Calculator Source
(Post Unit or Invoice Total)
Choose the source for calculating postage.'Post Unit' allows postage costs related to individual items. 'Invoice Total' relates postage costs to the total amount of the invoice.
VAT State

You can switch VAT on here. The system uses VAT Vectors & Codes. See Integrator Guide for more details

VAT on Postage (Yes or No) and rate(%) Switch on VAT for postage here. Sending articles by courier normally attracts VAT

Mail Component set up
Mail Component (Default CDONTS) Choose an Email Component that is supported by your Server. Use the Diagnostic script (/shopcart/system/diagnostic.asp) to find which email components are supported by your server.
SMTP Mail Server (Not required for CDONTS) Enter the name of the local SMTP Mail Server (Default = 'localhost')

Payment Handling (Choose methods to be made available to shopper)
Cheque by post If this is switched on, the merchant's address is displayed on payment page.
Credit/Debit Card over the telephone If this is switched on, Merchant's telephone number is displayed on payment page.
Credit/Debit Card via on-line secure server If this is switched on, the shopper is invited to proceed to a secure server for payment by credit card. You will need to set up the secure server as described in the Integrator's Guide.
URL of Merchant's Credit Card Handling Script
URL to secure server script. e.g. https://yoursecureserver.com
This script can be either the one provided by TopShopper or your own.
Payment via WorldPay If this is switched on, the shopper is invited to proceed to WorldPay for payment by credit/debit card.
WorldPay Installation ID Parameter required by WorldPay
WoldPay Test Mode Value Parameter required by WorldPay e.g 100=testing, 0=live
WorldPay Currency Code Parameter required by WorldPay
Payment via PayPal If this is switched on, the shopper is invited to proceed to
PayPal
for payment by credit/debit card.
PayPal Merchant ID (email address) Parameter required by PayPal
PayPal Currency Code Parameter required by PayPal
Payment via NOCHEX If this is switched on, the shopper is invited to proceed to
NOCHEX
for payment by debit card only. Used a lot by users of eBay
NOCHEX Merchant ID (email address) Parameter required by NOCHEX
Return URL Parameter required by NOCHEX
Payment via SECPay If this is switched on, the shopper is invited to proceed to
SECPay
for payment.
SECPay Merchant ID This is your SECPay username (usually six letters followed by two numbers)
Callback

This is the location on your server that SECPay is required to call when they have completed the authorisation process.
When two static pages are used the entry will be of the form:
http://www.yourserver.com/authorised.html;http://www.yourserver.com/declined.html
When a dynamic page is used, the enty will be a single url to the dynamic page.

Test Status

The test_status is used to stimulate either an authorised or declined response from SECPay so that you can confirm that your web application behaves appropriately in each instance.

true  : Simulate an authorised callback without contacting the bank.
false : Simulate a declined callback without contacting the bank.
live   : Send the transaction to the bank for authorization.

Payment via Protx If this is switched on, the shopper is invited to proceed to
Protx
for payment. It uses Protocol 2.22.
Protx Vendor Name Vendor Login Name. Used to authenticate the Vendor - maximum 20 characters. The Vendor uses the same Login Name to examine their transaction records.
Protx Encryption Password Protx Encryption Password. It is recommended that you ‘copy & paste’ this code word from the email you were sent or from the details in your account on the Protx website. Typing an O(oh) instead of a 0(zero) causes failure to decrypt the information properly and error messages appear. This Encryption Password is NOT the same as your login password.
Transmission Type Describes the type of payment being initiated. A "Payment" are settled immediately, "Deferred" are settled once released by the Vendor. "PreAuth" are not charged to the card, the card and amount are simply validated. These are generally only used with repeat payments. The default is 'payment'
Protx Currency Code

Three-letter currency code to ISO 4217.The currency must be supported by one of your VSP merchant accounts (having been established with your acquiring bank) . Examples: "GBP", “EUR” and “USD”

Protx Test Status

Simulator/Test Server/Live. After signing up for Protx they will provide details for the use of their Simulator using the account name and password they supply. When you are happy with this, change to the Test Server. However, you need a Test Server account to be set up for you by the Protx Support team. When everything is working, select 'live'. When 'live' is selected, funds will be deducted from valid credit cards.


Promotions
Promotions Code 1
Customers using this code at the Checkout will receive discount on their invoice. The discount will be applied to all items in the cart.
Promotion Discount 1(%) Enter the amount of discount for Promotion Code 1. Do not enter the'%' sign
Promotions Code 2
Customers using this code at the Checkout will receive discount on their invoice. The discount will be applied to all items in the cart.
Promotion Discount 2(%) Enter the amount of discount for Promotion Code 2. Do not enter the'%' sign
   
(Use the 'Update' button at the bottom of the Configuration Script to save new settings)