EZ-NetTools Customer Support

Call Us: 800-627-4780

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.

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.

 EZ-Color Picker 
 Font | Color | Size 
 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> <!-- more HTML here --> <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"> <!-- Required to capture affiliateID --> <script src="http://abc.eznettools.net/javascript/affiliate.js"> </script> <script> <!-- if (getAccount () == document.checkout.memberID.value){ document.checkout.affiliateID.value = getAffiliateID(); } --> </script> <!-- End Required --> <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> <!-- more HTML here --> </body> </html>