Application Programing Interface (API2) for using any shopping cart with the
ImagineNation IAMS credit card management services.

Sending the following values as a form post to the action URL will return a summary of the information with a form for collecting the customer's credit card data. An order confirmation page will follow upon successful processing of the customer's credit card with confirmation e-mails sent to the customer and the store. All gathered information is stored off-line in a database table dedicated to the store and accessable from the IAMS console. Critical information is encrypted.
action URLhttp://webPeddle.net/Store/Run/paydirect.cfm
Form Name Data Type Description
sidnumericthe service ID number issued when signing up for an IAMS account
sntextthe name of the store as listed in the IAMS console > PROFILE > store profile
potxttexta list of items ordered suitably configured to show item ID, quantity, description, and amount in an e-mail confirmation to the customer (see API test form for example)
polisttexta summary list of items ordered suitably configured to show item ID, quantity, description, and amount for display on shipping form (see API test form for example)
subtotalnumericthe total cost of the order less shipping and tax charges, NOTE: do not use currency symbols in numeric fields (local curency values will be converted to US$ for processing according to the currency conversion factor in the IAMS console > PROFILES > store profile)
shipvianumericshipping charge on order, defaults to 0.00 when no entry made
taxnumericthe tax on order, defaults to 0.00 when no entry made
orderemailtextthe e-mail address for sending a 3rd party copy of an order (can be left blank or have multiple addresses separated by commas)
remotehosttextthe CGI value identifying the IP of the customer (used as an element in fraud prevention)
refurltextthe purchase order number from originating cart
logourltextthe full URL to the store logo (will appear on shipping and credit card forms)
crnsyntextthe symbol or ID used with local currency (because of browser differences this is best written in abreviation IE: GBP for pounds sterling)
backgroundcolortextthe hex value or name of the page color for the shipping, credit card, and confirmation pages (defaults to light grey)
backgroundimagetextthe full URL to an image to be repeated in the background on the shipping, credit card, and confirmation pages
fontcolortextthe hex value or name of the color for the text on the shipping, credit card, and confirmation pages (must contrast with the page color, defaults to black)
shipformtextset value to API2
paybytextset value to cc
The customer's shipping information
customertextcustomer name
companytextoptional
locationtextphysical address for shipping an order
addresstextoptional (IE: a PO Box mailing address)
citytextrequired
statetextcounty, state, or province
ziptextpostal code
countrytextrequired
emailtextrequired
telephonetextrequired
The customer's billing information
cccustomertextcustomer name
ccaddresstextrequired, usually the same as location
cccitytextrequired
ccstatetextcounty, state, or province
ccziptextpostal code
cccountrytextrequired
ccemailtextrequired
cctelephonetextrequired
Copyright ImagineNation 1996 - 2006