Get the latest scripts from Subversion! Check out AquaticPrime in Google Code.

AquaticPrime requires PHP to be installed on your target webserver. The PHP installed by default with Mac OS X 10.4 (Tiger) does not include some components used by AquaticPrime, so you will need to install another version of PHP. There are hundreds of resources on the internet covering this topic, so for the sake of brevity it will not be discussed here. For more information on installing and setting up PHP on Mac OS X, click here.

Open the AquaticPrime Source folder and locate the folder called "PHP". Inside this folder, open "Config.php" in a text editor. Paste your public key and private key into the fields indicated. Make sure to remove any leading "0x" prefix from the keys.

Next, fill in the email address you want your application licenses to come from and enter the subject and message body of the email. You can use "##NAME##" and "##EMAIL##" (without quotes) in place of the customer's name and email in any of these fields. It's a good idea to add an email that will be blind carbon copied on all order emails so you have have them for your records.

Next, change the license name to what you would like your license files to be named. The default is the customer's name with an ".applicense" extension.

Now you need to copy the contents of the "PHP" directory to the location you wish to install AquaticPrime on your webserver.

If you have shell access on your webserver, I strongly recommend you shell into the directory where you installed AquaticPrime and type "make". This will build a native version of AquaticPrime on your webserver that will be able to generate licenses several orders of mangnitude faster than PHP.

After following these steps, you are able to generate licenses codes on your webserver. The next sections cover payment processing with popular companies.

Open Config.php and under the section labeled "Kagi Only Config", enter your password that you set up with Kagi.

Send the following email to Kagi, replacing the URL, PassPhrase, SupplierName, and SupplierCode fields with your own information from Kagi.

To: acg@kagi.com
Subject: KRPS install please

Please hook this up so it works via the KRPS facility.
URL -- http://www.greatcompany.com/cgi-bin/AquaticPrimeKagi.php
Username -- Unused
PassPhrase -- testPassword
Blurbname -- KRPS_Blurb
SupplierName -- me@kagi.com
SupplierCode -- XXA
RealmUser -- not used
RealmPassword -- not used
Cypher -- SHA-1
InvocationType -- Line
ExpectUserAndRegcode -- No

When you hear a reply from Kagi, you are ready to accept payments. When a customer purchases your product with Kagi, a license will be generated and emailed to them.

1) Log-in to your PayPal account
2) Click on the Merchant Tools tab
3) Click on "View All Features" under Key Features
4) Find the Auto Return section under the Additional Features heading and click on "Set it up"
5) Click the "On" radio button and enter the URL of AquaticPrimePayPal.php on your webserver


6) Go down to the Payment Data Transfer section and select the "On" radio button


After saving these settings, you will see a message similar to this:

Copy the token given and open up Config.php in your AquaticPrime PHP installation. Locate the section labeled with "PAYPAL ONLY CONFIG" and paste your authorization token where the words AUTH TOKEN HERE appear. Save and close Config.php.

You are now ready to accept payments processed by PayPal. When a customer purchases your product with PayPal, a license will be generated and emailed to them.