Before you do anything with the module you need to check that you have setup OSC correctly to the language you are going to use, the Location of your shop and the Currency you are to use or you will get all sorts of funny errors like missing tax, wrong currency, prices missing from your web site etc. So lets spend a minute looking through the Admin pages making sure the basics are right.
Login to your Admin page and go to Configuration > My Store
Work your way down the list of settings and make sure that you have setup all the sections
Pay particular attention to 'Switch to Default Language Currency' if you turn this on (true) and your shop is outside the US the prices will disappear from your website
At the bottom of the list set the decimal places for the tax in your location (leave at zero if you sell goods that don't attract tax) and also set 'Display Prices with Tax' if you need to charge sales tax or VAT
Next go to Locations / Taxes and set the country your shop is in, the tax zone it is in if you need to charge tax and then Tax Zones, Classes and Rates - exactly how to do this is beyond the scope of this tutorial but there is plenty of help in the forums for setting up the various national tax requirements.
Next go to Localization and setup the currencies you want to be able to accept. Remember it is most important to set your national currency as the default currency or your site will display all its prices in US Dollars and pass those prices to PayPal as US Dollars too.
Next set the Default Language for the site and add any other languages you wish to offer
Make a note of the changes you have made as you will need them for the next step - setting up PayPal
Setting up PayPal
First a word of warning. If you put PayPal into a search engine to find the home page and setup a business account you will end up on the US PayPal site - OK if you live in the USA but not so good if you live elsewhere as there are quite a few differences in the way PayPal handles payments directed to UK shops or those in the EEC. Like wise the Australian shops have specific requirements so make sure you are logging in to your National branch of PayPal. I am in the UK so I will go through the steps needed for a UK site - I'm afraid you will have to look at the PayPal help pages for your local settings.
Find the PayPal login page for your Country
Login to your account or sign up for a new account for your shop (sales@<yourshop>.co.uk is a good one for UK shops) don't forget to make a mailbox for this email address and to add it to My Store in the Send Extra Order Emails to section
Once you have an account and are logged in, go to Profile and in the right hand column click on Payment Receiving Preferences
In here you have the choice of accepting just your default currency, or having other currencies converted. We found that having them converted let us accept orders from EEC countries as well as the UK
Block multiple payments so that you don't get duplicate orders
Set the Credit Card Statement Name so that customers will recognise payments to you on their Credit Card Statements when they pay that way through PayPal
Save the page and go to Profile>Instant Payment Notification Preferences
Activate Instant Payment Notification
The notification URL should be http://<your web site>/catalog/checkout_process.php
Save the page then go to Profile>Website Payment Preferences
Turn on Auto Return
Set the return URL to http://<your website>/catalog/ipn.php
Leave Payment Data Transfer set to off as this module doesn't support it (You need PayPal Pro for that)
Using this module you are using PayPal to handle all your Credit Card payments so you don't need encrypted payments. If you do want to have them you need to buy a SSP certificate and that is beyond the scope of this tutorial so set Encrypted Website Payments to off
To ensure that customers are returned to your site and you are notified of the order details you need to make set PayPal account optional to off
As your customers have already supplied their phone number when they created an account with you, you don't need to ask them for it again. Turn Contact telephone number off
As this module doesn't use Express Checkout, Say no to Support Giro and Bank Transfer Payments
Save the page then go to Custom Payment Page Styles
In here you can change the colour of the PayPal page, add your logo to the payment confirmation page and generally integrate the PayPal page with your site
You are now ready to install the Website Payments Standard module to your site
Installing the Module
After extracting the add-on package, copy the files located in the catalog directory to your osCommerce installation directory on the server. The files must be copied in the correct directory structure as extracted from the add-on package.
The file listing is as follows:
To install languages other than English see the readme.pdf file in the unpacked module.
Configure the module
Once the module is uploaded, login to your Admin page and go to Modules>Payment. In here you can configure the new module.
You will see that there are now three PayPal modules showing
PayPal - PayPal IPN - PayPal Website Payments Standard
Uninstall both PayPal and PayPal IPN if you have already installed and activated them
Install PayPal Website Payments Standard
Click on the Edit button in the right hand column
Set Enable PayPal Website Payments Standard to True
In email address put the address you have used to set up your PayPal account
Check on the forums if you need to set a payment zone - in the UK accepting only GBP you don't and can leave this as none
Set preparing Order Status to Preparing [PayPal Standard] to intercept bad orders or ones that don't complete
Set PayPal Acknowledged Orders Status to Processing
Set the Gateway Server to Sandbox while testing but remember to set it to live when testing is over
Set Transaction method to Sale
Set Page Style to PayPal
Set the Debug E-Mail Address to the email address you want emails from PayPal to go to about orders that are not completed or any problems with payment NB. It should not be the same email address you use for your PayPal account
Set the sort order of display to where you want the PayPal option to come in your payment options list in the shopping cart. Low numbers come first in the list but 0 comes at the end so be careful what you choose
If you aren't using encrypted payments you can ignore the rest of the list - we don't use them so I haven't found out what they are for other than they are something to do with secure websites (https://) the module works just fine without them.
Right you are now ready to start sending through test purchases. I hope this tutorial helps you to set up and configure PayPal for your osCommerce site - the above instructions worked just fine for us and we are now getting completed orders through without any errors.