2Checkout Payment Gateway Setup Instructions

Configuring the  2Checkout payment gateway is simple and only requires a few steps.

First, install the extension just like any other plugin. If you need assistance with this, refer to the  FAQ.

Once installed, go to Downloads > Settings > Payment Gateways.

You will have the option to enable one or both of the 2Checkout gateways:

Purchases made with  2checkout will send customers to the 2Checkout website where they will complete the purchase.

Purchases made with 2Checkout Onsite will keep customers on your website and allow them to enter their credit / debit card details on the checkout screen. Note: this option requires that you have an SSL certificate installed on your website.

After you have chosen which gateway options you want to use, enter your 2Checkout account information:

Your account number can be found at the top right of your 2Checkout account when logged in

Your secret word can both be found in your 2Checkout account details under the Account → Site Management section.

The Publishable and Private API keys can be found in your 2Checkout account details under the API section. These two keys are only needed for on-site purchases with credit / debit cards.

Instant Notification Service (INS)

2Checkout's Instant Notification Service allows 2Checkout to communicate with your store, keeping transaction data in sync. INS must be set up properly for recurring billing to work.

From your 2Checkout account, navigate to the Notifications screen and enable all notifications. The URL should be set to:


Note: please replace "example.com" with the appropriate name of your website.

Important! If INS is not properly configured, purchase processing will not work.


INS Failures

If you find that your INS requests are failing, make sure that you're using the same protocol for all requests.  For example, if you make your request via HTTP, but then require HTTPS for incoming requests (from 2Checkout for example) then they'll fail, since they don't match.

Error: Unauthorized

This notice can happen when the billing address is not filled out.  The billing address is required, so hiding or removing it will cause the transaction to fail.

Bad request - parameter error

If you receive this error, it means one of two things:

1. Your 2Checkout account has not been fully approved. Contact 2Checkout's support team to confirm and to fully activate your account.

2. Not all required fields are being sent to 2Checkout. This could happen if you have removed the billing address or other required fields on the checkout form. To resolve the problem, restore the fields that were removed.

Can customers update their credit card information?

No. If you have a customer setup on a subscription, 2Checkout does not currently allow them to update their credit card information. Additional information is available on the 2Checkout website.

Related Articles