Paypal Standard for Phoenix

v1.1 April 2024
Compatibility up to Phoenix 1.0.9.1 and php 8.2

v1.01 May 2023
Compatibility for Phoenix 1.0.8.20

v1.00 November 2022

Introduction
------------
Paypal standard transfers the customer away from your site on checkout confirmation, and returns them when the paypal payment is completed. Paypal also lets your site know about the payment (and any subsequent changes) by Instant Payment Notifications. If the customer does not return after a successful payment (e.g. their connection drops) the IPN will still confirm the order.

Prerequisites
-------------
This module is designed to use in a fresh Phoenix install from 1.0.8.13 onwards (which has no paypal built in). If your store has the paypal app or any paypal modules, uninstall and delete them to avoid clashes and confusion.

Installation
------------
Copy the files to your store. The delivered directory structure matches the shop structure.
In your shop admin menus, go to admin > modules > payment and install the module, then edit it for the settings:

If you are new to phoenix, you should find these helpful:
Getting started - what to do with a zipped plugin
https://cartmart.uk/info.php?pages_id=5
General guide to installing a payment module:
https://phoenixcart.org/phoenixcartwiki/index.php?title=Payment

Settings Notes for Paypal Standard Module
-----------------------------------------
Seller Email is the email you are using to collect payments.

Primary Paypal email is left blank for many sites, it is only needed if you are sending payments to an additional email on your paypal account.

PDT Identity Token is used to verify returned info from paypal to prevent your payments being hijacked. To find it:
- log into your paypal account
- on the dropdown on your name in the top right, choose account settings
- under Products and Services on the left, choose Website payments
- find Website Preferences in the list and choose Update
- now on this page:
-- set Auto return to On and set the return url to that displayed in the module admin and click Save
-- in the next section, set Payment data transfer to On
-- an identity token should have appeared magically, if it didn't appear toggle pdt off and back on again; copy the token to your module settings
- Click Back to Profile at the top and scroll down to Instant Payment Notifications and choose Update
-- copy the notification url from your module

Troubleshooting
---------------
If you need help with installation, please post a request in the support forum for the addon:
https://phoenixcart.org/forum/app.php/addons/free_addon/paypal_standard_for_phoenix/support

Make sure to include:
- the version of phoenix you are running
- whether it was installed at that version or has been updated from earlier version(s)
- if it's a "crash" include the entries in your php error log but edit them to obscure full path names on your server
