This method is only supported by the Classic (v1) version of the cart.

Not all merchants need the facilities of a full shopping cart. Many have only a handful of products and a simple order form may be all that is required. Also some merchants already have some sort of ordering system and just want to take advantage of the payment processes built into our systems.


To help in these circumstances we have created a script which allows you to place a form on your website which collects the customers name, address and product details they wish to purchase. This form can be posted straight into a Payment options page.


OK, it sounds simple but it isn't!


The script will draw on your setup in Admin in order to calculate tax, shipping and discounts. In some case that means it is necessary to include extra information for those calculations to be made. In addition, in some cases, the data must conform to the correct format.


So this is a complex script, indeed in many ways it's a condensed version of the whole cart, and needs to be setup very carefully in order to work properly. You have been warned....


The pay.cfm script does not support shipping calculations using the Advanced shipping system.


BASIC SYNTAX

Your form method must be POST and the action URL should be set to:




Products. Products are posted in exactly the same way as the multi-product form for adding items to the cart, the so called addmulti.cfm script. Click here for details.


Name and address. In addition to the products the customer may wish to purchase you need to collect the customers name and address. If you want you can also include their delivery address as well. The field names are:

 

Value Field name Optional
Invoice to name inv_name
Invoice to company inv_company
Invoice to address inv_addr1
Invoice to city inv_addr2
Invoice to state inv_state
Invoice to ZIP/Postal code inv_zip
Invoice to country inv_country
Telephone number tel Yes
Fax number fax Yes
Email address email
Ship to name del_name Yes
Ship to company del_company Yes
Ship to address del_addr1 Yes
Ship to city del_addr2 Yes
Ship to state del_state Yes
Ship to ZIP/Postal code del_zip Yes
Ship to country del_country Yes
Ship Tel del_tel Yes
Tax Id taxidno Yes

 

Form fields for name, invoice address and shipping address will be validated in accordance to the rules you have setup in Admin >> Required fields.


Messages The script can also accept an incoming message field. This can be as simple as form field named message or something much more complex. Once again the syntax conforms to Method 2 for posting a message into the cart. Click here for details.


REQUIREMENTS FOR SPECIFIC SETUP OPTIONS

Shipping by zones, options 4 to 7: In setting up these shipping options you may have anything from one to five different zones. If you have only one then you don't need to worry about it. However if you have more than one then you should include a field made from either radio buttons or a drop down selection corresponding to your zones.


The name of the field for your shipping zones selection should be shipping_zone. The values should be in a range from 1 to 5. If you post in a value that doesn't exist, for example you post 5 when you have only 4 zones setup then an error message will be generated.


Tax check box: If you have this tax option selected then include in your form a check box field with the name taxable with any value (for example value=1). When checked tax will be included.


Tax by US State: This option will take the input from the inv_state field. However the state must come in as a two letter code.


Formats for specific Payment Gateways: Many payment gateways (including PayPal, Sagepay, Worldpay) needs the inv_country field to be an ISO two letter code. Click here for the HTML for such a list. It will open in a new window.

 

EXAMPLE



Name
Company
Address
City
State
Zip
Country
Phone
Email

AwarePro Viewer @ $199


AwarePro Authoring Kit (Create) @ $299


AwarePro Export Utility @ $249


AwarePro Viewer User Manual (printed copy) @ $49.95