===============================================================================
ASP Football Pool PayPal Mod
===============================================================================

This mod adds code to allow players to submit payments via PayPal. Note that
you will need to have a PayPal account. It's also a good idea to get a
developer account (see http://developer.paypal.com) so you can test your set
up before attempting to accept real payments.

PayPal charges a processing fee for handling payments (currently, that fee is
2.9% of the payment plus $0.30). The code is set up to take that fee into
account. For example, to receive $50.00 in credit towards the pool, a player
will be asked to pay $51.80. The extra $1.80 will appear as a shipping charge
on the PayPal payment.

To install this mod, copy all the included files to your pool directory (you
may wish to back up your existing files first).

It also requires adding a table to your existing database. This is done using
the supplied createTable.asp script. To run it, upload the file to your site,
login as the administrator and load the createTable.asp page. You can then
delete that file from your site.

You'll need to set some values in the includes/payments.asp file in order for
the payment process to work:

const PAY_PAL_RETURN_URL         = "http://www.example.net/FootballPool/paymentComplete.asp"
const PAY_PAL_CANCEL_RETURN_URL  = "http://www.example.net/FootballPool/paymentCanceled.asp"
const PAY_PAL_NOTIFY_URL         = "http://www.example.net/FootballPool/paymentNotify.asp"
const PAY_PAL_BUSINESS           = "admin@example.net"

When a player uses the online payment form, the basic process flow is as
follows:

  1. A player selects an amount on the makePayment.asp page and clicks Submit.
  2. The data is submitted to PayPal's site.
  3. The player enters his or her payment information and submits the payment.
     Note that the player may cancel the transaction before submitting the
	 payment, in which case he or she will be sent back to the
	 paymentCanceled.asp page on your site.
  4. PayPal will then send a notification, which is handled by the
     paymentNotify.asp script on your site. If the payment is cleared,
	 the script will automatically add a credit to the player's account.
  5. The player is then sent to the paymentComplete.asp page on your site,
     which will show the transaction details.

Note that PayPal may send more than one notification for a given payment, such
as when a payment must be held pending verification. All notifications are
logged and you can view them using the paymentLog.asp page. A player's account
is only credited when a "payment complete" notification is received.

New Files
---------
createTable.asp (used to create the new table in your existing database)
makePayment.asp
paymentCanceled.asp
paymentComplete.asp
paymentLog.asp
paymentNotify.asp
includes/payment.asp

Modified Files
--------------
help.asp (added help for payment pages)
data/NFL.mdb (includes the new table)
includes/menu.asp (added menu items for payment pages)

