/*
 * readme.txt
 *
 * ASP Toolkit for PayPal v0.50
 * http://www.paypal.com/pdn
 *
 * Copyright (c) 2004 PayPal Inc
 *
 * Released under Common Public License 1.0
 * http://opensource.org/licenses/cpl.php
 *
*/

REQUIREMENTS
------------

IIS4.0 (Microsoft Internet Information Server) or Greater 
URL: http://www.microsoft.com


INSTALLATION
------------

Unzip all contents contained asp_toolkit.zip.

Upload the ASP ToolKit folder and contents to the document root of your web site. The document root is the main directory containing all of your web site files.

Open the config.asp file and configure the script with your PayPal account settings.

If you plan to use the IPN method, the permissions for the "logs" directory must be set to 777. The script is automatically configured to write a comma separated text file containing the IPN response string from PayPal.


Example Document Root: /home/yoursite/www
Example Installation Directory: /home/yoursite/www/asp_toolkit

Configuration Information
Configuring ASP ToolKit is as simple as entering your order form variable names inside of the config.asp file. Most of the configuration options have already been pre-configured with PayPal.


FILE DESCRIPTIONS
-----------------
config.asp
Main configuration file for the script

payment.asp
A pre-configred payment button for testing purposes

orderform.asp
A pre-configred order form for testing purposes

paypal.asp
Sends transaction information to PayPal for further processing

success.asp
Displayed when transaction submitted to Paypal is approved

error.asp
Displayed when transaction submitted to PayPal fails

styles.css
Example stylesheet

ipn.asp
Receives post back information from PayPal's API and parses the results

ipn_success.asp
Executed if an IPN transaction is successful

ipn_error.asp
Executed if an IPN transaction errors


CONFIGRURATION
--------------

The following variables are configurable in the config.asp file:

paypal_url (required)
PayPal API URL

paypal_business (required)
Primary Account email address

paypal_command (required)
Must be set to (_xclick).

paypal_site_url (optional)
URL of website you plan to run the script under. The site url must always have a trailing forward slash (/) after the domain name. (ex: http://www.paypalsolutions.com/)

paypal_image_url (optional)
URL of the 150x50 pixel image you would like to use as your logo.

paypal_success_url (optional)
URL path to where the user will be returned after completing the payment.

paypal_cancel_url (optional)
URL path to where the user will be returned if payment is cancelled.

paypal_notify_url (optional)
URL path to the IPN notification script.

paypal_return_method (optional)
Return URL behavior. If set to (1) the the buyer will be sent back to the success_url using a GET method. If set to (2) the buyer will be sent back to the success_url using a POST method.

paypal_currency_code (optional)
Defines the currency of the payment. (ex. USD, EUR, GBP)

paypal_lc (optional)
Sets the default country and associated language for the login or signup page that your customers see when they click your button. This field is set to (USA) by default.

paypal_display_comment (optional)
If set to (1) customers will not be prompted to include a note. If set to (0) customers will be prompted to include a note.

paypal_comment_header (optional)
Label that will appear above the notes field.

paypal_background_color (optional)
Sets the background color of your payment pages. 1=black 0=white

paypal_display_shipping_address (optional)
(optional)If set to (1) customers will not be asked for a shipping address. If set to (0) customers will be prompted to include a shipping address.

paypal_item_name (optional)
(optional)Description of item.

paypal_item_number (optional)
Item Number of the product.

paypal_amount (optional)
The price or amount of the purchase, not including shipping, handling, or tax.

paypal_on0 (optional)
First option field name.

paypal_os0 (optional)
First option field value.

paypal_on1 (optional)
Second option field name.

paypal_os1 (optional)
Second option field value.

paypal_quantity (optional)
Quantity of items to be purchased.

paypal_edit_quantity (optional)
If set to (1) the user will be able to edit the quantity. If set to (0) the quantity will not be editable by the user.

paypal_invoice (optional)
Transaction invoice number.

paypal_tax (optional)
Tax amount you would like to apply to the transaction.

paypal_shipping_amount (optional)
Flat shipping amount to charge.

paypal_shipping_amount_per_item
Flat shipping amount to charge for each additional item.

paypal_handling_amount (optional)
Item handling amount.

paypal_custom_field (optional)
Custom order form field.

paypal_firstname (optional)
Buyers firstname

paypal_lastname (optional)
Buyers lastname

paypal_address1 (optional)
Buyers address 1

paypal_address2 (optional)
Buyers address 2

paypal_city (optional)
Buyers city

paypal_state (optional)
Buyers state

paypal_zip (optional)
Buyers zip

paypal_email (optional)
Buyers email

paypal_phone_1 (optional)
Buyers area code

paypal_phone_2 (optional)
Buyers first 3 digits of phone number

paypal_phone_3 (optional)
Buyers last 4 digits of phone number
