Skip to main content
knowledgecenter.2checkout.com

Integrate WooCommerce

Overview

WooCommerce is a plugin that integrates easily with any website built on WordPress. The plugin helps merchants turn their websites into fully functional WordPress eCommerce platforms with just a few clicks.​

WooCommerce offers online retailers a suite of services including payments, marketing, shipping, and customer engagement tools to simplify the process of running an eStore for small and enterprise merchants. ​

Related links

Availability

WooCommerce integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts). 

WooCommerce Settings

Regardless you are already using the WooCommerce connector or you want to start integrating with 2Checkout to receive payments, you need to follow the steps below:

1. Download the 2Checkout payment module from GitHub by clicking on the Code button and then on Download ZIP.

woocommerce_connector_1_github.png

2. After downloading the .zip archive, open it and extract the folders twocheckout-convert-plus, twocheckout-inline, and twocheckout. Archive these folders separately as a .zip file.

3. Log in to your WordPress admin, navigate to Plugins and click on Add new.

woocommerce_connector_1.png

4. On the Add plugins page, click on Upload plugin, then hit Choose File and click on Install Now.

woocommerce_connector_2.png

5. On the Plugins page activate the modules for ConvertPlus, InLine cart, and 2Pay.js by checking the boxes and clicking on the Apply button.

woocommerce_connector_3.png

6. Go back to the Dashboard, scroll down to WooCommerce, and click on Settings.

woocommerce_connector_4.png

7. Under WooCommerce - Settings, click on the Payments tab.

woocommerce_connector_5.png

8. Enable all three modules and then click on Set up to configure each module.

woocommerce_connector_6.png

9. Configure each module by filling in all the fields:

  • Input a Title and Description for the module. These fields control how your users will see the module during checkout.
  • Input the Seller ID. Your Seller ID is the Merchant Code from the 2Checkout Merchant Control Panel. To copy this code from 2Checkout and paste it in the WooCommerce platform:
    • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Copy the Merchant Code from the API section and paste it into the Seller ID field in WooCommerce.
  • Input the Secret Key. To copy the Secret Key from 2Checkout and paste it in the WooCommerce platform:
    • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Copy the Secret Key from the API section and paste it into the Secret Key field in WooCommerce.
  • Input the Secret Word. Your Secret Word is the Buy-Link Secret Word from the 2Checkout Merchant Control Panel. To copy this code from 2Checkout and paste it in the WooCommerce platform:
    • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Go to the Secret Word section, edit the INS Secret Word to match the Buy-Link Secret Word, then copy the code and paste it into the Secret Word field in WooCommerce.
  • Fill in the IPN URL
  • Check the Debug Log option if you want to log 2Checkout events.
  • Check the Demo order option if you want to be able to place test orders.

woocommerce_connector_8.png

10. Click on Save changes.

woocommerce_connector_7.png

11. Test your integration by placing an order. If your set-up is correct,

  • the ConvertPlus flow will look as below

woocommerce_connector_test_9.png

  • the InLine checkout flow will look like this

woocommerce_connector_test_10.png

  • the 2Pay.js flow will be displayed as shown below. You can customize the form by using the Custom style option.

woocommerce_connector_9.png

woocommerce_connector_test_11.png

2Checkout Settings

  1. Sign in to your 2Checkout account.
  2. Navigate to Dashboard → Integrations → Webhooks & API section
  3. Follow these steps to activate Redirect URL:
    • In the Redirect URL section check “Enable return after sale”
    • For Redirect URL section, set the Approved URL to your WooCommerce URL
    • For Return method, select Header Redirect
  4. Click Update to save your settings.
  5. Make sure to enable the IPN webhook notification in your Merchant Control Panel
  • Log in to the 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & API
  • Scroll down to the Notifications section and enable the IPN webhook

set up IPN in merchant control panel_1.png

  • For the Payment notification type field, select IPN or Email Text & IPN, and then click on the Configure IPN button.
  • On the IPN settings page, click on the Add IPN URL button and input the IPN URL available in the configuration page in WooCommerce.

woocommerce_connector_test_12.png

woocommerce_connector_test_13.png

  • Enable all triggers and response tags

set up IPN in merchant control panel_4.png

About WooCommerce

WooCommerce is the most popular WordPress eCommerce plugin. And it’s available for free. Packed full of features, perfectly integrated into your self-hosted WordPress website. For more information visit: woothemes.com/woocommerce.

FAQ

1. Does the new connector use webhooks?​​

Yes, it uses IPN, so make sure you enable it from your Merchant Control Panel.

2. Do order statuses get updated on the WooCommerce side if any change occurs after place order?​​

Yes, both order and fraud statuses are synchronized, as well as refunds.​

3. Can I place refunds?​​

Yes. You can place refunds from the WooCommerce portal.​

4. Can I use this connector with a 2Monetize account?​​

No, the connector is built to cover only the 2Sell and 2Subscribe accounts.