<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>2Checkout.com &#187; Parameter Sets</title>
	<atom:link href="http://www.2checkout.com/blog/category/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.2checkout.com</link>
	<description>merchant account / credit card processing alternative</description>
	<lastBuildDate>Thu, 09 Feb 2012 15:02:36 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.3.1</generator>
<xhtml:meta xmlns:xhtml="http://www.w3.org/1999/xhtml" name="robots" content="noindex" />
		<item>
		<title>What are the parameters for your Pass Through Product Parameter Set?</title>
		<link>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/pass-through-product-parameter-set/</link>
		<comments>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/pass-through-product-parameter-set/#comments</comments>
		<pubDate>Thu, 10 Mar 2011 16:56:54 +0000</pubDate>
		<dc:creator>ricks</dc:creator>
				<category><![CDATA[Parameter Sets]]></category>

		<guid isPermaLink="false">http://www.2checkout.com/?p=6002</guid>
		<description><![CDATA[These parameters can be used to dynamically pass in tangible/intangible and recurring/non-recurring products, product options, shipping, taxes and coupons as items without having to create the products in the admin area. Multi-page Payment Routine: https://www.2checkout.com/checkout/purchase Supports tangible and intangible products/services. Single Page Payment Routine: https://www.2checkout.com/checkout/spurchase Can only be used to sell intangible products when using [...]]]></description>
			<content:encoded><![CDATA[<p>These parameters can be used to dynamically pass in tangible/intangible and recurring/non-recurring products, product options, shipping, taxes and coupons as items without having to create the products in the admin area.</p>
<p><span id="more-6002"></span><strong><span style="text-decoration: underline;">Multi-page Payment Routine</span>:</strong></p>
<p>https://www.2checkout.com/checkout/purchase</p>
<p><em>Supports tangible and intangible products/services.</em></p>
<p><strong><span style="text-decoration: underline;">Single Page Payment Routine</span>:</strong></p>
<p>https://www.2checkout.com/checkout/spurchase</p>
<p><em>Can only be used to sell intangible products when using this parameter set.<br />
</em></p>
<p><span style="text-decoration: underline;"><strong>Required Parameters</strong></span><strong>:</strong><br />
<strong>sid- </strong>Your 2Checkout account number.<br />
<strong>mode- </strong>Defines the parameter set. Should always be passed as &#8217;2CO&#8217;.<br />
<strong>li_#_type</strong>- The type of line item that is being passed in. <em>(&#8216;product&#8217;, &#8216;shipping&#8217;, &#8216;tax&#8217; or &#8216;coupon&#8217;, defaults to &#8216;product&#8217;)</em><br />
<strong>li_#_name</strong>- Name of the item passed in with the corresponding li_#_type. <em>(128 characters max, cannot use &#8216;&lt;&#8217; or &#8216;&gt;&#8217;, defaults to capitalized version of &#8216;type&#8217;.)</em><br />
<strong>li_#_quantity</strong>- Quantity of the item passed in with the corresponding li_#_type. <em>(0-999, defaults to 1 if not passed in.)</em><br />
<strong>li_#_price</strong>- Price of the line item. <strong>Format:</strong><em> 0.00-99999999.99, defaults to 0 if a value isn&#8217;t passed in, no negatives (use positive values for coupons), leading 0 &amp; decimal are optional. </em><strong>Important note: </strong>If the li_#_price parameter isn&#8217;t used to pass in line item pricing, the pricing for the corresponding item will default to 0.00.<br />
<strong>li_#_tangible</strong>- Specifies if the corresponding li_#_type is a tangible or intangible. <em>&#8216;Y&#8217; or &#8216;N&#8217;, if li_#_type is &#8216;shipping&#8217; forced to &#8216;Y&#8217;.</em></p>
<p>You can use these parameters to pass in multiple products as well. To do so you will need to append a digit to each parameter. For example, li_0_type, li_0_quantity, li_0_name, li_0_price, li_0_product_id, li_0_description, li_0_tangible will describe the first product, then to describe the second product you would use a 1 so the parameters will read li_1_type, li_1_quantity, and so on. <strong>Please note: </strong>With this parameter set # may be represented by 0-999 and aren&#8217;t required to be consecutive.</p>
<p><strong><span style="text-decoration: underline;">Additional Parameters</span>:</strong><br />
<strong>li_#_product_id</strong>- Id that you use to identify the product. <em> 64 characters max, cannot use &#8216;&lt;&#8217; or &#8216;&gt;&#8217;.</em><strong> </strong><br />
<strong>li_#_description</strong>- Description you use for the product. <em>255 characters max, cannot use &#8216;&lt;&#8217; or &#8216;&gt;&#8217;.</em><br />
<strong>li_#_recurrence</strong>- Sets billing frequency. Ex. &#8217;1 Week&#8217; to bill order once a week. (Can use #Week|Month|Year, always singular.)<br />
<strong>li_#_duration</strong>- Sets how long to continue billing. Ex. &#8217;1 Year&#8217;, to continue billing based on li_#_recurrence for 1 year. (Forever or # Week|Month|Year &#8211; always singular, defaults to Forever)<br />
<strong>li_#_startup_fee</strong>- Any start up fees for the product or service. Can be negative to provide discounted first installment pricing, but cannot equal or surpass the product price.<br />
<strong>li_#_option_#_name- </strong>Name of product option. Ex. Size (64 characters max &#8211; cannot include &#8216;&lt;&#8217; or &#8216;&gt;&#8217;)<br />
<strong>li_#_option_#_value- </strong>Option selected. Ex. Small (64 characters max- cannot include &#8216;&lt;&#8217; or &#8216;&gt;&#8217;)<br />
<strong>li_#_option_#_surcharge</strong>- Option price in seller currency. (0.00 for no cost options)<br />
<strong>demo</strong> &#8211; Y to enable demo mode.  Do not pass for live sales.  Can also be controlled <a href="http://www.2checkout.com/blog/newest/new-feature-control-demo-from-inside-your-2checkout-account/">within the account</a>.<br />
<strong>lang</strong> &#8211; Chinese &#8211; zh, Danish &#8211; da, Dutch &#8211; nl, French &#8211; fr, German &#8211; gr, Greek &#8211; el, Italian &#8211; it, Japanese &#8211; jp, Norwegian &#8211; no, Portuguese &#8211; pt, Slovenian &#8211; sl, Spanish &#8211; es_ib, Spanish &#8211; es_la, Swedish &#8211; sv, defaults to English if this is absent, but en may be used for English as well.<br />
<strong>merchant_order_id</strong> &#8211; Specify your order number with this parameter. It will also be included in the confirmation emails to yourself and the customer. <span style="color: #666666;"><em>(50 characters max)</em></span><br />
<strong>pay_method</strong> &#8211; CC for Credit Card, PPI for PayPal. This will set the default selection on the payment method step during the checkout process.<br />
<strong>skip_landing</strong> &#8211; If set to 1 it will skip the order review page of the purchase routine.<br />
<strong>x_Receipt_Link_URL</strong> &#8211; Used to specify an approved URL on-the-fly, but is limited to the same domain that is used for your 2Checkout account, otherwise it will fail. This parameter will over-ride any URL set on the Site Management page. <em>(no limit)</em><br />
<strong>coupon</strong> &#8211; Specify a 2Checkout created coupon code. If applicable, the coupon will be automatically applied to the sale.</p>
<p><span style="text-decoration: underline;"><strong>To pre populate the billing information page you may pass in</strong></span>:<br />
<strong>card_holder_name</strong> &#8211; Card holder&#8217;s name <span style="color: #666666;"><em>(128 characters max)</em></span></p>
<blockquote><p><em>The card holder&#8217;s name can also be populated using the <strong>first_name</strong>, <strong>middle_initial</strong>, and <strong>last_name</strong> parameters. <strong>IMPORTANT:</strong> If you use these three parameters, the data will be combined into and returned as <strong>card_holder_name</strong> to your Approved URL script.</em></p></blockquote>
<p><strong>street_address</strong> &#8211; Card holder&#8217;s street address<span style="color: #666666;"><em>(64 characters max)</em></span><br />
<strong>street_address2</strong> &#8211; The second line for the street address, typically suburb or apartment number information <span style="color: #666666;"><em>(64 characters max)</em></span><br />
<strong>city</strong> &#8211; Card holder&#8217;s city <span style="color: #666666;"><em>(64 characters max)</em></span><br />
<strong>state</strong> &#8211; Card holder&#8217;s state <span style="color: #666666;"><em>(64 characters max)</em></span><br />
<strong>zip</strong> &#8211; Card holder&#8217;s zip <span style="color: #666666;"><em>(16 characters max)</em></span><br />
<strong>country</strong> &#8211; Card holder&#8217;s country <span style="color: #666666;"><em>(64 characters max)</em></span><br />
<strong>email</strong> &#8211; Card holder&#8217;s email <span style="color: #666666;"><em>(64 characters max)</em></span><br />
<strong>phone</strong> &#8211; Card holder&#8217;s phone <span style="color: #666666;"><em>(16 characters max)</em></span><br />
<strong>phone_extension</strong> &#8211; Card holder&#8217;s phone extension <span style="color: #666666;"><em>(9 characters max)</em></span></p>
<p><strong><span style="text-decoration: underline;">To pre populate the shipping information page you may pass in</span>:<br />
ship_name<br />
ship_street_address<br />
ship_street_address2<br />
ship_city<br />
ship_state<br />
ship_zip<br />
ship_country</strong></p>
<p>Please note that shipping information will only be collected for items that are defined as tangible in our system. Shipping is also only charged for tangible items.</p>
<p>The billing information page will also be populated with the information from the shipping page if the shipping information is collected on that sale and the billing information is not passed in.</p>
<p><strong><span style="text-decoration: underline;">Custom Parameters</span>:</strong><br />
You may pass in any additional parameters that you may need and they will be returned to you at the end of the sale. The only restrictions on custom parameters are that they can not share the name of ANY parameter that our system uses, even from the other sets. Please note that you WILL need a return script set up on the Site Management page to receive any of these parameters back as they are not included in the confirmation emails.</p>
<p><strong><span style="text-decoration: underline;">You can receive back all of the parameters that were passed in as well as the following parameters</span>:</strong><br />
<strong>order_number</strong> &#8211; 2Checkout.com order number<strong></strong><br />
<strong>credit_card_processed</strong> &#8211; Y if successful (Approved).<br />
<strong>key</strong> &#8211; the MD5 hash used to verify that the sale came from one of our servers</p>
<p>Consult the documentation that came with your cart or contact the cart manufacturer for assistance with setting this up or to determine what URL you should enter on the Site Management for your cart to receive the sale confirmation.</p>
<p><strong><span style="text-decoration: underline;"><em>Important</em></span><em>: </em></strong><em>You can not mix the four parameter sets. This will cause problems during payment or may prevent the payment pages from working at all.</em></p>
<p><strong>Please Note:</strong> If an order includes a product that is defined as tangible or a shipping method it will need to be marked as shipped before it will deposit into your pending payment. If the order is not marked as shipped with-in 7 days of being placed, it will need to be reauthorized prior to being marked as shipped. For more information on marking sales as shipped in the admin, please visit the Marking Orders as Shipped section of our <a href="http://www.2checkout.com/documentation/User_Guide.pdf">User Guide</a>. This can also be done programmatically using our reauth and mark_shipped API calls which are outlined in the <a href="http://www.2checkout.com/documentation/api/">API documentation</a>.</p>
<p><strong>Important Note:</strong> 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. For more information on clearing the cookies please click <a href="http://www.2checkout.com/blog/knowledge-base/suppliers/tech-support/clearing-cache-and-cookies-2/">here</a>.</p>
<p><strong>Related Article:</strong> <a href="http://www.2checkout.com/blog/knowledge-base/country-codes/">Country Codes</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/pass-through-product-parameter-set/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>New Single Page Checkout Announced</title>
		<link>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/new-single-page-checkout-announced/</link>
		<comments>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/new-single-page-checkout-announced/#comments</comments>
		<pubDate>Wed, 05 Mar 2008 17:29:35 +0000</pubDate>
		<dc:creator>cliff</dc:creator>
				<category><![CDATA[2Checkout Blog]]></category>
		<category><![CDATA[Parameter Sets]]></category>
		<category><![CDATA[forms]]></category>
		<category><![CDATA[purchase links]]></category>
		<category><![CDATA[purchase routine]]></category>

		<guid isPermaLink="false">http://www.2checkout.com/community/blog/knowledge-base/tech-support/3rd-party-carts/parameter-sets/new-single-page-checkout-announced/</guid>
		<description><![CDATA[2Checkout.com, Inc. is excited to announce the launch of our new Single Page Checkout process. Many of our clients have been asking for a faster, more efficient, customer experience. We heard those requests and are now happy to deliver the fastest checkout possible for clients that produce intangible goods/services. To maximize compatibility, all current 2CO [...]]]></description>
			<content:encoded><![CDATA[<p>2Checkout.com, Inc. is excited to announce the launch of our new Single Page Checkout process.</p>
<p>Many of our clients have been asking for a faster, more efficient, customer experience. We heard those requests and are now happy to deliver the fastest checkout possible for clients that produce intangible goods/services.</p>
<p>To maximize compatibility, all current 2CO parameter sets are supported.</p>
<p>To maximize efficiency, only intangible products and credit card payments are enabled with this routine.</p>
<p><strong>Please note:</strong> Accounts using third party carts are able to use the Single Page Purchase routine for both tangible and intangible products/services. </p>
<p>To address the needs of clients who produce tangible goods and those who want to benefit from all the alternative payment options 2CO accepts, the traditional multi-page checkout process will remain as the default.</p>
<p>This new single page purchase routine may be used with the <a href="http://www.2checkout.com/blog/category/knowledge-base/tech-support/3rd-party-carts/parameter-sets/">PNP and third party cart parameter sets</a>, by simply replacing the default purchase routine with this one:</p>
<pre><code>https://www.2checkout.com/checkout/spurchase</code></pre>
<p><a href="https://www.2checkout.com/checkout/spurchase?sid=11&amp;cart_order_id=TESTCART&amp;total=1.00&amp;c_prod=1&amp;id_type=2">Click here to see a working demonstration. </a></p>
<p>We are confident that the new routine will streamline the checkout process for appropriate offerings and therefore increase conversion rates.  2CO will monitor conversion results closely.  It is also recommended that each client evaluate their individual results independently.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/new-single-page-checkout-announced/feed/</wfw:commentRss>
		<slash:comments>79</slash:comments>
		</item>
		<item>
		<title>What Authorize.net parameters does 2CO support?</title>
		<link>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/does-your-system-support-authorizenet-parameters-if-so-what-are-they/</link>
		<comments>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/does-your-system-support-authorizenet-parameters-if-so-what-are-they/#comments</comments>
		<pubDate>Sat, 30 Dec 2006 07:00:00 +0000</pubDate>
		<dc:creator>knowledgebase</dc:creator>
				<category><![CDATA[Parameter Sets]]></category>
		<category><![CDATA[Authorize.net]]></category>
		<category><![CDATA[cart]]></category>
		<category><![CDATA[parameters]]></category>
		<category><![CDATA[third party carts]]></category>

		<guid isPermaLink="false">https://192.168.2.217/fresh/blog/2006/12/30/does-your-system-support-authorizenet-parameters-if-so-what-are-they/</guid>
		<description><![CDATA[Below you will find a listing of the supported Authorize.net-compatible parameters and what information each parameter should contain. This parameter set is used by third party carts and custom designed scripts. Please note that 2Checkout must know what is being sold in every sale. There are parameters available that allow for dynamic product creation. These [...]]]></description>
			<content:encoded><![CDATA[<p>Below you will find a listing of the supported Authorize.net-compatible parameters and what information each parameter should contain. This parameter set is used by third party carts and custom designed scripts. Please note that 2Checkout must know what is being sold in every sale. There are parameters available that allow for dynamic product creation. These will be discussed as well, and must be used if you are using this parameter set, but they are not Authorize.Net specific. If you would like to test your integration of these parameters, try using our <a href="http://developers.2checkout.com/code_machine">developers.2Checkout area</a>.</p>
<p><strong><span style="text-decoration: underline">Multi-page Payment Routine</span>:</strong></p>
<p>https://www.2checkout.com/checkout/purchase</p>
<p><em>Supports tangible and intangible products/services.</em></p>
<p><strong><span style="text-decoration: underline">Single Page Payment Routine</span>:</strong></p>
<p>https://www.2checkout.com/checkout/spurchase</p>
<p><em>Can be used to sell tangible and intangible products/services when using third party carts.</em></p>
<p><strong><span style="text-decoration: underline">Required Parameters</span>:</strong><br />
<strong>x_login</strong> &#8211; Your numerical 2Checkout account number.<br />
<strong>x_amount</strong> &#8211; The total amount to be billed, without a currency symbol, and only two decimal places if used<em><span style="color: #666666"> (8 characters, decimal, 2 characters: Example: 99999999.99)</span></em><br />
<strong>x_invoice_num</strong> &#8211; A unique order id from your system. <span style="color: #666666"><em>(64 characters max)</em></span></p>
<p><strong><span style="text-decoration: underline">Product Identification Parameters</span>:</strong><br />
Sites using this parameter set must pass in parameters to identify what is being sold during the purchase. These parameters will also be beneficial as when used correctly the product information will be displayed to customers on the purchase pages and will be listed on the 2Checkout.com sale detail page.</p>
<p><strong>id_type</strong> &#8211; Due to changes in with the Product Identification parameters this parameter should be passed in once during the purchase and will need to have its value set to 1.<br />
<strong>c_prod</strong> &#8211; The ID of the product that is being purchased.  The quantity of the product being purchased can be passed with this parameter by placing a comma after the ID and then the quantity in numeric format.<br />
<strong>c_name</strong> &#8211; The value of this parameter should contain the name of the  product to be created. <span style="color: #666666"><em>(128 characters max)</em></span><br />
<strong>c_description</strong> &#8211; The value of this parameter should contain a short description of the product to be sold.  <span style="color: #666666"><em>(255 characters max)</em></span><br />
<strong>c_price</strong> &#8211; The price of your product.  Please note that in order to prevent a discrepancy between the total parameter and the sum of the product identification c_price parameters which may confuse the customer, the product price will not be displayed on the purchase page.  <span style="color: #666666"><em>(8 characters, decimal, 2 characters: Example: 99999999.99)</em></span></p>
<p>You can use these identification parameters to pass in multiple products as well. To do so you will need to append a digit to each parameter. For example, c_prod_1, c_name_1, c_description_1, c_price_1 will describe the first product, then to describe the second product you would use a 2 so the parameters will read c_prod_2, c_name_2 and so on.</p>
<p><strong><span style="text-decoration: underline">Additional Parameters</span>:</strong><br />
<strong>demo</strong> &#8211; Y to enable demo mode. Do not pass this in for live sales.  Can also be controlled <a href="http://www.2checkout.com/blog/newest/new-feature-control-demo-from-inside-your-2checkout-account/">within the account</a>.<br />
<strong>lang</strong> &#8211; Chinese &#8211; zh, Danish &#8211; da, Dutch &#8211; nl, French &#8211; fr, German &#8211; gr, Greek &#8211; el, Italian &#8211; it, Japanese &#8211; jp, Norwegian &#8211; no, Portuguese &#8211; pt, Slovenian &#8211; sl, Spanish &#8211; es_ib, Spanish &#8211; es_la, Swedish &#8211; sv, defaults to English if this is absent, but en may be used for English as well.<br />
<strong>merchant_order_id</strong> &#8211; Specify your order number with this parameter. It will also be included in the confirmation emails to yourself and the customer. <span style="color: #666666"><em>(50 characters max)</em></span><br />
<strong>pay_method</strong> &#8211; CC for Credit Card, CK for check, PPI for PayPal. This will set the default selection on the payment method step during the checkout process.<br />
<strong>skip_landing</strong> &#8211; If set to 1 it will skip the order review page of the purchase routine.<br />
<strong>x_Receipt_Link_URL</strong> &#8211; Used to specify an approved URL on-the-fly, but is limited to the same domain that is used for your 2Checkout account, otherwise it will fail. This parameter will over-ride any URL set on the Site Management page. <em>(no limit)</em><br />
<strong>coupon</strong> &#8211; Specify a 2Checkout created coupon code. If applicable, the coupon will be automatically applied to the sale.</p>
<p><strong><span style="text-decoration: underline">To populate the billing information page you may pass in</span>: </strong><br />
<strong>x_First_Name</strong> &#8211; buyers first name<span style="color: #666666"><em> (64 characters max)</em></span><br />
<strong>x_Last_Name</strong> &#8211; buyers last name<span style="color: #666666"><em> (64 characters max)</em></span><br />
<strong>x_Phone</strong> &#8211; buyers phone number<span style="color: #666666"><em> (16 characters max)</em></span><br />
<strong>x_Email </strong>- buyers email address<span style="color: #666666"><em> (64 characters max)</em></span><br />
<strong>x_Address</strong> &#8211; buyers address<span style="color: #666666"><em> (64 characters max)</em></span><br />
<strong>x_City</strong> &#8211; buyers city<span style="color: #666666"><em> (64 characters max)</em></span><br />
<strong>x_State</strong> &#8211; buyers state<span style="color: #666666"><em> (64 characters max)</em></span><br />
<strong>x_Zip</strong> &#8211; buyers zip code<span style="color: #666666"><em> (16 characters max)</em></span><br />
<strong>x_Country</strong> &#8211; buyers country<span style="color: #666666"><em> (64 characters max)</em></span></p>
<p><strong><span style="text-decoration: underline">To populate the shipping information page you may pass in</span>: </strong><br />
<strong>x_Ship_To_First_Name<br />
x_Ship_To_Last_Name<br />
x_Ship_To_Address<br />
x_Ship_To_City<br />
x_Ship_To_Country<br />
x_Ship_To_State<br />
x_Ship_To_Zip</strong></p>
<p>Please note that since this parameter set is for third party shopping carts, we do not collect shipping information for these types of orders. This is because your cart is responsible for calculating the shipping and it is passed in as part of the x_amount parameter.</p>
<p>It is also important to note that when using the Authorize.Net set of parameters, 2CO only requires the three listed under the required section. We will therefore not passback strictly Authorize.Net style parameters for everything unless they are passed in to us. This is not often a problem as most carts do this anyways. For example, x_First_Name and x_Last_Name will prepopulate the billing name, but 2CO uses card_holder_name for this. card_holder_name will then be returned unless x_First_Name and x_Last_Name are passed into 2Checkout.</p>
<p><strong><span style="text-decoration: underline">Custom Parameters</span>:</strong><br />
You may pass in any additional parameters that you may need and they will be returned to you at the end of the sale. The only restrictions on custom parameters are that they can not share the name of ANY parameter that our system uses, even from the other sets. Please note that you WILL need a return script set up on the Site Management page to receive any of these parameters back as they are not included in the confirmation emails.</p>
<p><strong><span style="text-decoration: underline">Return Parameters</span>:</strong><br />
<span style="text-decoration: underline">You can receive back all of the parameters that were passed in as well as the following parameters</span>:<br />
<strong>x_2checked</strong> &#8211; Y if card was successfully processed.<br />
<strong>x_MD5_Hash</strong> &#8211; The MD5 hash that can be used to verify that the sale came from a 2CO server.<br />
<strong>x_trans_id</strong> &#8211; the 2CO order number for the order.</p>
<p>Using this parameter set, we are not receiving any product information. As you can see, you are only passing in a total amount to us. Usually, the cart will have some means of using the x_invoice_num to determine what was purchased after the sale. A return URL will need to be set up on the Site Management page for the cart to correctly determine this.</p>
<p>Consult the documentation that came with your cart or contact the cart manufacturer for assistance with setting this up or to determine what URL you should enter on the Site Management page for your cart to receive the product information.</p>
<p>Recurring billing can not be done with this parameter set. You must use the Plug-N-Play parameter set and have the products defined within the 2CO database for recurring billing.</p>
<p><strong><em>Important:</em></strong><em> You can not mix the three parameter sets. This will cause problems during payment or may prevent the payment pages from working at all.</em></p>
<p><strong>Important Note:</strong> 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. For more information on clearing the cookies please click <a href="http://www.2checkout.com/blog/knowledge-base/suppliers/tech-support/clearing-cache-and-cookies-2/">here</a>.</p>
<p><strong>Related Article:</strong> <a href="http://www.2checkout.com/blog/knowledge-base/country-codes/">Country Codes</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/does-your-system-support-authorizenet-parameters-if-so-what-are-they/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>What are 2Checkout.com&#8217;s own parameters?</title>
		<link>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/does-your-system-have-its-own-parameters-if-so-what-are-they/</link>
		<comments>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/does-your-system-have-its-own-parameters-if-so-what-are-they/#comments</comments>
		<pubDate>Sat, 30 Dec 2006 07:00:00 +0000</pubDate>
		<dc:creator>knowledgebase</dc:creator>
				<category><![CDATA[Parameter Sets]]></category>
		<category><![CDATA[cart]]></category>
		<category><![CDATA[parameters]]></category>
		<category><![CDATA[third party carts]]></category>

		<guid isPermaLink="false">https://192.168.2.217/fresh/blog/2006/12/30/does-your-system-have-its-own-parameters-if-so-what-are-they/</guid>
		<description><![CDATA[2CO has our own proprietary set of parameters that you can use if your cart supports them. If you would like to test your integration of these parameters, try using our developers.2Checkout area. Multi-page Payment Routine: https://www.2checkout.com/checkout/purchase Supports tangible and intangible products/services. Single Page Payment Routine: https://www.2checkout.com/checkout/spurchase Can be used to sell tangible and intangible [...]]]></description>
			<content:encoded><![CDATA[<p>2CO has our own proprietary set of parameters that you can use if your cart supports them. If you would like to test your integration of these parameters, try using our <a href="http://developers.2checkout.com/code_machine">developers.2Checkout area</a>.</p>
<p><strong><span style="text-decoration: underline">Multi-page Payment Routine</span>:</strong></p>
<p>https://www.2checkout.com/checkout/purchase</p>
<p><em>Supports tangible and intangible products/services.</em></p>
<p><strong><span style="text-decoration: underline">Single Page Payment Routine</span>:</strong></p>
<p>https://www.2checkout.com/checkout/spurchase</p>
<p><em>Can be used to sell tangible and intangible products/services when using third party carts.<br />
</em></p>
<p><span style="text-decoration: underline"><strong>Required Parameters</strong></span><strong>:</strong><br />
<strong>sid</strong> &#8211; Your 2Checkout account number.<br />
<strong>total</strong> &#8211; The total amount to be billed, in decimal form, without a currency symbol. <span style="color: #666666"><em>(8 characters, decimal, 2 characters: Example: 99999999.99)</em></span><br />
<strong>cart_order_id</strong> &#8211; A unique order id from your program. <span style="color: #666666"><em>(128 characters max)</em></span></p>
<p><strong><span style="text-decoration: underline">Product Identification Parameters</span>:</strong><br />
Sites using this parameter set must pass in parameters to identify what is being sold during the purchase. These parameters will also be beneficial as when used correctly the product information will be displayed to customers on the purchase pages and will be listed on the 2Checkout.com sale detail page.</p>
<p><strong>id_type</strong> &#8211; Due to changes in with the Product Identification parameters this parameter should be passed in once during the purchase and will need to have its value set to 1.<br />
<strong>c_prod</strong> &#8211; The ID of the product that is being purchased.  The quantity of product being purchased can passed with this parameter by placing a comma after the ID and then the quantity in numeric format.<br />
<strong>c_name</strong> &#8211; The value of this parameter should contain the name of the  product to be created. <span style="color: #666666"><em>(128 characters max)</em></span><br />
<strong>c_description</strong> &#8211; The value of this parameter should contain a short description of the product to be sold.  <span style="color: #666666"><em>(255 characters max)</em></span><br />
<strong>c_price</strong> &#8211; The price of your product.  Please note that in order to prevent a discrepancy between the total parameter and the sum of the product identification c_price parameters which may confuse the customer, the product price will not be displayed on the purchase page.  <span style="color: #666666"><em>(8 characters, decimal, 2 characters: Example: 99999999.99)</em></span></p>
<p>You can use these identification parameters to pass in multiple products as well. To do so you will need to append a digit to each parameter. For example, c_prod_1, c_name_1, c_description_1, c_price_1 will describe the first product, then to describe the second product you would use a 2 so the parameters will read c_prod_2, c_name_2 and so on.</p>
<p><strong><span style="text-decoration: underline">Additional Parameters</span>:<br />
</strong> <strong>demo</strong> &#8211; Y to enable demo mode.  Do not pass for live sales.  Can also be controlled <a href="http://www.2checkout.com/blog/newest/new-feature-control-demo-from-inside-your-2checkout-account/">within the account</a>.<br />
<strong>lang</strong> &#8211; Chinese &#8211; zh, Danish &#8211; da, Dutch &#8211; nl, French &#8211; fr, German &#8211; gr, Greek &#8211; el, Italian &#8211; it, Japanese &#8211; jp, Norwegian &#8211; no, Portuguese &#8211; pt, Slovenian &#8211; sl, Spanish &#8211; es_ib, Spanish &#8211; es_la, Swedish &#8211; sv, defaults to English if this is absent, but en may be used for English as well.<br />
<strong>merchant_order_id</strong> &#8211; Specify your order number with this parameter. It will also be included in the confirmation emails to yourself and the customer. <span style="color: #666666"><em>(50 characters max)</em></span><br />
<strong>pay_method</strong> &#8211; CC for Credit Card, CK for check, PPI for PayPal. This will set the default selection on the payment method step during the checkout process.<br />
<strong>skip_landing</strong> &#8211; If set to 1 it will skip the order review page of the purchase routine.<br />
<strong>x_Receipt_Link_URL</strong> &#8211; Used to specify an approved URL on-the-fly, but is limited to the same domain that is used for your 2Checkout account, otherwise it will fail. This parameter will over-ride any URL set on the Site Management page. <em>(no limit)</em><br />
<strong>coupon</strong> &#8211; Specify a 2Checkout created coupon code. If applicable, the coupon will be automatically applied to the sale.</p>
<p><span style="text-decoration: underline"><strong>To pre populate the billing information page you may pass in</strong></span>:<br />
<strong>card_holder_name</strong> &#8211; Card holder&#8217;s name <span style="color: #666666"><em>(128 characters max)</em></span></p>
<blockquote><p><em>The card holder&#8217;s name can also be populated using the <strong>first_name</strong>, <strong>middle_initial</strong>, and <strong>last_name</strong> parameters. <strong>IMPORTANT:</strong> If you use these three parameters, the data will be combined into and returned as <strong>card_holder_name</strong> to your Approved URL script.</em></p></blockquote>
<p><strong>street_address</strong> &#8211; Card holder&#8217;s street address<span style="color: #666666"><em>(64 characters max)</em></span><br />
<strong>street_address2</strong> &#8211; The second line for the street address, typically suburb or apartment number information <span style="color: #666666"><em>(64 characters max)</em></span><br />
<strong>city</strong> &#8211; Card holder&#8217;s city <span style="color: #666666"><em>(64 characters max)</em></span><br />
<strong>state</strong> &#8211; Card holder&#8217;s state <span style="color: #666666"><em>(64 characters max)</em></span><br />
<strong>zip</strong> &#8211; Card holder&#8217;s zip <span style="color: #666666"><em>(16 characters max)</em></span><br />
<strong>country</strong> &#8211; Card holder&#8217;s country <span style="color: #666666"><em>(64 characters max)</em></span><br />
<strong>email</strong> &#8211; Card holder&#8217;s email <span style="color: #666666"><em>(64 characters max)</em></span><br />
<strong>phone</strong> &#8211; Card holder&#8217;s phone <span style="color: #666666"><em>(16 characters max)</em></span><br />
<strong>phone_extension</strong> &#8211; Card holder&#8217;s phone extension <span style="color: #666666"><em>(9 characters max)</em></span></p>
<p><strong><span style="text-decoration: underline">To pre populate the shipping information page you may pass in</span>:<br />
ship_name<br />
ship_street_address<br />
ship_street_address2<br />
ship_city<br />
ship_state<br />
ship_zip<br />
ship_country</strong></p>
<p>Please note that shipping information will only be collected for items that are defined as tangible in our system. Shipping is also only charged for tangible items.</p>
<p>The billing information page will also be populated with the information from the shipping page if the shipping information is collected on that sale and the billing information is not passed in.</p>
<p><strong><span style="text-decoration: underline">Custom Parameters</span>:</strong><br />
You may pass in any additional parameters that you may need and they will be returned to you at the end of the sale. The only restrictions on custom parameters are that they can not share the name of ANY parameter that our system uses, even from the other sets. Please note that you WILL need a return script set up on the Site Management page to receive any of these parameters back as they are not included in the confirmation emails.</p>
<p><strong><span style="text-decoration: underline">You can receive back all of the parameters that were passed in as well as the following parameters</span>:</strong><br />
<strong>order_number</strong> &#8211; 2Checkout.com order number<br />
<strong>cart_order_id</strong> &#8211; Your cart ID number passed in.<br />
<strong>credit_card_processed</strong> &#8211; Y if successful (Approved).<br />
<strong>key</strong> &#8211; the MD5 hash used to verify that the sale came from one of our servers</p>
<p>Consult the documentation that came with your cart or contact the cart manufacturer for assistance with setting this up or to determine what URL you should enter on the Site Management for your cart to receive the product information.</p>
<p>Recurring billing can not be done with this parameter set. You must use the Plug-N-Play parameter set and have the products defined within the 2CO database for recurring billing.</p>
<p><strong><span style="text-decoration: underline"><em>Important</em></span><em>: </em></strong><em>You can not mix the three parameter sets. This will cause problems during payment or may prevent the payment pages from working at all.</em></p>
<p><strong>Important Note:</strong> 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. For more information on clearing the cookies please click <a href="http://www.2checkout.com/blog/knowledge-base/suppliers/tech-support/clearing-cache-and-cookies-2/">here</a>.</p>
<p><strong>Related Article:</strong> <a href="http://www.2checkout.com/blog/knowledge-base/country-codes/">Country Codes</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/does-your-system-have-its-own-parameters-if-so-what-are-they/feed/</wfw:commentRss>
		<slash:comments>25</slash:comments>
		</item>
		<item>
		<title>What are the parameters for 2CO&#8217;s Plug and Play cart?</title>
		<link>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/using-the-plug-n-play-cart/what-are-the-parameters-for-the-plug-n-play-cart/</link>
		<comments>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/using-the-plug-n-play-cart/what-are-the-parameters-for-the-plug-n-play-cart/#comments</comments>
		<pubDate>Sat, 30 Dec 2006 07:00:00 +0000</pubDate>
		<dc:creator>knowledgebase</dc:creator>
				<category><![CDATA[Parameter Sets]]></category>
		<category><![CDATA[Using the Plug n Play Cart]]></category>
		<category><![CDATA[cart]]></category>
		<category><![CDATA[parameters]]></category>
		<category><![CDATA[plug and play]]></category>

		<guid isPermaLink="false">https://192.168.2.217/fresh/blog/2006/12/30/what-are-the-parameters-for-the-plug-n-play-cart/</guid>
		<description><![CDATA[Below are the parameters supported by the Plug and Play Cart. These parameters can only be used if you have added your products to the 2CO database. You are using the Plug and Play cart if you are passing in the three parameters listed under the Required section below. If you would like to test [...]]]></description>
			<content:encoded><![CDATA[<p>Below are the parameters supported by the Plug and Play Cart. These parameters can only be used if you have added your products to the 2CO database. You are using the Plug and Play cart if you are passing in the three parameters listed under the Required section below. If you would like to test your integration of these parameters, try using our <a href="http://developers.2checkout.com/code_machine">developers.2Checkout area</a>.</p>
<p><strong><u>Multi-page Payment Routine</u>:</strong></p>
<p>https://www.2checkout.com/checkout/purchase</p>
<p><em>Supports tangible and intangible products/services.</em></p>
<p><strong><u>Single Page Payment Routine</u>:</strong></p>
<p>https://www.2checkout.com/checkout/spurchase</p>
<p><em>Only available for intangible products/services.</em></p>
<p><strong><u>Required Parameters</u>:</strong><br />
<strong>sid</strong> &#8211; Your 2Checkout account number. <em><font color="#666666">(64 characters max)</font></em><br />
<strong>product_id</strong> &#8211; The 2CO ID for the product or service in your 2Checkout account.<br />
<strong>quantity</strong> &#8211; The quantity of the product. <em><font color="#666666">(99 max value)</font></em></p>
<p><strong><u>Additional Parameters</u>:</strong><br />
<strong>demo</strong> &#8211; Y to enable demo mode, do not pass this in for live sales<br />
<strong>fixed</strong> &#8211; Y to remove the Continue Shopping button and lock the quantity fields<br />
<strong>lang</strong> &#8211; Chinese &#8211; zh, Danish &#8211; da, Dutch &#8211; nl, French &#8211; fr, German &#8211; gr, Greek &#8211; el, Italian &#8211; it, Japanese &#8211; jp, Norwegian &#8211; no, Portuguese &#8211; pt, Slovenian &#8211; sl, Spanish &#8211; es_ib, Spanish &#8211; es_la, Swedish &#8211; sv, defaults to English if this is absent, but en may be used for English as well.<br />
<strong>return_url</strong> &#8211; Used to control where the Continue Shopping button will send the customer when clicked. <em><font color="#666666">(255 characters max)</font></em><br />
<strong>merchant_order_id</strong> &#8211; Specify your order number with this parameter. It will also be included in the confirmation emails to yourself and the customer. <em><font color="#666666">(50 characters max)</font></em><br />
<strong>pay_method</strong> &#8211; CC for Credit Card, CK for check, PPI for PayPal. This will set the default selection on the payment method step during the checkout process.<br />
<strong>skip_landing</strong> &#8211; If set to 1 it will skip the order review page of the purchase routine. If there are options on the products it will cause an error and redirect the customer back to the order review page.<br />
<strong>x_Receipt_Link_URL</strong> -Used to specify an approved URL on-the-fly, but is limited to the same domain that is used for your 2Checkout account, otherwise it will fail. <font color="#666666"><em>(no limit)</em></font>:</p>
<ul>
<li>This parameter will over-ride any URL set on the Site Management page.</li>
<li>If the Return Method is set to &#8220;Given links back to my Website&#8221;: If only one product is ordered, it will over-ride the approved URLs on the product as well. If more than one product is ordered, then this parameter will control where the &#8220;Click Here to Finalize your Order&#8221; button on the final page takes the customer, but the approved URLs on the products will be listed as links below the button, next to the description of the product.</li>
<li>If Return Method is set to &#8220;Direct Return&#8221; or &#8220;Header Redirect&#8221; : If one product is ordered, this parameter will NOT over-ride the approved URLs on the products. If more than one product is ordered, then this parameter will over-ride the product approved URLs. Also keep in mind that many third party shopping carts recommend that Direct Return be set to &#8220;Given links back to me Website&#8221; to work properly.</li>
</ul>
<p><strong>coupon</strong> &#8211; Specify a 2Checkout created coupon code. If applicable, the coupon will be automatically applied to the sale.</p>
<p><strong><u>To populate the billing information page you may pass in</u>: </strong><br />
<strong>card_holder_name</strong> &#8211; Card holder&#8217;s name. <font color="#666666"><em>(128 characters max)</em></font></p>
<blockquote><p><em>The card holder&#8217;s name can also be populated using the <strong>first_name</strong>, <strong>middle_initial</strong>, and <strong>last_name</strong> parameters. <strong>IMPORTANT:</strong> If you use these three parameters, the data will be combined into and returned as <strong>card_holder_name</strong> to your Approved URL script.</em></p></blockquote>
<p><strong>street_address</strong> &#8211; Card holder&#8217;s street address <font color="#666666"><em>(64 characters max)</em></font><br />
<strong>street_address2</strong> &#8211; The second line for the street address, typically suburb or apartment number information <font color="#666666"><em>(64 characters max)</em></font><br />
<strong>city</strong> &#8211; Card holder&#8217;s city <font color="#666666"><em>(64 characters max)</em></font><br />
<strong>state</strong> &#8211; Card holder&#8217;s state <font color="#666666"><em>(64 characters max)</em></font><br />
<strong>zip</strong> &#8211; Card holder&#8217;s zip <font color="#666666"><em>(16 characters max)</em></font><br />
<strong>country</strong> &#8211; Card holder&#8217;s country <font color="#666666"><em>(64 characters max)</em></font><br />
<strong>email</strong> &#8211; Card holder&#8217;s email address <font color="#666666"><em>(64 characters max)</em></font><br />
<strong>phone</strong> &#8211; Card holder&#8217;s phone number <font color="#666666"><em>(16 characters max)</em></font><br />
<strong>phone_extension</strong> &#8211; Card holder&#8217;s phone extension <font color="#666666"><em>(9 characters max)</em></font></p>
<p><strong><u>To populate the shipping information page you may pass in</u>: </strong><br />
<strong>ship_name<br />
ship_street_address<br />
ship_street_address2<br />
ship_city<br />
ship_state<br />
ship_zip<br />
ship_country</strong></p>
<p>Please note that shipping information will only be collected for items that are defined as tangible in our system. Shipping is also only charged for tangible items. </p>
<p>The billing information page will also be populated with the information from the shipping page if the shipping information is collected on that sale and the billing information is not passed in.</p>
<p><strong><u>Custom Parameters</u>:</strong><br />
You may pass in any additional parameters that you may need and they will be returned to you at the end of the sale. The only restrictions on custom parameters are that they can not share the name of ANY parameter that our system uses, even from the other sets. Please note that you WILL need a return script set up on the Site Management page to receive any of these parameters back as they are not included in the confirmation emails.</p>
<p><strong><u>Passing Multiple Plug and Play Products:</u></strong><br />
You may also pass multiple plug and play products in one form.  To do this add a corresponding digit to the quantity and product_id parameters to group them for each product. For example, if we wanted to pass two products into the system we would be passing in first the sid parameter, then product_id1 and quantity1, and then product_id2 and quantity2.</p>
<p>Example:</p>
<pre><code>&lt;form action='https://www.2checkout.com/checkout/purchase' method='post'&gt;
&lt;input type='hidden' name='sid' value='123' &gt;
&lt;input type='hidden' name='quantity1' value='1' &gt;
&lt;input type='hidden' name='product_id1' value='1008' /&gt;
&lt;input type='hidden' name='quantity2' value='1' &gt;
&lt;input type='hidden' name='product_id2' value='1014' &gt;
&lt;input type='hidden' name='quantity3' value='1' &gt;
&lt;input type='hidden' name='product_id3' value='1011' &gt;
&lt;input name="submit" type='submit' value='Buy from 2CO' &gt;
&lt;/form&gt;
</code></pre>
<p><strong><u>You can receive back all of the parameters that were passed in as well as the following parameters</u>:</strong><br />
<strong>order_number</strong> &#8211; 2Checkout.com order number<br />
<strong>total</strong> &#8211; the total amount of the purchase<br />
<strong>ship_method</strong> &#8211; the shipping method that was selected for this order (if applicable)<br />
<strong>credit_card_processed</strong> &#8211; Y if successful (Approved).<br />
<strong>merchant_product_id</strong> &#8211; your product ID for purchased item<br />
<strong>key</strong> &#8211; the MD5 hash that can be used to verify that the sale came from one of our servers</p>
<p>Also note that this is the only parameter set that can be used for recurring billing with our service.</p>
<p><em><strong>Important:</strong> You can not mix the three parameter sets. This will cause problems during payment or may prevent the payment pages from working at all.</em></p>
<p><strong>Important Note:</strong> 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. For more information on clearing the cookies please click <a href="http://www.2checkout.com/blog/knowledge-base/suppliers/tech-support/clearing-cache-and-cookies-2/">here</a>.</p>
<p><strong>Related Article:</strong> <a href="http://www.2checkout.com/blog/knowledge-base/country-codes/">Country Codes</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/using-the-plug-n-play-cart/what-are-the-parameters-for-the-plug-n-play-cart/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>What are the New Cart Purchase Parameters?</title>
		<link>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/what-are-the-new-cart-purchase-parameters/</link>
		<comments>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/what-are-the-new-cart-purchase-parameters/#comments</comments>
		<pubDate>Sat, 30 Dec 2006 07:00:00 +0000</pubDate>
		<dc:creator>knowledgebase</dc:creator>
				<category><![CDATA[Parameter Sets]]></category>
		<category><![CDATA[cart]]></category>
		<category><![CDATA[c_prod]]></category>
		<category><![CDATA[parameters]]></category>

		<guid isPermaLink="false">https://192.168.2.217/fresh/blog/2006/12/30/what-are-the-new-cart-purchase-parameters/</guid>
		<description><![CDATA[Announcement The new cart purchase parameter descriptions have been integrated into the parameter set articles they are required for. Please review the &#8220;Product Identification parameters&#8221; section of the 3rd party cart parameter article or the Authorize.net parameter article to find information on these parameters. If you would like to test your integration of these parameters, [...]]]></description>
			<content:encoded><![CDATA[<h2>Announcement</h2>
<p>The new cart purchase parameter descriptions have been integrated into the parameter set articles they are required for.  Please review the &#8220;Product Identification parameters&#8221; section of the <a href="http://www.2checkout.com/blog/knowledge-base/suppliers/tech-support/3rd-party-carts/parameter-sets/does-your-system-have-its-own-parameters-if-so-what-are-they/">3rd party cart parameter article</a> or the <a href="http://www.2checkout.com/blog/knowledge-base/suppliers/tech-support/3rd-party-carts/parameter-sets/does-your-system-support-authorizenet-parameters-if-so-what-are-they/">Authorize.net parameter article</a> to find information on these parameters.  If you would like to test your integration of these parameters, try using our <a href="http://developers.2checkout.com/code_machine">developers.2Checkout area</a>.  The information below is provided for historical reference only.</p>
<hr />It has become necessary for 2CO to know the specific product that is being sold at the time of sale and for that product&#8217;s description to be stored in our database for reference. This change is required both by 2CO and by our banking partners to better mitigate risk and to monitor items being sold. Because of this requirement, we are asking cart makers and/or users to make changes to their cart or programs so that additional information about the items being sold is passed to 2CO.It is very important to note that:</p>
<ol>
<li>All previous parameters remain supported and should continue to be passed in (2CO, Authorize.net),</li>
<li>The parameter total (or the authorize.net parameter : x_amount) passed in for the order will continue to be the amount billed for the sale,</li>
<li>The paramaters cart_order_id and sid (or the authorize.net parameters: x_invoice_num and x_login) are still manditory with this parameter set.</li>
</ol>
<p><u>REQUIRED PARAMETERS</u><br />
These parameters are required to identify cart products being purchased and should be supplied ASAP.</p>
<p>For some clients it may make sense to create 1 or multiple generic products in the 2CO db, like &#8220;Premium Hosting&#8221;, &#8220;Super Saver Hosting&#8221; and pass in a total for the sale as generated on their site. If this option works for you please make the product name reasonably descriptive, (i.e. &#8220;website design services&#8221; would be a good description, &#8220;web services&#8221; a poor one for the same item ).</p>
<ul>
<li> c_prod or c_prod_[:digit] : This parameter will contain either the assigned_product_id given to the product upon creation in the 2CO system or a user specified id. It may, optionally, also contain the id followed by a &#8216;,&#8217; (ASCII comma) followed by an integer which will represent the quantity. This parameter should not be autogenerated with each individual sale but should be tied to a specific product. The c_prod value should match whatever external ID is recorded in the 2CO system. The external ID may be a cart assigned product id or the sellers own internal product id as long as the value matches the value stored in the 2Co system. Examples of valid values:
<ul>
<li>1</li>
<li>my_product_17</li>
<li>product_5,3</li>
</ul>
</li>
<li> id_type This parameter will contain an integer value representing the type<br />
or classification of the ids used in the c_prod parameter(s). This value will<br />
apply universally per transaction. That is to say c_prod parameters must contain<br />
only assigned_product_id values or only vendor_product_id values. Current<br />
valid values for this parameter are defined as follows.</p>
<ul>
<li>1 is defined as vendor_product_id</li>
<li>2 is defined as assigned_product_id</li>
<li>3 &#8211; 0 are reserved for future use.</li>
</ul>
</li>
</ul>
<p><u>OPTIONAL PARAMETERS</u><br />
These parameters are intended for carts that retain no product database or as a transition method of populating the 2CO database. Although it is desirable to receive as many parameters as possible with the purchase the option of creating products on the fly should only be used when no other options exist.</p>
<ul>
<li>sh_cost (optional) : This parameter will contain shipping and handling cost, if any. The sh_cost parameter is completely optional. This parameter has the same format rules as the parameter containing the total (total or x_amount) that you are currently using. This value received is assumed to be in the selected currency of your 2CO account.<br />
Examples of valid values: 0.50, 5.00, 10</li>
<li>c_name or c_name_[:digit] : This parameter is required for product information to be displayed at checkout. The value of this parameter should contain the name of the product to be created. It is limited to 128 characters including spaces and punctuation. If the value is too long it will be cut off at 128 characters.</li>
<li>c_description or c_description_[:digit] : This parameter is required for product information to be displayed at checkout. The value of this parameter should contain a short description of the product to be sold. It is limited to 255 characters including spaces and punctuation. If the value is too long this value will be stored as the long description instead. The long description will not show on the checkout pages but it will be saved in the 2Co product database.</li>
<li>c_price or c_price_[:digit] : This parameter is required for product information to be displayed at checkout. This value should reflect the price of the product in your 2CO account selected currency. This parameter has the follow format restrictions
<ul>
<li>Numbers and decimal point only.</li>
<li>Max value: 999999.99</li>
</ul>
</li>
<li>c_tangible or c_tangible_[:digit] (optional) : This parameter is optional. If you do not provide a value for it a default value of Y will be used. This field indicates if the product is a physical product or an e-good/service.<br />
This parameter has the following format restrictions: Valid values: y Y n N</li>
</ul>
<p><u>NEW PARAMETERS IN PRACTICE</u><br />
Below you will find an example form that shows how these new parameters might be implemented:</p>
<pre>
&lt;form action="https://www.2checkout.com/checkout/purchase" method="post"&gt;

	&lt;input type="hidden" name="id_type" value="1"&gt;
	&lt;input type="hidden" name="c_prod_1" value="QAWSZX0678,3"&gt;
	&lt;input type="hidden" name="c_name_1" value="Sample Product"&gt;
	&lt;input type="hidden" name="c_description_1" value="Sample Product Description"&gt;
	&lt;input type="hidden" name="c_price_1" value="5.00"&gt;
	&lt;input type="hidden" name="c_tangible_1" value="N"&gt;

	&lt;input type="hidden" name="c_prod_2" value="CABLE0029,1"&gt;
	&lt;input type="hidden" name="c_name_2" value="A Second Sample Product"&gt;
	&lt;input type="hidden" name="c_description_2" value="This Products Description"&gt;
	&lt;input type="hidden" name="c_price_2" value="10.00"&gt;
	&lt;input type="hidden" name="c_tangible_2" value="N"&gt;

	&lt;input type="hidden" name="sid" value="XXXXXX"&gt;
	&lt;input type="hidden" name="cart_order_id" value="050304-102658-3874"&gt;
	&lt;input type="hidden" name="total" value="25.00"&gt;

	&lt;input type="submit"&gt;
&lt;/form&gt;</pre>
<p>Please note that you will need to replace the sample values with your own.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.2checkout.com/blog/knowledge-base/merchants/tech-support/3rd-party-carts/parameter-sets/what-are-the-new-cart-purchase-parameters/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
	</channel>
</rss>

