Configuration Guide

Topshopper Remote Administration

Configuration Guide

Field

Usage Explanation

Password

Change your password here. If you forget it, click on 'Forgot your password?' on the login page.

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 Address

Enter a contact address here. This also appears on the invoice page.

Security Encryption
(Default = 'on')

This is used to help secure your shop against misuse. When encryption is on, an encrypted version of the product data is added to the button parameters. This will prevent all but the most persistant hacker from corrupting the information sent to the cart e.g. changing the price of the product. The default condition is 'on'. The system will work with this parameter 'off' but it should be left on unless you have a specific reason for switching it off. If the buttons are prepared with it off, the system will not work if it is subsequently switched on.

Leading Letters for Invoice Reference numbers
Default= AA (e.g AA1254)

Enter some characters that will form the leading letters for the invoice number.

URL of Shop Front Script

Enter the URL back to your shop front.
e.g. http://www.yourdomain.com/shopfront

URL of Terms & Conditions for Shoppers

Enter the URL for a page that contains the terms and conditions of your transactions.
A default set of terms and conditions can be found at http://www.topshopper.net/remote/shoppingtermsdefault.asp
These may be sufficient for your needs.

Sales Administrator's E-mail 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 Administrator's and Merchant's e-mail addresses are redirected to the same place this can cause problems.

Merchant's E-mail 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.
This must not be the same address as the Administrator's E-mail address.
Also if both the Administrator's and Merchant's e-mail addresses are redirected to the same place this can cause problems.

Short Message to Shopper

This message will be added to the purchase confirmation email sent to the shopper.

Currency Symbol

The symbol to use infront or any money value. e.g. £ or $

Shopping Cart Header Image (URL)

Enter ther URL of an image banner to be displayed at the top of your cart.
e.g. http://www.topshopper.net/remote_shop/header.gif
If this is left blank then your Merchant Name will be displayed instead. Recommended maximum width is 660 pixels.

Shopping Cart Footer Image (URL)

Enter ther URL of an image banner to be displayed at the bottom of your cart.
e.g. http://www.topshopper.net/remote_shop/footer.gif
If this is left blank then your Merchant Name will be displayed instead. Recommended maximum width is 660 pixels.

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.
You can choose a custom set if you prefer (see below).

Set 1:		Set 2:
Set 3:		Set 4:
Set 5:		Set 6:
Set 7:		Set 8:

To see all the images in the sets click here

URL of custom image directory

It is possible to design your own navigation images. If you set the Navigation Image Set above to 'custom', then you must construct a directory on your site containing the following image files: addbasket.gif, continueshop.gif, emptybasket.gif, proceedtochkout.gif, shopfront.gif, terms.gif and viewbasket.gif. These images are used to navigate the shopping cart. Test the cart with one of the other sets to get an idea of what they do before you design your own set.
This field should contain the absolute URL of the directory in which these images reside. e.g. http://www.yoursite.com/shop/images . Do not include a trailing '/'

Post & Packing State (On or Off)

Switch on post & packing here. If it is 'off' then postage is shown as 'included'. When each item is added to the cart, the postage is added to produce the final postage cost. If no postage information is sent then the default postage of zero is used.

Fixed Postage Charge
(Do not include currency symbol)
(Leave blank for no fixed charge)

If you want to charge a fixed amount for delivery, put the amount here. Do not include the currency symbol. Leave blank if not required.

Maximum Postage Charge
(Do not include currency symbol)
(Leave blank for no maximum charge)

If you want to have a maximum delivery cost then put the amount here. This will override the fixed delivery cost and any total reached by adding the individual postage amounts. Do not include the currency symbol.

Goods Value for Free Delivery
(Do not include currency symbol)
(Leave blank for no free delivery based on invoice)

If you want to offer free delivery once some specified total purchase value has been reached then put the purchase value here. This is applied to the invoice value before VAT is added. This will override the fixed charge and the maximum charge. If this function is not required, please leave this blank. Do not include the currency symbol.

VAT State

You can switch VAT on here.
When VAT is switched off, no VAT information needs to be sent to our cart.
When VAT is switched on, the system uses VAT Codes to determine how much VAT needs to be added.

UK Codes
The UK codes are 0,1 and 2. When information is sent to the cart about a product, and VAT is switched on, you should include a VAT Code.
The VAT Codes are:
0 = Zero rated e.g. books, aids for the handicapped.
1 = Standard Rate (Currently 15.0%)
2 = Reduced Rates (Currently 5%) e.g. fuel.

Ireland Tax Codes
0=Zero rated e.g. Exports, food drink
3=Standard Rate (Currently 21.5%)
4=Fuel,Electricity etc.(Currently 13.5%)
5=Livestock etc (Currently 4.3%)

If VAT is switched on and no VAT information is sent then the UK Standard VAT rate is used. The products price should be the price excluding VAT. VAT will be added to this price at the rate indicated by the code used.

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.

Cheque Payable To

Name to which cheques are payable

Credit/Debit Card over the telephone

If this is switched on, Merchant's telephone number is displayed on payment page.

Credit/Debit Card via YOUR on-line secure server.

If this is switched on, the shopper is invited to proceed to your secure server for payment by credit card at the URL provided below. You will need to set up the secure server as described in the Secure Server Set-up guide.
NOTE: If you decide to use TopShopper's Secure Server system for collection of card information, the service will only be available after payment of the appropriate fee.

URL of Merchant's Credit Card Handling Script

URL to secure server script which resides on YOUR secure server. e.g. https://yoursecureserver.com
This script used 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

WorldPay accId1

Optional Parameter for WorldPay - leave blank if not required.(default)

WorldPay Auth Mode

Optional Parameter for WorldPay - leave blank if not required.(default)
The values are A for full-auth and E for pre-auth

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 - The code is GBP for British Pounds

Payment via NOCHEX

If this is switched on, the shopper is invited to proceed to
NOCHEX. 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.

Promotions

Promotions Code

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 (%)

Enter the amount of discount. Do not enter the'%' sign

( Click here to update settings)

Topshopper is a product of Topdown Active Web Designs - http://www.topdown.co.uk