2Checkout.com » approved url

Using the 1ShoppingCart System

joel — Thu, 10 Apr 2008 17:39:49 +0000

If you are a 2Checkout supplier using the 1ShoppingCart system, we wish to remind you that they have been upgrading their customers’ accounts. As part of this upgrade any customers using 2Checkout will need to change their approved URL from https://www.mcssl.com/app/postauthorizeb.asp to https://www.mcssl.com/SecureCart/Authorize.aspx, after their account has been upgraded.

Suppliers can confirm which URL they should be using by logging into their 1ShoppingCart account and going to their Gateway Setup page which is located on the Setup menu. By clicking on the “More Details” link next to their gateway ID they will be able to access the instructions which contain the correct URL. Those that have not yet been upgraded will see https://www.mcssl.com/app/postauthorizeb.asp and those that have been upgraded will see https://www.mcssl.com/SecureCart/Authorize.aspx

We’d like to thank 1ShoppingCart for the information.

Why Are the Images/Links on my Approved URL Broken?

knowledgebase — Fri, 04 May 2007 14:34:57 +0000

When Direct Return is enabled (set to ‘Yes’), your Approved URL page will be fetched and displayed to the customer while they remain on 2Checkout’s server. Because of this, images and links that use relative paths will not resolve correctly, resulting in broken images and incorrect link destinations.

To fix this, you will need to specify a base URI for your Approved URL. This can be accomplished by inserting the following line between the tag of your page:

The URL specified after ‘href=’ should be changed to your Approved URL.

Can I specify the return URL ‘on the fly’?

knowledgebase — Sat, 30 Dec 2006 07:00:00 +0000

Yes, this is possible. You may pass in a parameter called x_receipt_link_url to control where the customer is returned to on a per-sale basis. Keep in mind that this parameter will over-ride any return URL set on the Look and Feel page of your account, but it will not over-ride any return URLs that are set up on the product itself if there are any. Using this method, you could create a special button or link that would return the customer to a different page on your site than is set up on the Look and Feel page. This is useful for ‘promotional’ type sites as you can avoid having to make any configuration changes to your actual account.

If you are using buttons on your site to sell your goods through 2Checkout, you would add a single line to the button such as this:

This must go between the opening and closing FORM tag that you see when you view your existing code.

If you are using links to sell your goods through 2Checkout, then you would add this parameter to your links to specify the return url, such as this:

&x_receipt_link_url=http://www.your-site.com/return.php

Notice that in both of the above examples, the FULL path is used for the value of this.

Important Note: For security reasons, the domain on your account and the domain that hosts the pass back page must match exactly for this to work correctly. For example, if you have http://www.your-site.com specified on your account, you could pass back to http://www.your-site.com/pages/pass.php but not to http://www.your-other-site.com/pages/pass.php.

Why do I get an HTTP Error 404 (File Not Found) on Passback?

knowledgebase — Sat, 30 Dec 2006 07:00:00 +0000

An HTTP 404 File Not Found error indicates that the URL specified as for your script is incorrect. For the pass back to function, 2CO must be able to locate and 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 correct this issue, follow these steps:

Login to your account.
Under the ‘Helpful Links’ section, click on ‘Settings’ near the ‘Look and
Feel’ section.
Check the URL that is currently entered there and correct any mistakes that
it may contain.
Click ‘Save Changes’.

Can I have more than one passback URL?

knowledgebase — Sat, 30 Dec 2006 07:00:00 +0000

It is possible to use multiple pass back URLs, or return URLs, with our system. If you are using our free Plug and Play shopping cart, then you simply need to add the URLs to the products themselves to achieve this. You may specify the Approved and Pending* URLs on each individual product that you have created in our system. These URLs will over-ride any URL set on the Site Managment page. We will then use this URL to return the customer to when it is purchased.

Having multiple return URLs can conflict with the Direct Return feature that we have available. This feature will make the customer skip the ‘Sale Processed’ and go directly from the Billing Information page of the checkout process to your return URL. We can only return the customer to one page at a time, so when multiple products are purchased that have different return URLs, the Direct Return feature is disabled for that sale. The customer will then be presented with a list of the products or services they purchased along with their respective return URLs to click. There is a parameter available to lock our cart into only allowing the purchase of one product at a time, and this parameters name is ‘fixed’. You may pass this in with the value of a capital ‘Y’ to lock the quantity fields. More information on Direct Return and the parameters that we accept can be found elsewhere in the Knowledge Base. Please do a search for ‘Direct Return’ or ‘parameters’ if you would like to read this information.

If you are using a third party or customer cart or script, then multiple return URLs may still be used, but the implementation of this would have to be on your end as the product information in the 2CO database is not used. If you are not passing in product_id parameters, then you are not using the Plug and Play cart of ours. To achieve multiple return URLs with a customer cart or third party cart, you may use the x_receipt_link_url parameter to control where the customer is returned to. The value of this parameter MUST match the domain that is listed on your 2Checkout.com account for security reasons. You would then need to design your cart or script to pass this parameter into our system along with the appropriate value for that sale.

*The Pending URL field is no longer used and may be left blank as 2Checkout no longer accepts e-checks as a payment method.

How Does The Return Process Work?

knowledgebase — Sat, 30 Dec 2006 07:00:00 +0000

After a sale, we can return the customer to a script or page on your site that you specify as the return URL. This can be done on the Look and Feel settings page of the Classic Sellers Area. This is located in the Helpful Links section of your account homepage. In the new Vendors Administration Area this information may be entered by first clicking the Account tab on your account homepage and then clicking the Site Management sub tab on your account page.

2Checkout can return the customer to an Approved or Pending URL after a sale. If we can immediately verify the availability of funds, then the customer is sent to the Approved URL. If we are not able to do this, then they will go to the Pending URL. For example, a digital check would always be sent to the Pending URL because we can not immediately verify the availability of funds. A confirmation email is sent out when the check clears, but no pass back ever occurs after the initial sale. Another way of saying this is that if the credit_card_processed parameter is “Y”, then the customer goes to the Approved URL, but if it is “K” then they will go to the Pending URL.

You may also specify the Approved and Pending URL on the product level in the Classic Sellers Area as well as the new Vendors Administration Area. Any URL set here over-rides the main ones set on the Look and Feel settings page.

The terms pass back URL and return URL generally mean the same thing and can be used interchangeably. However, pass back refers to the information or parameters that we send back to your site after a sale. Return refers to the actual process of sending the customer there. Pass back URL and return URL are the same because in this context it simply means “where do you want return/pass back to go to?”

Additionally, the x_receipt_link_url parameter can be used to specify the return URL on the fly. If you take this approach, this parameter will over-ride any URL set on the Look and Feel settings page. You may use this parameter to have a specific button or link use a return URL that is different than the ones set on the Look and Feel page. If you do this, your return script would need to check the value of the credit_card_processed parameter itself to determine what the appropriate course of action should be. Another way of saying this is that, since this parameter only allows you to specify one return URL rather than both the Approved and Pending URLs, whatever script it is returning the customer to will need to check the value of the credit_card_processed parameter to determine whether they should provide the customer with a “Thank You for Ordering! / Here is Your Download!” page, or a “You will receive more information when your payment is approved” screen.

It is also important to note that if x_receipt_link_url is used, then the return page must match the domain on the account. If the URL is saved on the Look and Feel page or the product level, then we can return them anywhere. In short, if the URL is in our database we can return them there. If not, then it must match for security reasons.

2Checkout.com will also POST the information to your return URL in all cases, regardless of whether Direct Return is enabled or disabled. It is important to note that we will not allow a mix of GET and POST in the return process. If you are trying to return the customer to “http://www.yoursite.com/your_script.php?param=value” then we actually return the customer to “http://www.yoursite.com/your_script.php” and the ‘param=value’ will be returned as POST information with the rest of the sales information that we normally pass back.

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

The order of precedence for return from highest to lowest is:

x_receipt_link_url

Product Level

Look and Feel page

The x_receipt_link_url will take precedence over all other return URLs, and the Look and Feel page will be used by default if the other two are absent.

Where do I input the URL of the script on my site I want you to pass back to?

knowledgebase — Sat, 30 Dec 2006 07:00:00 +0000

To specify a URL for our system to pass back to, please follow these steps:

Click on the ‘Account’ tab.

Click on the ‘Site Management’ sub category.

Input the URL into the Approved and Pending URL boxes on this page.

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

Why when I changed the Return Url on the Return Page but after the purchase the buyer still returns to the old link?

knowledgebase — Sat, 30 Dec 2006 07:00:00 +0000

In the Admin under Products – Existing Products and then click Edit for your products. You will see that each product has its own return url, if you put a url in there, it will over ride the one on the Site Managment page of the Admin.

How do I mask the Return URL for the Plug N Play Cart?

knowledgebase — Sat, 30 Dec 2006 07:00:00 +0000

1) The Return URL can be masked in live or demo mode, assuming it is turned on. To do this, the Direct Return Feature needs to be turned on, as well as the Return URL for your routine. The Direct Return can be found on the Site Managment page towards the bottom of the page under overall passback.

2) The Return page and the product listing page space to put a return link is one in the same. If you add it to one, it will also be on the other. That is just a second place to add the link. In order for the return to work, you need to put the correct return link to “YES”, as well as the Direct Return to “YES” for masked URL.

When you add your products to the Admin, you also have an option to put a return URL for each product. This will override the one on the Return page, so you can have a different return URL per product. Any product that does not have a return URL will be returned to the page on the return page.

Why when you click the confirmation button, instead of redirecting to the return URL, it redirects to a different page than I set up in the Return page?

knowledgebase — Sat, 30 Dec 2006 07:00:00 +0000

Please make sure that the return link you set up for each product you added to our database either has NO return URL, or that it has the url you want the buyer to be passed back to assigned to it. If the one with the product is different, then it will override the one you set up in the Return page.

If all customers will be redirected to the same url, you may want to only provide the url in the Site Management page rather than at the product level.