2Checkout Documentation

Return Setup

Approved URL

After the successful completion of a sale can return the
buyer and sale parameters to a script or page on your site. Specifying an
approved URL at the account level will direct all buyers to the same URL
after a successful checkout. This URL can be entered on the Site Management
page by clicking the Account tab followed by the Site Management sub-category.

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
buyer to a specific location for that product, such as a download page. If
multiple products are ordered the buyer is provided with multiple approved
URLs allowing them to access each product in the sale. Please Note: If
multiple product level approved URLs are used, the buyer will always land on the Order
Processed page with a “Download/Customize” button for each product ordered and
the sale parameters will be returned by GET.

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. This parameter has a few very specific behaviors
that should be paid attention so that it can be used effectively.


  • This parameter will over-ride any approved URL set within your account.
  • If your return method is set to Given links back to my Site — This parameter will control where the Click Here to Finalize your Order button takes the buyer after the successful sale. If there are product-specific approved URLs, it will over-ride the individual product approved URL and no “Download/Customize” button will be displayed for the product.
  • If your return method is set to Direct Return or Header Redirect, this parameter will control where the buyer gets directed to automatically after the successful sale.

Return Method provides three methods in which the buyer and sale parameters
can be returned to your approved URL. You may send the buyer to our order
processed page which will display a Click Here to Finalize your Order button to redirect the
buyer, you may bypass the order processed page using a header redirect or
you can immediately display your approved URL to the buyer while they
remain on our server. Your return method can be selected on the Site
Management page.

Given links back to my Website

With the Return Method set to Given links back to my website, the buyer
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 buyer and collected sale parameters will be directed to the provided
approved URL by POST.

Direct Return

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 buyer. When using this Direct Return function the URL will be masked to
the buyer, appearing to still be on the 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 buyer 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 buyer 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.

Header Redirect

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

Additional Information

If you are returning the buyer 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 the approved URL is
defined at the product level. 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 your return URL ends in any of the
following extensions, then pass back will NOT occur, but the buyer will
still be returned there : .htm, .html, .com, .zip, .pdf, .rar, .doc

If you have problems with the return process you’re welcome to contact us at 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 buyer will
remain on the 2Checkout Order Processed page upon completion of the order.