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 developers.2Checkout area.

Multi-page Payment Routine:
https://www.2checkout.com/checkout/purchase
Supports all payment methods. Supports tangible and intangible products/services.

Single Page Payment Routine:
https://www.2checkout.com/checkout/spurchase
Credit card-only payment routine only available for intangible products/services.

Required Parameters:
x_login – Your numerical 2checkout vendor account number.
x_amount – The total amount to be billed, without a currency symbol, and only two decimal places if used (8 characters, decimal, 2 characters: Example: 99999999.99)
x_invoice_num – A unique order id from your system. (64 characters max)

Product Identification Parameters:
Suppliers using this parameter set must pass in parameters to identify what is being sold during the purchase. These parameters will also benefit suppliers as when used correctly the product information will be displayed to customers on the purchase pages and will be listed on the suppliers 2Checkout.com sale detail page.

id_type – 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.
c_prod – 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.
c_name – The value of this parameter should contain the name of the product to be created. (128 characters max)
c_description – The value of this parameter should contain a short description of the product to be sold. (255 characters max)
c_price – 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. (8 characters, decimal, 2 characters: Example: 99999999.99)

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.

Additional Parameters:
demo – Y to enable demo mode. Do not pass this in for live sales. Can also be controlled within the account.
lang – Chinese – zh, Danish – da, Dutch – nl, French – fr, German – gr, Greek – el, Italian – it, Japanese – jp, Norwegian – no, Portuguese – pt, Slovenian – sl, Spanish – es_ib, Spanish – es_la, Swedish – sv, defaults to English if this is absent, but en may be used for English as well.
merchant_order_id – Specify your order number with this parameter. It will also be included in the confirmation emails to yourself and the customer. (50 characters max)
pay_method – CC for Credit Card, CK for check, AL for Acculynk PIN-debit, PPI for PayPal, or PPL for PayPal Pay Later. This will set the default selection on the payment method step during the checkout process.
skip_landing – If set to 1 it will skip the order review page of the purchase routine.
x_Receipt_Link_URL – 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 Look and Feel page. (no limit)

To populate the billing information page you may pass in:
x_First_Name – buyers first name (64 characters max)
x_Last_Name – buyers last name (64 characters max)
x_Phone – buyers phone number (16 characters max)
x_Email - buyers email address (64 characters max)
x_Address – buyers address (64 characters max)
x_City – buyers city (64 characters max)
x_State – buyers state (64 characters max)
x_Zip – buyers zip code (16 characters max)
x_Country – buyers country (64 characters max)

To populate the shipping information page you may pass in:
x_Ship_To_First_Name
x_Ship_To_Last_Name
x_Ship_To_Address
x_Ship_To_City
x_Ship_To_Country
x_Ship_To_State
x_Ship_To_Zip

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.

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.

Custom Parameters:
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 Look and Feel page to receive any of these parameters back as they are not included in the confirmation emails.

Return Parameters:
You can receive back all of the parameters that were passed in as well as the following parameters:
x_2checked – Y if card was successfully processed.
x_MD5_Hash – The MD5 hash that can be used to verify that the sale came from a 2CO server.
x_trans_id – the 2CO order number for the order.

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 Look and Feel page for the cart to correctly determine this.

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 Look and Feel page for your cart to receive the product information.

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.

Important: You can not mix the three parameter sets. This will cause problems during payment or may prevent the payment pages from working at all.

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. For more information on clearing the cookies please click here.

Related Article: Country Codes

An HTTP Error 500 (Internal Server Error) indicates that there is a problem inside of your script or the servers configuration. This error is most likely caused by a typo in the code or an invalid or illegal use of a function within the script. For the pass back to function correctly, then your script must be correctly set up.

HTTP errors are not generated specifically by 2Checkout. They are a part of the HTTP protocol and are common amongst all web servers. It is therefore beyond the realm of 2Checkout’s support to provide you with specific instructions for making these changes as every server is set up differently and 2CO does not provide server administration services as part of our support plan.

For assistance with debugging your scripts, we suggest that you contact your server’s administrator, webmaster, or hosting provider’s technical support staff. Due to the nature of this particular error, you may also be able to receive assistance from other suppliers of ours. The 500 error message is often due to a coding error in the script, so some of our other suppliers in our tech support forum may be able to help you find the mistake.

We have observed that this error is experienced in certain web browsers more than in others, in particular within Internet Explorer. If your return page or script does not output at least 530 characters, this can potentially cause a MIME header error. Mozilla based browsers such as Firefox seem to be able to handle these pages and will display either the real error or the small output when Internet Explorer has problems. Since this issue is an issue with the browser software itself, there is little 2Checkout can do to control this. If you are receiving this error, please try to increase the output that your return page generates to more than 530 characters or try a different web browser to see if you observe different results. Note that this is not a solution for all HTTP 500 error messages, but it is meant to be a useful step in debugging your script and has been reported as a successful step by some of our other suppliers.

An HTTP 403 Forbidden error indicates that due the set up of your script and/or server, the viewer does not have permission to view this page. For the pass back to function, 2CO must be able to access the script and post the variables to it.

HTTP errors are not generated specifically by 2Checkout. They are a part of the HTTP protocol and are common amongst all web servers. It is therefore beyond the realm of 2Checkouts support to provide you with specific instructions for making these changes as every server is set up differently and 2CO does not provide server administration services as part of our support plan.

To test and see if your file is working correctly:

1. Open your web browser.
2. Type in the full URL to your script or return page (including the http://www. part) and press enter.
3. If you receive the message again, the problem is in your script and/or on your server. Note that the exact wording of the error message may vary slightly depending on your browser and your server. But if you see something about ‘forbidden’ or ‘error 403′ then the information above pertains to your situation.

If you are going to use a picture of a credit card or a credit card company logo on your web site, it must be clearly and immediately adjacent to the phrase “2Checkout.com is an authorized retailer for (your business name.)” Per Credit Card Association Rules, unless your company has a direct business relationship with the credit card company and is authorized to display the credit card or the logo, the image must be removed from your web site.

Credit card association rules state that only a merchant account holder may display credit card logos on their websites. 2CO does not provide you with a merchant account. You can continue to display these logos, as long as immediately above, beside, or below the logos, there is a clear statement that 2CO is your authorized retailer.

Alternatively, you can display the logos shown here. Right click on the image of your choice below and choose “Save Picture as…” to save as a file on your computer.

Please also see 2CO Certified for “2CO Certified Seller” buttons.

Creating Product Options

To create or edit the product options themselves, go to your products list. On your products list page, you will see an ‘Edit Product Options’ link. Clicking it will link you to the ‘edit product options’ page.

Once you find your way to the ‘edit product options’ page, you will see a list of all your product options. This list contains data fields and existing option names, option values, and any surcharges associated with them. It also has the ability for deleting options. To create new product options, fill in the set of data fields near the top of the page. Choose a name for the new option, as well as any values and surcharges.

• Option Name: The name of the option you create. Once you create it, it will appear in your product options list as a link.
• Option Values: These are the values assigned to the option name you create. They are the actual choices offered for the given option. For instance, if you have ‘Size’ as an option, the values might be ‘Small’, ‘Medium’, and ‘Large’.
• Value Surcharge: This is the additional cost you may charge customers to choose a certain option. Surcharges may be specified in whole numbers (5) or as decimals to two places (5.00, 4.99, etc.). You do not have to add surcharges.

For example, you own a clothing business and sell a variety of apparel. The clothing you sell is not made with just one type of material. All the apparel you sell is made with one of three choices: cotton, wool, or silk. You want your customers to be able to choose what material they want their clothes to be fashioned from. You will create a product option to do this. As the option name, you choose ‘Material’ and enter it into the correct field. As for option values, you would set three: cotton, wool, and silk. You decide to add a surcharge for wool and silk, as the base price advertised on your site is for cotton, and we know that wool and silk are more expensive. So, in the corresponding surcharge fields, you enter the appropriate amounts. For cotton, you would enter 0.00 to specify no surcharge. You decide to charge an extra $10.00 for wool. Enter 10.00 to do so. As for silk, well that is expensive, so you decide to charge an additional $25.00 for that. 25.00 should be entered to accomplish this. When you are finished, click on ‘Save Changes’ to save your options. This will effectively add an option called ‘Material’ to your product options list.

The example used here is precisely that, and the values and surcharges displayed are totally arbitrary. The actual number and types of options and values are unlimited. If, instead of material, you want to offer different sizes or colors, so be it. This system allows you to create
product options as unique as you want, and as you see fit.

Editing Existing Product Options

To edit existing product options, click on the name of the one you wish to edit. It will appear in your list as a link. It will lead you to a page with another set of data fields and delete options. Most of the fields will have previously saved data, but two will be empty. To edit an existing value, simply click in the correct field and change it to what you want. To change the name of the option, click that field and enter what you want. To delete a value, check the box next to the relative values. To add a new set of values, enter the suitable option value and surcharge. When you are totally finished adding, editing, or deleting, click on the ‘Save Changes’ button.

Removing Product Options

To delete a product option on the ‘edit product option’ page, check the delete option box next to the corresponding product option. Check any and all options you wish to delete. To finalize your actions, click ‘Save Changes’.

If you created your products using the Product Upload method, you may create product options for them, as well. You must create your product options for each product using the explanation above in this section. Product options are NOT created in the CVS Template.

Associating Product Options With Your Products

To associate or dissociate product options, you must do this from the ‘edit product’ page. This page is found by going to your products list and clicking on an ‘Edit’ link. The ‘Edit’ link you click should be that of whichever product you want to add options to. At the bottom of the ‘edit product’ page, you will see a list of all available options you created. This list appears in the form of a table, with labeled headings. There are four headings:

1. ‘Available’: The options associated (available) with the particular product you are editing will have a check in the box under the ‘Available’ heading. If the box is not checked, that set of options is not available for (associated with) that product. Warning Product Option Association To associate or dissociate a set of options, simply check or uncheck the corresponding
box, as needed.
2. ‘Option’: This denotes the name of the product option.
3. ‘Values’: This displays the values for each option.
4. ‘Surcharge’: This displays the extra charges you may charge to customers for choosing a given product option.

When finished, click the ‘Save Changes’ button at the bottom of the page. This will save your changes.