2Checkout

More info @ www.2checkout.com

Gateway Setup

For details on how to set up 2Checkout INS (Instant Notification System), click here.

Account Number

Your 2Checkout account number.

Secret Word

Specify your 2Checkout secret word. This is set in your 2Checkout account area.

Information About this Payment Method

This is presented to visitors if they click for more info on the gateway on the checkout page. Optional.

Use BB Code for formatting, HTML is not allowed.

Order Status Preferences

Specify which order statuses to set for callback operations. Leave as default if you aren`t sure. "Pending" statuses restrict download access for none gateway methods and should be used until payment is cleared.

Setting preferred order statuses can be useful for filtering with other admin operations.

Alternative Redirect Url (Optional)

Alternative redirect url is the page a visitor will be directed to after a successful transaction.

You should NOT use this option if you sell downloadable items as visitors will not be able to download their products immediately after purchase.

Enter full url starting http://

If you need to do further operations on your redirect page based on the sale, the following query string params may be used and passed to your new page:

{id} = Sale ID in Database
{code} = Sale Buy Code in Database.

Example:

http://www.example.com/new-redirect.php?id={id}&code={code}

Live Payment URL

Live payment url. At the time of these docs it is:

https://www.2checkout.com/checkout/purchase

This should not be changed unless altered by the gateway.

Test/Sandbox Payment URL

Sandbox or test payment url. In many cases, this is the same as the live payment url. At the time of these docs it is:

https://www.2checkout.com/checkout/purchase

This should not be changed unless altered by the gateway

Language

Supported 2Checkout languages. Check the 2Checkout site for further updates.

If more languages are supported, add them to the $twoCheckoutLanguages array in the 'admin/control/arrays.php' file.

Enable 2Checkout

Enable / disable this gateway as a payment option.

Files Related to this Payment Option

For advanced users ONLY:

checkout/twocheckout.php (Callback handler)
control/gateways/methods/twocheckout.php

2Checkout Test Mode & Restrictions

In test mode 2Checkout does NOT send any INS post data back to the website, so its very difficult to test 2Checkout successfully in test mode. A live payment will probably be your best way of testing. An option to utilise the 2Checkout INS simulator may be built in at a later date.

Re-Transmitting INS Messages

2Checkout enables you to re-transmit the INS post to your website. This is useful if you website server suddenly goes down at the point of transmission and the sales data wasn`t updated in the system. To re-send INS post transmissions, log into your 2Checkout account and select 'Notifications > Failed' from the top menu. You can also select 'Success' if 2Checkout sent the INS ok but the website didn`t log anything.



Once your results appear, click the checkboxes and then 'Resend'.

NOTE: The ORDER_CREATED status is the initial transmission, so this should be sent first, followed by 'FRAUD_STATUS_CHANGED'.

Help Tips

The same or additional information may be provided by hovering your cursor over the image next to each heading in the admin area if applicable.