Credit/Debit Card (via PayPal) (Version IPN v2.3.3)

Credit/Debit Card (via PayPal) (Version IPN v2.3.3)

What is IPN and why do you need it?

IPN stands for Instant Payment Notification

The traditional PayPal Website Payments Standard (Version 1.0) requires the shopper to return to the store in order for order details to be recorded, order emails to be generated and stock quantities to be updated.

If a customer does not return to the site then you would receive a payment notification from PayPal but no order details. This PayPal IPN Module addresses this problem by storing orders prematurely (before payment) in the database with the Preparing [PayPal IPN] setting and as soon as a customer pays the order status is automatically updated to the chosen setting (usually Pending).

This means that even when a customer fails to return to the site, the you will have a record of the order details even when no order emails are generated.

Since order with the reference Preparing [PayPal IPN] could be customers who are currently completing their orders you should be careful not to delete this as abandoned carts until at least 48 hours after they are logged.

For v2.3.4.7 to work properly, there must not be any Shipping Calculations set in the Paypal account profile

Configuration

Enable PayPal IPN Module :: When enabled, the customer is allowed to choose the PayPal IPN payment method at the checkout procedure.
Gateway Server :: The Testing server uses PayPals Sandbox server, and the Live server is used to process real transactions.
E-Mail Address :: The e-mail address of the business account setup at PayPal (the seller e-mail address). The funds gathered from purchased orders paid through the PayPal IPN module will be sent to this PayPal account.
Sort order of display :: The order in which the PayPal IPN payment method should be shown on the checkout payment page if more than one payment method is available.
Transaction Currency :: The currency for PayPal to use for the transaction. Selected Currency allows multiple currencies to be accepted, where the customer chosen currency is used for the transaction. If you use this option then you must have enabled acceptance of those currencies in your Pay Pal account settings. If a specific currency is selected (i.e. EUR, USD, ..) and the customer has selected another currency during the checkout procedure, the transaction will be forced to the currency defined by the store administrator.
Payment Zone :: If defined, the PayPal IPN payment method will only be available to orders made within the defined zone. Set this to –none– if you want it to be available for everyone.
Set Preparing Order Status :: This is the Order Status that the order will be set once the customer trys to checkout. If the customers alters this order then this order will be deleted and and a new order inserted into the orders table (once they reach the checkout confirmation page). If the customer abandons their cart then these will remain in the order queue until they are manually removed - make sure they are a couple of days old before removing so that you don't accidentally remove a live order!
Set PayPal Acknowledged Order Status :: This is the Order Status that the order will be set to once you receive a IPN confirmation from PayPal. This will only be done when PayPal returns the result VERIFIED.

Why not set up a new Order Status to reflect when the order has been acknowledged by PayPal.

Login to your admin panel → Localization → Order Status → Click Insert.

Then set Order Status :: Processing [PayPal IPN OK] and click update

Set PayPal Completed Order Status :: This is the Order Status that the order will be set to once the IPN notification from PayPal has been received, has returned the result of VERIFIED and the PayPal payment status is returend as completed.

Why not set up a new Order Status to reflect when the order has been completed by PayPal.

Login to your admin panel → Localization → Order Status → Click Insert.

Then set Order Status :: Processing [PayPal Complete] and click update

Only orders where payment has been received successfully should show with this order status, allowing you e.g. to use it for releasing downloadable content.

Transaction Type :: This allows you to define how the transactions should be processed at PayPal - either with each product in the order being passed to PayPal (Per Item), or without the products with just the order totals being passed to PayPal (Aggregate).

The recommended setting is Aggregate. Per item can cause problems, especially when used together with contributions such as CCGV(trad).

Page Style :: The page style to use which is defined in your PayPal Profile account. PayPal allows you to define page styles from within your PayPal account to display e.g. your logo during checkout. Leave blank for default style.
Debug E-Mail Address :: All parameters of an Invalid order is sent to this e-mail address for debugging/verification purposes.
cURL Proxy server :: If curl transactions need to go through a proxy, type the address here starting with http://. Otherwise, leave it blank.

Enable Encrypted Web Payments :: When enabled, the order parameters will be encrypted to be sent to PayPal.

Note: This feature requires a working OpenSSL installation on your server, with access rights to the “openssl” program file. The “openssl” program file is called via PHPs exec() function, which the webserver needs to have access to.

Your Private Key :: The location and filename of your private key to use for signing the order data.
Your Public Certificate :: The location and filename of your public certificate to use for signing the order data.
PayPal's Public Certificate :: The location and filename of the PayPal public key to use for encrypting the order data.
Your PayPal Public Certificate ID :: The public certificate ID that PayPal should use to decrypt the encrypted order data. This is defined at your PayPal Encrypted Payment Settings Profile page.
Working Directory :: The working directory to create temporary files. (All created files are automatically deleted when no longer needed)
OpenSSL Location :: The location and filename of the OpenSSL “openssl” program file.

AutoReturn Settings

You do NOT need to enable Auto Return in your PayPal account as this information is sent automatically by the IPN module.

If you do wish to activate it, then the return path is the pathway to the checkout_process.php file. Sample pathways are:
- for sites with full SSL: https://yourdomain.com/checkout_process.php
- for sites with shared SSL: https://yourserver.xssl.net/yourdomain.com/checkout_proccess.php

Note: Only enable AutoReturn if you have only one shop linked to your PayPal account!

Bookmark at

paypal_ipn.txt · Last modified: 2009/10/27 12:00 by pgmarshall