Welcome!

Perlsources.com

.

 
11

 

IPNX - Documentation

Distribution - Directories - Distribution Files - Installation - Testing - Implementing - Data Files - Customization - Troubleshooting - Support

Go here for the Sales Report Installation & Documentation.

Distribution File

  • ipnx.zip

Directory Structure

  • Any directory under cgi-bin (or equal directory). Can also start in the cgi-bin directory, too.
    • ipnx (or any name you want)
  • Directories below the script directory:
    • doc
    • data *
    • history *
    • logs *
    • MODULES
  • Set directories to rwxrwxr-x or rwxr-xr-x
  • * If $write_data_files enabled, directories must be writeable by the Web Server. Ask your Web Host Provider about it, not us.

Distribution - Directories - Distribution Files - Installation - Testing - Implementing - Data Files - Customization - Troubleshooting - Support

Distribution File Contents

  • ipnx.cgi
  • Ipnx_Config.pl
  • Ipnx.pm
  • overview.html
  • documentation.html
  • ipn_demo.html
  • printenv1.pl - script to test your server general configuration
  • printenv2.pl - script to test your server for existance of LWP::Parallel Perl Module

Installation (assumes extraction on Windows or Mac PC)

  • Extract on PC with zip utility
  • Read and edit the Ipnx_Config.pl file. This file contains documentation for setting all variables.
  • Create directories on the server
  • Set directory rights
  • Copy files to the server
  • Set file rights (script rwxr-xr-x & two files in the MODULES directory rw-r--r--)

Distribution - Directories - Distribution Files - Installation - Testing - Implementing - Data Files - Customization - Troubleshooting - Support

Testing

  • Use "ipn_demo.html" to test your application.
  • Make sure to edit the Form Action Line and set for your server.

Distribution - Directories - Distribution Files - Installation - Testing - Implementing - Data Files - Customization - Troubleshooting - Support

Implementing

  • Configure your account at PayPal for Shopping Cart &/or Single Item purchases.
  • Set your account to use IPN.
  • Enter the applicable IPN link for your script.
  • Save the configuration.
  • Do some live tests.
  • Start doing business.

About the Data & History Files

  • The script creates two types of data files.
  • In the "data directory" individual purchaser data files are created.
  • In the "history directory" monthly transaction files are created.
  • The naming convention for data files is "txn_id.txt".
  • The naming convention for history files is "YYYYMM.txt" where YYYY is the 4 digit year and MM is the 2 digit month number.
  • In both cases, data files are make up of pairs of data separated by !! values.
  • The pair of data are made up of PayPal Field Name & Field Data, which are separated by an = sign.
  • In both cases, the leading set of data is always the txn_id & value.
  • Other significant pairs of data are also within the first few sets.
  • Additional sets of data may not be in similiar locations, due to the type of order processed, etc.
  • Individual data files can have 1 or 2 records. This will generally occur when an order is processed as an "Echeck".
  • The transaction_date data in both files is a computed value. This has been done to better facilitate date sorting. PayPal's date format is much more complex.
  • All data passed via IPN should always be recorded in both data files.

Distribution - Directories - Distribution Files - Installation - Testing - Implementing - Data Files - Customization - Troubleshooting - Support

Customization

  • Not available from us.

Distribution - Directories - Distribution Files - Installation - Testing - Implementing - Data Files - Customization - Troubleshooting - Support

Troubleshooting

  • You're on your own here.

Support

  • No Free Support of any kind is available for this application. No exceptions.

This utility is based on open source. The author is Dave Van Abel of Vanabel.com and Perlsources.com. You can read the Open source License here.

Distribution - Directories - Distribution Files - Installation - Testing - Implementing - Data Files - Customization - Troubleshooting - Support

 
© Dave Van Abel, 2002-2003