Overview of PayPal (IPN) Instant Payment Notification Module

• Module has been re-written to be smaller, lighter, yet more robust than any previous module.
• Fully integrated with the Zen Cart™ checkout process, Payment and Order Totals classes.
• PayPal's (IPN) Instant Payment Notification automatically updates the store's database, regardless of whether the customer returns to the site or not.
• All PayPal IPN Information available directly on Admin Orders Page
• Full support for Zen Cart™'s built in coupons, gift certificates, downloadable products and shipping options.
• PayPal Instant Payments, e-checks, credit card payments, and multiple currencies are supported.
• Orders status changes with type of payment and/or refund/payment denial/cancellation.
  

Prerequisites for Use

• Completed, working installation of Zen Cart™ v1.2.5d
• Premier or Merchant Business Account from PayPal.
  
  Some account configurations may need to be made in your PayPal
  account (at www.paypal.com) for various options that are available.
  See Frequently Asked Questions below for more information.
  

PayPal IPN Module Installation

Installing the Module

• Open your Zen Cart™ Admin page.
• Point your cursor at Modules on the menu bar.
• Choose Payment from the dropdown menu.
• Click the icon on the PayPal IPN row.
• Click the Install button.

Upgrading the Module (or activating changes made in a new version)

• Open your Zen Cart™ Admin page.
• Point your cursor at Modules on the menu bar.
• Choose Payment from the dropdown menu.
• Click the icon on the PayPal IPN row.
• Click on the edit button .
• Write down all the settings that were previously configured.
• Click on OK
• Click the Remove button. This will uninstall configuration settings from the old version
• Click the Install button to activate the new version.
• Re-enter your configuration settings which you recorded earlier.

PayPal IPN Module Configuration

Configuring the Module

• Enable PayPal Module - Do you want to accept PayPal payments?
  • True
    Choose True if not on by default
  • False
    Choosing False here will disable the module, meaning customers won't see it as an option during checkout

• Business ID - Primary email address for your PayPal account
  It's important to use the primary email address for your PayPal account.



• Transaction Currency - Choose the currency/currencies you want to accept
  
  • Selected Currency
    Choose this option if you wish to accept payments in multiple currencies.
  
  
  • Only USD
    Choose this option if you wish to accept payments only in US Dollars.
    
  • Only CAD
    Choose this option if you wish to accept payments only in Canadian Dollars.
  
  
  • Only EUR
    Choose this option if you wish to accept payments only in Euros.
  
  
  • Only GBP
    Choose this option if you wish to accept payments only in British Pounds.
  
  
  • Only JPY
    Choose this option if you wish to accept payments only in Japanese Yen.
  
  
  • Only AUD
    Choose this option if you wish to accept payments only in Australian Dollars.
  
  
• Payment Zone - If a zone is selected, only enable this payment method for that zone. Customers in other zones will not see PayPal as a payment option during checkout.


• Set Pending Notification Status - Set the status of orders made with this payment module that are not yet completed to this value ('Pending' recommended)


• Set Order Status - Set the status of orders made with this payment module that have completed payment to this value ('Processing' recommended)


• Set Refund Order Status - Set the status of orders made with this payment module that have been refunded to this value ('Pending' recommended)


• Sort order of display - Sort order of display ... ie: what order the payment modules are displayed in during checkout. Lowest value is displayed first.


• Mode for PayPal web services - Choose the URL for PayPal live or test services
• www.paypal.com/cgi-bin/webscr
        choose this URL for Live Services
• (might have to use www.paypal.com/us/cgi-bin/webscr)

Frequently Asked Questions

Do I need to enable IPN in my PayPal Acccount Profile? What URL should I specify for the IPN feature to be used?

Yes, you should enable it.
1. Log into your PayPal account and go to Profile
2. Click on "Instant Payment Notification Preferences"
3. Click on Edit
The URL should point to: http://www.mydomain.com/ipn_main_handler.php
or if you have the Zen Cart™ program in a subdirectory: http://www.mydomain.com/subdirectory/ipn_main_handler.php


Do I need to turn on the Auto-Return Feature in PayPal?

Yes. Enabling the Auto-Return feature in your PayPal account profile will return your customers to your site 5-10 seconds after they've completed payment and finish their transaction in your Zen Cart™ store .

1. Log into your PayPal account and go to Profile
2. Click on "Website Payments Preferences"
3. Change Auto-Return to "On"

Provide a return URL:
For nonSSL sites:
http://www.mysite.com/MY_SHOP/index.php?main_page=checkout_process
or
For sites with their own SSL Certificates:
https://www.mysite.com/MY_SHOP/index.php?main_page=checkout_process
or
https://mysite.secureserver.net/MY_SHOP/index.php?main_page=checkout_process

Should I enable PayPal Account Optional?
This is your choice.

Sessions
Note: The sessions work automatically. Do not change your sessions setting in the Zen Cart Admin.