Order API

Use this screen to configure ShopSite to run one or more CGI applications when customers make purchases. Your custom programs could do things like:

Update a third-party inventory database

Generate a dynamic page with a key for unlocking software for download

Stuff the order information into another system in real time

Be sure that your applications conform to the Order API Specification.

Note:

Some Order API applications may be incompatible with the PayPal payment method. If the PayPal payment method is enabled, the Order API application must not send any output to the browser (stdout).

Custom CGI Location

(Read only) The path to the ShopSite shopping cart directory. Order API applications can only be run from that directory.

Custom CGI Filename(s)

Enter the file name of the custom CGI application in the shopping cart directory. If you want ShopSite to run more than one application, enter the names in the order in which you want them run, separated by commas.

Only enter the file names of the custom CGI applications if you are sure they are ready to run. If improper permissions are set on the custom CGI, no orders will be processed.

You can enter customdump.cgi to see a sample program run; it should already be in your shopping cart directory. It will display all the information that is passed to it and display it on the receipt screen.

You can also study the sample Perl CGI program as an example. It simply passes through all of the information that it receives, like the customdump.cgi program.

E-mail receipts to buyer, merchant?

Check this box if you still want ShopSite to e-mail receipts to buyers and merchants.

Screen receipt for buyer?

Check this box if you still want ShopSite to display a receipt on the customer's screen. If your custom API displays a receipt to the customer, leave this box unchecked.

Pass Payment Information?

Select whether or not payment information such as Credit Card numbers should be sent to the external CGI. If you include payment information and are using merchant key encryption for credit card numbers, the card number will be encrypted in the Order API output.

Additional Parameters

Use these fields to enter any values required by your custom CGI applications, such as your account number.

ShopSite Help and Resource Center
Last updated: January 23, 2007
Give Feedback