How To Enable licensed downloads in the NetMAX Interchange Store

Purpose:
To explain the procedure for setting up the NetMAX Interchange store to automatically deliver licenses to customers ordering downloadable products.

Prerequisites:
This document assumes the following:

The reader is executing the procedure herein on a supported platform, as defined here.
The person performing this procedure can log into the target NetMAX system as the administrative user.
The person performing this procedure is familiar with the basics of operating a NetMAX server, as outlined in the NetMAX Server Manual.
The person performing this procedure has an Interchange store already running, and can log into the adminstrative interface of the online store.
The person performing this procedure has administrative access to their email server, or can have an administrator assist them in completing the procedure.

Procedure:
On your mail server, create a user to receive all orders via email. Ensure that this user has a home directory, and that Mail is Enabled for this user.

Create a file named “.procmailrc” in the user's home directory. The procmail filter should validate that the message comes from the proper source, has the proper subject, and is addressed to the correct person(s). Right-click this link and save the target to disk for an example.

The example procmail file will cause the email server to process all emails from the interchange user on the webserver with a subject of 'ORDER ' followed by anything (usually the order number) sent specifically to the user. The contents of the email message will be sent to the script specified after the “|” symbol via STDIN.

Next, create the script that will parse the email message, also in the user's home directory. In the example procmailrc above, the file is called “orderparser.pl.” Right-click this link and save the target to disk for an example of such a script. Note that the file must be executable by the user whose email address all orders are sent to.

Now when an order is placed, after the method of payment is verified, Interchange will send a copy of the order to the specified account. Procmail will determine that this message is about an online order, and will send the message to the script to be parsed. The script will parse the message and email the sender with the necessary license number(s).