• Overview
  
  • Core code re-written to interface better with Paypal IPN Code
    
  • Code has been simplified to allow for testing of core system, prior to adding additional options
    
  • Utilises PayPal's Instant Payment Notification (IPN) to automatically update the store's database, regardless of whether the customer returns to the site or not.
    
  • IPN Information available directly on Admin Orders Page
    
  • Downloadable media in your shop is only available once PayPal verifies that the payment is Complete.
    

• PayPal Payment Module Installation
  
  
  • In Admin->Modules->Payment, install the PayPal module. The following fields will now be shown:
    
    
    • Enable PayPal Module
      Since you have just done the installation, by default it will say True.
      
      
    • E-Mail Address
      Enter your Primary PayPal email address here.
      
      
    • Business ID
      If you have configured a secondary email address to be your business email address in your PayPal profile account,
      then enter this here, otherwise enter the same one used above.
      
      
    • Transaction Currency
      Choose which currencies you want to accept PayPal payments with.
      
      
    • Payment Zone
      If a zone is selected, this payment method will only be enabled for that zone.
      
      
    • Set Pending Notification Order Status
      Set the Pending Notification status of orders made with this payment module to this value.
      This is the status that a customer's order will be set to until the IPN notification sends confirmation to your store that the payment has been processed successfully.
      'Pending' is suggested or use the value set in "Set Order Status" in the next line below:
      
      
    • Set Order Status
      Set the status of (paid) orders made with this payment module to this value. This will get set automatically after the PayPal IPN notification is received by your store.
      Do not set it to 'default' but specifically choose the status desired.
      'Processing' is suggested.
      
      
    • Synchronize Invoice
      Specify whether the Zen Cart order number should be used as a unique PayPal invoice number, similiar to PayPal's Send Money feature, this will enable customers to resume an order via their Zen Cart account history info page for that order for pending transactions which were not previously completed.
      
    • Sort order of display
      Sort order of display on the checkout-payment-methods screen. Lowest is displayed first.
      
      
    • Debug Email Notifications
      Choose whether you want to receive debug emails. Should normally be "No".
      
      

 

• My shipping costs are different once the customer arrives at the PayPal site.
  
  • In your PayPal account profile in the shipping section, check the box that allows overriding the shipping costs.
    
    
• Do I need to enable IPN in my PayPal Acccount Profile? What URL should I specify for the IPN feature to be used?
  
  • No, you don't need to enable it, and you don't need to specify a URL for IPN. The Zen Cart IPN module automatically enables IPN for the transactions it is processing, and automatically specifies the right URL for each payment.
    
• Why doesn't the Auto-Return feature work?
  
  • Have you enabled it in your PayPal account profile?
    Enabling the Auto-Return feature will cause customers to be returned to your site 2-5 seconds after they've completed payment. If you leave the setting off in your PayPal account profile, then the customer will have to click "Continue" to return to your site.
    
    
• What URL should I specify for the Auto-Return feature?
  
  • It doesn't matter, the PayPal module will tell PayPal where to go, in this case it is currently now:
    index.php?main_page=checkout_success
    
    
• Why am I getting so many emails per transaction.
  
  • You get one from PayPal and one store order email.
    You may get many more debug emails: disable email notification.
    
    
• Why am I not receiving any IPNs?
  
  • You must ensure that your Primary Email Address and Business ID are configured correctly.
  • Login to your PayPal Account and see what and how many email addresses you are using and which one is the Primary address.
  • Also check your "debug" emails (if enabled) as they will specify the Primary Email address of the intended receiver.
    
    
  
  
• How can a customer resume an aborted/cancelled/failed order?
  
  • Currently, if the customer abandons the checkout process at the PayPal site, e.g for some reason they did not actually pay at that time, then they can log into their Zen Cart account and click the confirm button when viewing the details of that particular order in their account_history_info.
    
    This feature is only available when synchronizing invoices with PayPal. (See the Synchronize Invoice option above)
    
    This means that if you ever reset the Zen Cart orders database table then you must also update it's auto-increment value to be greater than the last known order_id. (see the Admin->Tools->Store Manager to reset the orders counter).
  
  
• Where can I find PayPal documentation?
  
  • PayPal Integration Manual
    
    
• Where can I get support?
  
  • Zen-Cart Community Forum.
    
    
• The PayPal payment option does not appear when it is installed.
  
  
  • If the paypal option is not appearing, especially if this is a recent upgrade to Zen-Cart, go into Admin->Modules->Payment->Paypal, click on "Edit", and write your settings down.
    Then cClick "Update". Click "Remove". Click "Install". Click "Edit", and re-enter your settings.
    
    
• What type of PayPal account do I need.
  
  
  • You will need either a Premier or Merchant Business Account.