Ez Checkout Application "API"

Ez Checkout Application "API"

The Checkout API is an advanced feature which requires knowledge of HTML or the ability to use FormBuilder and the advanced configuration features of EZ-NetTools. Using the API you can create a custom single or multiple part order form. You have the ability to specify different attributes for each item. Once a customer has finished filling out the order form and submits it, they are brought to EZ-Checkout where they fill out their shipping and payment information. When everything is complete, you may retrieve the order by clicking "Retrieve Orders" from the Administrative Tools menu of your EZ-NetTools account.

If you are inexperienced with HTML or the advanced configuration features, you can get a similar effect by adding an Order Button to your site. This will take you to an order form that contains all items in your catalog. You can add up to two attributes, that have the same title for every item on your order form, using the Optional Fields feature.

Directions

If you are developing an API form for the first time in HTML code, in your form tag, set the action of the form to "https://secure.eznettools.net/cgi-bin/EZCheckout/first" and you should have "post" as your method.

If you are developing an API form using FormBuilder, here are a few things to keep in mind. When adding your FormBuilder fields, don't forget to change the field names to the appropriate names. On your submit button that you add, add the following to the onclick properties of the button: "change_form();" You will also need to add the following code to the head code of the page, which is found under page options on the file menu:

In the code above, "form1" is the default name of the first form that you add to a page. If you have changed the form name, replace "form1" with your form's name.

Whichever method you decide to use, it is a good idea to have the fields that should not be changed by a customer (i.e. productID_N) as hidden fields. You can use any kind of form input elements that you like (i.e. text fields, drop-down boxes, etc.) to collect the data and make the page look nice for your customers. The title_N field is optional, but if you do not specify that field, customers will not see the product title of the item they ordered on their order confirmation. Appropriate field names are listed in the table below.

Administrative
Construction
Promotion
Resources

Construction
EZ-PageBuilder™

Utilities
	EZ-Browse EZ-Color Picker EZ-SpellChecker Font \| Color \| Size Form.cgi Ez Checkout "API"

Tutorial on API

This tutorial from EZ-NetU will describe how to set up a form using the Checkout API. Three examples are provided with the associated HTML code.

List Of Field Names:
Required fields are marked with a *

Name	Possible Values	Definition	Default
*memberID	A valid memberID where the CustomerType is of type 'M' and the Status is of type 'A'.	The memberID of the website that will process and serve this order.	N/A
affiliateID	Any string whose maximum length can be 20.	The affiliateID will be set automatically if an affiliate cookie has been set.	N/A
max_number_of_items	Any integer greater than zero.	The maximum amount of items that you will send from your form.	'10'
*productID_N	Any string whose maximum length can be 20.	The productID of of the Nth item.	N/A
title_N	Any string whose maximum length can be 40.	The title of the Nth item.	N/A
price_per_unit_N	Any real number.	The unit price of the Nth item.	'0.00'
*quantity_N	Any real number greater than zero.	The quantity ordered of the Nth item.	N/A
shipping_weight_N	Any real number.	The weight of one item of the Nth item.	'0.00'
shipping_price_N	Any real number.	The shipping cost for one item of the Nth item.	'0.00'
taxable_N	'1' or '0'	Whether or not the Nth item is taxable (1 means yes, 0 means no).	'0'
*max_number_of_attributes_N	Any integer greater than or equal to zero.	The maximum amount of attributes that can be applied to the Nth item.	'2'
attribute_K_name_N	Any string whose maximum length can be 20.	The name of the Kth attribute of the Nth item.	N/A
attribute_K_value_N	Any string whose maximum length can be 40.	The value of the Kth attribute of the Nth item.	N/A
shippable_N	'Y' or 'N'	Configures shipping for a product on or off	YES

Example Code: <html> <head> <title>Custom Order Form</title> </head> <body>  <form action="https://secure.eznettools.net/cgi-bin/EZCheckout/first" method="post" name="checkout"> <input type="hidden" name="memberID" value="X329910"> <input type="hidden" name="affiliateID">  <script src="http://abc.eznettools.net/javascript/affiliate.js"> </script> <script>  </script>  <input type="hidden" name="max_number_of_items" value="3"> <input type="hidden" name="productID_1" value="0001"> <input type="hidden" name="title_1" size="40" maxlength="40"> <input type="text" name="quantity_1" size="10" maxlength="10"> <input type="hidden" name="price_per_unit_1" value="29.95"> <input type="hidden" name="taxable_1" value="1"> <input type="hidden" name="shipping_price_1" value="5.00"> <input type="hidden" name="max_number_of_attributes_1" value="2"> <input type="text" name="attribute_1_value_1" size="40" maxlength="40"> <input type="hidden" name="attribute_1_name_1" value="size"> <input type="text" name="attribute_2_value_1" size="40" maxlength="40"> <input type="hidden" name="attribute_2_name_1" value="color"> <input type="hidden" name="shippable_N" value="N"> <input type="hidden" name="productID_2" value="0002"> <input type="hidden" name="title_2" size="40" maxlength="40"> <input type="text" name="quantity_2" size="10" maxlength="10"> <input type="hidden" name="price_per_unit_2" value="16.88"> <input type="hidden" name="taxable_2" value="1"> <input type="hidden" name="shipping_price_2" value="5.00"> <input type="hidden" name="max_number_of_attributes_2" value="1"> <input type="text" name="attribute_1_value_2" size="40" maxlength="40"> <input type="hidden" name="attribute_1_name_2" value="weight_in_grams"> <input type="hidden" name="shippable_Y" value="Y"> <input type="hidden" name="productID_3" value="0003"> <input type="hidden" name="title_3" size="40" maxlength="40"> <input type="text" name="quantity_3" size="10" maxlength="10"> <input type="hidden" name="price_per_unit_3" value="37.35"> <input type="hidden" name="taxable_3" value="1"> <input type="hidden" name="shipping_price_3" value="5.00"> <input type="hidden" name="max_number_of_attributes_1" value="3"> <input type="text" name="attribute_1_value_3" size="40" maxlength="40"> <input type="hidden" name="attribute_1_name_3" value="size"> <input type="text" name="attribute_2_value_3" size="40" maxlength="40"> <input type="hidden" name="attribute_2_name_3" value="color"> <input type="text" name="attribute_3_value_3" size="40" maxlength="40"> <input type="hidden" name="attribute_3_name_3" value="weight_in_grams"> <input type="submit" name="submit" value="Submit"> </form>  </body> </html>

Customer Support

Call Us: 800-627-4780