2Checkout.com » Passbacks and Returns

New Header Redirect Return Method

2checkout — Mon, 07 Jun 2010 16:48:22 +0000

The ability to return the customer and sale parameters to a predefined URL has always been an important feature for suppliers and cart developers. We have always offered 2 ways to accomplish this by either relying on the customer to click a submit button on our Order Confirmation page or by using our Direct Return feature to immediately display the approved URL to the customer while they remain on our server. By popular demand, we are happy to announce a new Header Redirect return method that will automatically return the customer and sale parameters using the GET method.

To try out this new return method, please login to your account and access the Site Management page by clicking the Account tab and then selecting the Site Management subtab. From here you may use the Return Method selection to select Header Redirect and then click the Save Changes button.

If you have any questions or concerns about the return process, please feel free to contact us directly or reference the related articles below.

Related Article

How Does The Return Process Work?

Country Codes

knowledgebase — Wed, 18 Jul 2007 16:25:42 +0000

Below are all the available countries to bill and ship to through 2Checkout and their relative country codes, listed in alphabetical order by country name. When using either our Plug and Play or Third Party Cart parameter sets, these codes should be passed in using the country and ship_country parameters. When using our Authorize.net parameter set these codes should be passed in using the x_Country and x_Ship_To_Country parameters.

This listing reflects the changes made in the new version of our purchase routine effective as of July 17, 2007.

AFG – Afghanistan
ALB – Albania
DZA – Algeria
ASM – American Samoa
AND – Andorra
AGO – Angola
AIA – Anguilla
ATA – Antarctica
ATG – Antigua and Barbuda
ARG – Argentina
ARM – Armenia
ABW – Aruba
AUS – Australia
AUT – Austria
AZE – Azerbaijan
BHS – Bahamas
BHR – Bahrain
BGD – Bangladesh
BRB – Barbados
BLR – Belarus
BEL – Belgium
BLZ – Belize
BEN – Benin
BMU – Bermuda
BTN – Bhutan
BOL – Bolivia
BIH – Bosnia and Herzegovina
BWA – Botswana
BVT – Bouvet Island
BRA – Brazil
IOT – British Indian Ocean Territory
BRN – Brunei Darussalam
BGR – Bulgaria
BFA – Burkina Faso
BDI – Burundi
KHM – Cambodia
CMR – Cameroon
CAN – Canada
CPV – Cape Verde
CYM – Cayman Islands
CAF – Central African Republic
TCD – Chad
CHL – Chile
CHN – China
CXR – Christmas Island
CCK – Cocos (Keeling) Islands
COL – Colombia
COM – Comoros
COG – Congo
COD – Congo, the Democratic Republic of the
COK – Cook Islands
CRI – Costa Rica
CIV – Cote D’ivoire
HRV – Croatia (Hrvatska)
CYP – Cyprus
CZE – Czech Republic
DNK – Denmark
DJI – Djibouti
DMA – Dominica
DOM – Dominican Republic
ECU – Ecuador
EGY – Egypt
SLV – El Salvador
GNQ – Equatorial Guinea
ERI – Eritrea
EST – Estonia
ETH – Ethiopia
FLK – Falkland Islands (Malvinas)
FRO – Faroe Islands
FJI – Fiji
FIN – Finland
FRA – France
FXX – France, Metropolitan
GUF – French Guiana
PYF – French Polynesia
ATF – French Southern Territories
GAB – Gabon
GMB – Gambia
GEO – Georgia
DEU – Germany
GHA – Ghana
GIB – Gibraltar
GRC – Greece
GRL – Greenland
GRD – Grenada
GLP – Guadeloupe
GUM – Guam
GTM – Guatemala
GIN – Guinea
GNB – Guinea-Bissau
GUY – Guyana
HTI – Haiti
HMD – Heard Island and Mcdonald Islands
HND – Honduras
HKG – Hong Kong
HUN – Hungary
ISL – Iceland
IND – India
IDN – Indonesia
IRQ – Iraq
IRL – Ireland
ISR – Israel
ITA – Italy
JAM – Jamaica
JPN – Japan
JOR – Jordan
KAZ – Kazakhstan
KEN – Kenya
KIR – Kiribati
KOR – Korea, Republic of
KWT – Kuwait
KGZ – Kyrgyzstan
LAO – Lao People’s Democratic Republic
LVA – Latvia
LBN – Lebanon
LSO – Lesotho
LBR – Liberia
LBY – Libyan Arab Jamahiriya
LIE – Liechtenstein
LTU – Lithuania
LUX – Luxembourg
MAC – Macao
MKD – Macedonia, the Former Yugoslav Republic of
MDG – Madagascar
MWI – Malawi
MYS – Malaysia
MDV – Maldives
MLI – Mali
MLT – Malta
MHL – Marshall Islands
MTQ – Martinique
MRT – Mauritania
MUS – Mauritius
MYT – Mayotte
MEX – Mexico
FSM – Micronesia, Federated States of
MDA – Moldova, Republic of
MCO – Monaco
MNG – Mongolia
MNE – Montenegro
MSR – Montserrat
MAR – Morocco
MOZ – Mozambique
NAM – Namibia
NRU – Nauru
NPL – Nepal
NLD – Netherlands
ANT – Netherlands Antilles
NCL – New Caledonia
NZL – New Zealand
NIC – Nicaragua
NER – Niger
NGA – Nigeria
NIU – Niue
NFK – Norfolk Island
MNP – Northern Mariana Islands
NOR – Norway
OMN – Oman
PAK – Pakistan
PLW – Palau
PSE – Palestinian Territory, Occupied
PAN – Panama
PNG – Papua New Guinea
PRY – Paraguay
PER – Peru
PHL – Philippines
PCN – Pitcairn
POL – Poland
PRT – Portugal
PRI – Puerto Rico
QAT – Qatar
REU – Reunion
ROU – Romania
RUS – Russian Federation
RWA – Rwanda
SHN – Saint Helena
KNA – Saint Kitts and Nevis
LCA – Saint Lucia
SPM – Saint Pierre and Miquelon
VCT – Saint Vincent and the Grenadines
WSM – Samoa
SMR – San Marino
STP – Sao Tome and Principe
SAU – Saudi Arabia
SEN – Senegal
SRB – Serbia
SCG – Serbia and Montenegro
SYC – Seychelles
SLE – Sierra Leone
SGP – Singapore
SVK – Slovakia
SVN – Slovenia
SLB – Solomon Islands
SOM – Somalia
ZAF – South Africa
SGS – South Georgia and the South Sandwich Islands
ESP – Spain
LKA – Sri Lanka
SUR – Suriname
SJM – Svalbard and Jan Mayen Islands
SWZ – Swaziland
SWE – Sweden
CHE – Switzerland
TWN – Taiwan
TJK – Tajikistan
TZA – Tanzania, United Republic of
THA – Thailand
TLS – Timor-Leste
TGO – Togo
TKL – Tokelau
TON – Tonga
TTO – Trinidad and Tobago
TUN – Tunisia
TUR – Turkey
TKM – Turkmenistan
TCA – Turks and Caicos Islands
TUV – Tuvalu
UGA – Uganda
UKR – Ukraine
ARE – United Arab Emirates
GBR – United Kingdom
USA – United States
UMI – United States Minor Outlying Islands
URY – Uruguay
UZB – Uzbekistan
VUT – Vanuatu
VAT – Vatican City State (Holy See)
VEN – Venezuela
VNM – Viet Nam
VGB – Virgin Islands, British
VIR – Virgin Islands, U.S.
WLF – Wallis and Futuna Islands
ESH – Western Sahara
YEM – Yemen
YUG – Yugoslavia
ZAR – Zaire
ZMB – Zambia
ZWE – Zimbabwe

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

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

When the Return Method is set to “Direct Return”, 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.

How does a direct return work?

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

The direct return works through a spider on 2Checkout.com that does an HTML GET from our server with all the variables to the seller’s server. The spider prints to the screen whatever the seller’s server returns for the buyer to see.

How do single and multiple product downloads work with Direct Return?

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

ORDERING A SINGLE PRODUCT VS. ORDERING MULTIPLE PRODUCTS WITH DIRECT RETURN:

The order process works in the following manner when the Return Method is set to “Given links back to my website“.

If no approved URL has been specified in your account, the customer’s order will end at the 2Checkout order confirmation page. You are then responsible for supplying the customer with the product.
If a single product is ordered, the return method will return the customer to your specified approved URL. This is only true if you have specified an approved URL at the product section or the Site Management page in your account. The approved URL’s at the product level will always override the URL’s set up on the Site Management page in your account. 2A. If multiple products are ordered, the return method will work exactly the same as if a customer orders a single product. This is only true if you have specified the approved URL only on Site Management page in your account.
If the customer orders a single product and you have specified the approved URL at the product level, the customer will be returned to the URL indicated at the product level. 3A. If multiple products are ordered and you have set up approved URLs at the product level, the order process ends at the 2Checkout order confirmation page. At this page, there will be a “Click here to access your product” link for each product that will direct the customer to the approved URL for that product. Since the customer ordered multiple products, this page will not close until it is manually closed by the customer. This way the customer will receive all the downloads or will be forwarded to all the correct URLs to receive their downloads.

**Useful Info

To add an approved URL to the Site Management page in your account, you can click on Account tab and then select the Site Management subtab.

To add a approved URL to each of your products, you will need to click the Products tab. You will then need to click on the “edit” link for the product you need to add the approved URL to. There will be a field to input your approved URL. Simply add your approved URL and click on the Save Changes button.

Related Articles

Can I pass back parameters?

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

The sale parameters are returned to your return URL (approved URL) at the end of each sale. If you are updating your database with this information the return URL must use a script that processes the returned sale parameters. The parameters returned depend on the parameter set being used to start the sale. You will receive back the parameters listed in the articles below for the parameter set that you choose to use. In addition, there are some parameter names at the bottom of the articles that will also be returned. If you pass any parameters to our system that are not used by us, they will be returned as-is with the rest of the parameters at the end of the sale. Parameter information will typically be returned by POST, however parameters will be converted from POST to GET if the Header Redirect method is used or the Plug n Play parameter set is used and multiple products are purchased at the same time.

Related Articles:

Why won’t my parameters pass back?

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

Parameters are only passed back to a script. This means your Approved URL needs to end in a script extension (cgi, pl, php, asp, jsp, ETC).

Why are my buyers being returned to the wrong URL?

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

Please Check where you add/edit products in the Admin to see if you set up a return URL that is different than where you want the buyer to be sent to. That return will override the return URLs you set up in the Return page.

How do I use the continue shopping button?

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

The continue shopping button works like this:

If return_url is passed in, it returns to the page (i.e. return_url=http://www.example.com/mypage.html).
If that is not passed in, it returns to the page the buyer clicked “buy” (by http_referer) from on your site (doesn’t work if you are testing from a page on your pc).
If those 2 things are blank, it returns to the website url listed on the account.

Below are examples of how the return_url parameter may be implemented.

Form:

Hyperlink:
&return_url=http://www.example.com/mypage.html>Buy from 2CO

Can I have extra fields on the form?

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

Most of our Vendors that need extra details about the buyer usually have the buyer sent back to a form on their site after the sale. This way, the buyer could send all extra details directly to them.

You can use the Purchase Machine section of our developers.2Checkout area to see how you can pass custom parameters through the purchase routine.