How to setup Paypal

* I am aware that this may be all over the forums but just in case, Id like to present it to everyone. This is a very short, to the point tutorial detailing how to setup the standard version of PayPal Website Payments.

MarvikShop and PayPal
How to Setup and Configure PayPal Website Payments Standard Module

Before you do anything with the module you need to check that you have setup MarvikShop 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.

1. Login to your Admin page and go to Configuration > My Store
2. Work your way down the list of settings and make sure that you have setup all the sections
3. 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
4. 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
5. 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.
6. 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.
7. Next set the Default Language for the site and add any other languages you wish to offer
8. 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.

1. Find the PayPal login page for your Country
2. 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
3. Once you have an account and are logged in, go to Profile and in the right hand column click on Payment Receiving Preferences
4. 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
5. Block multiple payments so that you don't get duplicate orders
6. 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
7. Save the page and go to Profile>Instant Payment Notification Preferences
8. Activate Instant Payment Notification
9. The notification URL should be http://<your web site>/catalog/checkout_process.php
10. Save the page then go to Profile>Website Payment Preferences
11. Turn on Auto Return
12. Set the return URL to http://<your website>/catalog/ipn.php
13. Leave Payment Data Transfer set to off as this module doesn't support it (You need PayPal Pro for that)
14. 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
15. 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
16. 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
17. As this module doesn't use Express Checkout, Say no to Support Giro and Bank Transfer Payments
18. Save the page then go to Custom Payment Page Styles
19. 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

Setting up PayPal in MarvikShop

1. You will see that there is a PayPal Website Payments Standard module showing
2. Uninstall both PayPal and PayPal IPN if you have already installed and activated them
3. Install PayPal Website Payments Standard
4. Click on the Edit button in the right hand column
5. Set Enable PayPal Website Payments Standard to True
6. In email address put the address you have used to set up your PayPal account
7. 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
8. Set preparing Order Status to Preparing [PayPal Standard] to intercept bad orders or ones that don't complete
9. Set PayPal Acknowledged Orders Status to Processing
10. Set the Gateway Server to Sandbox while testing but remember to set it to live when testing is over
11. Set Transaction method to Sale
12. Set Page Style to PayPal
13. 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
14. 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
15. 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 MarvikShop site - the above instructions worked just fine for us and we are now getting completed orders through without any errors.