Implementing this parameter is as easy as passing in the “fixed” parameter
with a value of “Y”. (Please note that this value is case sensitive and must be in uppercase.)

Example URL with “fixed” implemented:

https://www.2checkout.com/checkout/purchase?quantity=1&product_id=10&sid=11&fixed=Y

Example HTML form with “fixed” implemented:

<form action="https://www.2checkout.com/checkout/purchase" method="post">
<input type="hidden" name="sid" value="11" />
<input type="hidden" name="product_id1" value="9" />
<input type="hidden" name="quantity1" value="1" />
<input type="hidden" name="product_id2" value="10" />
<input type="hidden" name="quantity2" value="1" />
<input type="hidden" name="fixed" value="Y" />
<input name="submit" type="submit" value="Buy from 2CO" />
</form>

Important Note: When you are testing parameters, please be certain to clear the cookies in your browser between tests to ensure the changes you have made are applied.

If you are developing a 2CO-compatible shopping cart, this consolidates our technical requirements into a single document, based on the parameter set you prefer.

Most developers will want to refer to our custom parameter set as detailed in the article titled What are 2Checkout.com’s own parameters?

Developers who prefer to use our supported subset of Authorize.net parameters will want to refer to the article titled What Authorize.net parameters does 2CO support?

As always, if you have any questions about integrating our service with your product, please contact us directly by telephone or by opening a support ticket in the Tech Support category.

Let’s say that you are using the following link to sell your products or services to your customers:

https://www.2checkout.com/checkout/purchase?sid=XXXXXXX&total=20.00&cart_order_id=1234ABCD 

When this link is processed, the value 1234ABCD is listed as the “Purchase Item” on our Order Details page. For our example, we are a vendor selling widgets at variable prices. Because of the variable price, you are not able to use our plug and play parameters, which require a set price for a product. If we want the customer to be able to see which widget they are purchasing but still offer the variable price we can do this. First, we need to create the widgets in our vendor account products area. To do this log into your account and click on link #4, “Set Up Products”. Next click on “New Product” link located on the right hand side of the screen. We will now enter all the required fields to describe our widget. The first required field is “Your Product ID”. You will have the ability to reference this product using this value. For this example, let’s enter the value “W1?. The Name field will be displayed on the Order Details page so for this example let’s enter the value “Widget Block” in this field. When you get to the “Price” field don’t panic because it is required, the system will not read this value when placing a sale and this is not what the customer will be charged. What I recommend, to prevent customers from attempting to purchase from the built in 2Checkout Order Page is to set this value to a high value as opposed to a low value such as 1.00. Let’s enter 1000.00 in this field for our example. The next required field is “Tangible”. If your product can be shipped then you will select YES and if your product is not something that is shipped you will select NO. Choosing either one will not affect the sales process at all in this example. Because our widgets will be shipped let’s choose YES. Now click the “Create Product” button to complete our widget.

Now that we have our product created, we can edit our purchase link to reference the product. This is done by using the parameters, id_type and c_prod, which are part of our New Cart Purchase Parameters. Id_type can hold a value of 1 if you wish to reference your product from the “Your Vendor ID” value which you entered when you created your product or a value of 2 if you wish to reference the product based on the “Product ID” which is assigned to your product by the 2Checkout system. Because the assigned product ID could be any number depending on your specific account, we will set the id_type parameter to the value of 1. Now that we have decided to use the “Your Product ID” value, we need to reference the product in our link using the c_prod parameter with the “Your Product ID” value, W1, as the value of the parameter. Adding these 2 parameters will cause our link to look like the following:

https://www.2checkout.com/checkout/purchase?sid=XXXXXXX&total=20.00&cart_order_id=1234ABCD&id_type=1&c_prod=W1

When you process this link in your web browser you will see the “Purchase Item” of “1234ABCD” and Total of 20.00 just as we saw before. Below this information, we now see a section showing our Widget’s Product Name and a quantity, which defaults to 1. We have successfully displayed what product our customer purchased without actually using the product and price that was set in the 2Checkout account.

It is also very easy to add the quantity of the product purchased so the customer can see this as well. All you need to do is place a comma after your c_prod value and list the quantity value. For example if we sold 3 Widget Blocks to our customer, our link would look like the following:

https://www.2checkout.com/checkout/purchase?sid=XXXXXXX&total=20.00&cart_order_id=1234ABCD&id_type=1&c_prod=W1,3

You can also use this method to list more then one product on the Order Details page. Let’s say we had created a Widget Cube in our account that we gave a ID of W2. The customer then purchases 2 of these widgets in addition to 3 Widget Blocks. Our link would now look like this:

https://www.2checkout.com/checkout/purchase?sid=XXXXXXX&total=20.00&cart_order_id=1234ABCD&id_type=1&c_prod_1=W1,3&c_prod_2=W2,2

With closer inspection, you will see some changes in the parameters that we passed. If you pass in more then one c_prod parameter, you must place a underscore and then a digit after c_prod so our parameters are now c_prod_1 and c_prod_2. It is also important to point out that while we have 2 c_prod parameters we still are only required to pass in 1 id_type parameter. This parameter is applied to each c_prod value passed into the system.

After reading this article, you should be able to display product information to your customers on the 2Checkout Order Details page even if you are not using our Plug and Play Cart parameters.

Checkboxes are typically used when you want to allow a visitor of your site to select one or more options from a set of alternatives. In an HTML form the checkbox input type carries the following common attributes.

• Name – This attribute carries the name of the parameter that will be submitted with the form if the check box is checked. In our case this will carry the product_id parameter name.

• Value – This attribute holds the value of the name attribute and is the value of the parameter that is passed with the form when the checkbox is checked. In our case this will carry the assigned product ID of the product that is associated with the check box.

To define a checkbox in our form we will create the input type and add the 2 attributes. This would look like the following example:

<input type='checkbox' name='product_id' value='1' />

When checked, this checkbox will pass the parameter named product_id with a value of 1 to the URL attached to the HTML form.

Now that we understand the basic attributes of the checkbox input type, and how to define one in our form, we will create a simple example. This example will allow the customer to purchase 1 of any product when they check the checkbox. Remember to subscript your product_id and quantity parameters with a corresponding digit. This will allow the customer to select multiple products at one time along with a quantity that corresponds to the product_id with the same subscript.

<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='123' >
Product 1:
<input type='hidden' name='quantity1' value='1' >
<input type='checkbox' name='product_id1' value='1008' />
<br/>
Product 2:
<input type='hidden' name='quantity2' value='1' >
<input type='checkbox' name='product_id2' value='1014' >
<br/>
Product 3:
<input type='hidden' name='quantity3' value='1' >
<input type='checkbox' name='product_id3' value='1011' >
<br/>
<input name="submit" type='submit' value='Buy from 2CO' >
</form>

It is also very easy to add the ability for your customers to enter the quantity themselves as well. To do this we will replace this line:

<input type='hidden' name='quantity1' value='1' >

with the following:

<input name='quantity' type='text' class="ctrl-ed" size='5' >

Checkboxes can also be used to allow your customers the ability to purchase an add-on or option for your product. In this example, we have a product that you can purchase with the option of being a gift. First we start with our basic HTML snippet that is provided by the 2Checkout system.

<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='XXXXX' >
<input type='hidden' name='product_id' value='1' >
Quantity
<input name='quantity' type='text' class="ctrl-ed" size='5' >
<br>
<input name="submit" type='submit' value='Buy from 2CO' >
</form>

To allow the customer to choose the gift option we need to first add the checkbox input that will be linked to the gift product. You will create this gift add-on in your account as another 2Checkout product. Let’s say this add-on option is given a product ID of 2. The following lines need to be added to the above form.

This is a gift:

<input type='checkbox' name='product_id2' value='2' >
<input type='hidden' name='quantity2' value='1' >

After reading this article, you should be able to add the checkbox input to your purchase forms.