Additionally, you can make use of our developers.2Checkout area to test out your own return script with sample return data. This can assist you when building your 2Checkout return script.

<?php //display all post and get parameters

	echo "<h1>Get Parameter/s:</h1>";
	echo "<pre>";
	if($_GET)
		print_r($_GET);
	else
		echo "There are no get parameters.";
	echo "</pre>";
	echo "<hr/>";
	echo "<h1>Post Parameter/s:</h1>";
	echo "<pre>";
	if($_POST)
		print_r($_POST);
	else
		echo "There are no post parameters.";
	echo "</pre>";

?>

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 set up is correct:

1. Create a new text file using a text editor such as Windows Notepad.
2. Paste the following code into this new file:
   <form method=”POST” action=”[full URL to Your Script Here]“>
   <input type=”hidden” name=”test” value=”1″>
   <input type=”submit” value=”Test Script”> </form>
3. Replace “[full URL to Your Script Here]” with the URL of the script you are attempting to pass back to. Remember that this should be the full URL of your script, including the http:// portion.
4. Save the file as an HTML file, such as “test.html” or “test.htm” to your desktop and close your text editor.
5. Open the file in your web browser and click the “Test Script” button that is displayed.
6. 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 servers configuration. If you see something about “method not allowed” or “error 405″ then the information above pertains to your situation.

Specifying an approved URL at the account level will direct all customers to the same URL after a successful checkout. An approved URL can also be set at the product level by providing an approved URL when creating the product, or by clicking the blue Edit icon under the Actions column for the product on the Products page in your account. Product level approved URLs override the account level approved URL and can direct the customer to a specific location for that product, such as a download page. If multiple products are ordered the customer is provided with multiple approved URLs allowing them to access each product in the sale.

You may also choose to pass the approved URL on the fly by using the x_receipt_link_url parameter. This parameter will override both product and account level approved URLs. The value passed must match the domain registered to the account.

If you are returning the customer to a script on your end it is important to note that parameter information will typically be returned by POST. Parameters however will be returned by GET if either the Header Redirect method is selected or the Plug-and-Play parameter set is used and multiple products are purchased at the same time. Thus if you are using a product level approved URL your return script should be able to handle both methods without breaking. Please Note: You must also have a script set up as the return URL if you wish to receive the pass back information. If you would like this information returned to you, make sure that your return URL ends in the extension of a script. If your return URL ends in any of the following extensions, then pass back will NOT occur, but the customer will still be returned there : .htm, .html, .com, .zip, .pdf, .rar, .doc

Finally, you will determine the method in which your customer is returned to the approved URL. 2Checkout.com provides three methods. You may send the customer to our order processed page which will display a Click here to finalize your order button to redirect the customer, you may bypass the order processed page using a header redirect or you can immediately display your approved URL to the customer while they remain on our server. Your return method can be selected on the Site Management page.

With the Return Method set to Given links back to my website, the customer will be taken to our Order Processed page after completing a successful purchase. This page will feature a Click Here to Finalize Your Order button. When clicked the customer and collected sale parameters will be directed to the provided approved URL.

With the Return Method set to Direct Return, sale parameters will be posted automatically to the approved URL while fetched by our server and displayed to the customer. When using this Direct Return function the URL will be masked to the customer, appearing to still be on the 2Checkout.com domain. This method can be used with redirects as long as each page outputs content more than 255 characters to the browser. If Direct Return encounters a page that redirects without outputting content the process will fail and the customer will be sent to our standard Order Processed page. This occurs usually with a header redirect, specifically content less then 255 characters. This is a common issue as many developers will set their approved URL to a script that processes the return sales parameters then silently forwards the customer to another page. This is usually a thank you or download page for intangible products. The best solution is to handle all post-order processing on the page set as your approved URL, including the thank you message. If no redirects are used, meaning the URL is masked by our servers, then relative links will not point to the correct location. This can be corrected with the use of absolute paths on the approved URL page or by simply using a base tag in the head of the document to provide a reference for the relative paths.

With the Return Method set to Header Redirect the customer will be immediately returned to your approved URL. Using this method, the sale parameters will be returned along with the customer using the GET method.

If you have problems with the return process you’re welcome to contact us at techsupport@2co.com to assist with troubleshooting the issue. Please Note: If you do not specify an approved URL at the account level, product level, or with the x_receipt_link_url parameter the customer will remain on the 2Checkout Order Processed page upon completion of the order.

1. Click on the ‘Account’ tab.
2. Click on the ‘Site Management’ sub category.
3. Input the URL into the Approved and Pending URL boxes on this page.
4. Click ‘Save Changes’.

If you our using our free Plug and Play shopping cart, then you may specify an Approved and Pending URL on each product individually. You should see the options for these URLs while creating a product, but to add them to existing products, click Edit next to the product you wish to add them on. Any return URLs set on the product itself will over-ride the ones that you set on the Look and Feel page.

The Approved and Pending URLs may be the same URLs if you wish, but they can also be separate URLs. We will send the customer to the Approved or Pending URL depending on what the value of the credit_card_processed parameter is. It is only either Y or K. We will set the value of this to Y if we can immediately verify the availability of funds after the sale and then send the customer to your return Approved URL. We will set it to K and return them to the Pending URL if we can not immediately verify the availability of funds, such as if the customer paid by digital check. If you put the URL to the same script in both boxes, then the script should check the value of this parameter to determine the needed course of action.

The URL you enter here must have the extension of a script. If a static HTML file is used, such as an .htm or .html file, we will still send the customer back to that page. However, we will not pass back any details of the sale with them unless it is a script. If your return URL ends in any of the following extensions, then pass back will NOT occur, but the customer will still be returned there : .htm, .html, .com, .zip, .pdf, .rar, .doc