New! – idealo for WooCommerce – The official idealo Plugin!

Getting started with idealo for WooCommerce

If you want to sell through the idealo service your WooCommerce products, then our plugin idealo for Woocommerce is the best solution: a reliable and easy way to quickly update your WooCommerce orders with the idealo platform.

This means that your customers can buy on idealo, but you manage the related orders in WooCommerce as usual. idealo for WooCommerce will take care of the rest.

What is idealo and what exactly idealo for WooCommerce can do?

idealo is a price comparison service: this means that customers can use it to search the best offer for the products they want to buy and when they find it, the platform provides a link to the original merchant page where the purchase can be actually performed.

But this behavior, while doesn’t change for customers outside of Germany, has been recently extended for users buying within Germany. In fact in such case customers can purchase directly on the idealo shop, without any merchant online shop redirection.

To achieve that, the merchants needs to open an account on idealo, set their products and manage the related orders directly on idealo.

So, if the merchant wants, he can work on idealo and sell there all the products. But wait a minute… what if the merchant wants to sell the same products in his/her own shop? In this case we will have a double job to do: the merchant will have to manage both the orders in idealo and the orders relating to his/her WooCommerce store.

So, more sells opportunity, more work to do? Not really.

At this point idealo for WooCommerce comes to your aid: when the merchant uses WooCommerce on his/her shop, is possible to automatically download the orders relevant data from idealo, and hence manage them on the WooCommerce side. No additional work so: you sell on idealo, but rely on the usual WooCommerce workflow.

What are the requirements for using Idealo for WooCommerce?

To install idealo for WooCommerce, you need:

  • An installed version of WordPress >= 5.3
  • An installed and activated version of WooCommerce >= 3.9
  • PHP version >= 7.1

Installing idealo for WooCommerce

  1. After you have purchased idealo for WooCommerce, please log in to your customer account and download the product in the API Downloads section
  2. Log in to your WordPress installation
  3. Go to Plugins → Add new
  4. Click the Upload Plugin button and upload the idealo for WooCommerce zip file from your computer
  5. Click on Install now and wait until WordPress says the plugin was installed successfully
  6. You can activate the plugin immediately with clicking on Activate now on the success page. If you want to activate it later, you can do so via Plugins → Installed Plugins
  7. After the installation, in order to activate your license, you can proceed as described here

Settings for idealo for WooCommerce

Setting idealo for Woocommerce is really easy and straightforward. First of all you need to create a new account on the idealo platform .

After that, you access the idealo back end and there you can find several info to start selling your products in the idealo platform: for our purpose we are actually interested to the API info that connect idealo for WooCommerce with the idealo platform, and hence automatically update your orders in WooCommerce.

API Settings on idealo platform

To access the API info go to My idealo section and click on Settings.

My idealo Settings
My idealo Settings

There, select API Clients from the menu on the left and then you will be able to see your Shop-ID.

Shop-ID value
Shop-ID value

Now, scrolling down the page, you access to another section, Merchant Order API v2 where is possible to generate a new Client Id and the related Client Secret .
The system can generate these info in two flavours: Sandbox, for testing purpose, or Production, for the live environment.

To let the plugin works you need to generate a new Production Client, hence choose Generate a new production client as reported in the picture below.

Generate new client
Generate new client

So, with these main info: Client Id, Client Secret and Shop-ID, you can configure idealo for WooCommerce in your WooCommerce shop.

Settings on idealo for WooCommerce

Proceed going to WooCommerce → Settings and clicking on idealo Tab you land to the idealo settings page as shown in the following picture:

idealo for WooCommerce settings page
idealo for WooCommerce settings page

Here you can fill the settings fields:

  • Merchant Name: here set the unique name of the marketplace participant
  • Shop Id: insert the number that identifies the specific shop connected to the idealo platform
  • Client Id: insert the Client Id value
  • Client Secret: insert the Client Secret password value
  • When to synchronize Orders with idealo: select the time interval to trigger the orders import process
  • Run orders import now: this button lets you manually trigger the orders import

Press the Save button to save the settings.

When the orders import starts, automatically after the selected time interval, or manually using the related button, idealo for WooCommerce imports the orders in your WooCommerce shop.

When the plugin perform an import, it does not provide any feedback. Just check your orders (WooCommerce → Orders) to verify if new orders have been imported, or see the Debugging section for further info.


Every order refers to one or more products.

To be sure the import is performed correctly the products on idealo should be set also in your WooCommerce.

In that case be careful that the related SKU values are properly set in idealo platform and in your shop too: this because that value let you correctly match the products related to the order.


After a customer successfully performs a purchase through idealo, the plugin can download the related order into your WooCommerce shop.

The new order will be in Processing status, and will be related to the WooCommerce products via the SKU value. In that case WooCommerce will retrieve the related tax information as usual.

Similarly, the shipping cost will be taken from idealo and the stock level of the product will be updated in your store.

But in case the product SKU in the order does not match the one in your WooCommerce environment, WooCommerce will use the default tax rate, and it will not update the stock level for the product.


The refund process for an imported order can still be managed from your shop. In that case, to properly perform the refund, you have to proceed as described below

  • Access the order page
  • Scroll down to the Refund metabox an click on Refund

    Refund order section
    Refund order section
  • Now the refund info are visible: you can select the number of item and/or the amount you want to refund

    Select item/amount and refund manually
    Select item/amount and refund manually
  • Finally you can perform the refund: the standard refund button that WooCommerce provides is the one labeled as Refund manually, and if you use it, you will need then to access also the payment system in order to manually perform the refund for the requested amount. But  depending on the gateway the customer used to originally perform the purchase in idealo, a second button could be available.In that case, using this button the refund process will be completely automated and after pressing it no further action will be needed.

Refunds status mapping

Consider also that when a refund is performed on the WooCommerce side, the idealo platform will mark the order as revoked or partially revoked: these statuses will be set in idealo only if the original quantity of the products of the order is decreased.

Besides, through a dedicated select box in the WooCommerce site you can choose the revoke reason related to the particular refund action.

Automated refund button and revoke reason

Lately, a new order status has been added in the idealo platform: the revoking status . This is set in idealo when a revocation request from a customer is received. So, in this situation the plugin maps the revoking order in the WooCommerce store as Cancelled.

This way the merchant is able to understand which WC order needs to be refunded since the customer requested it, and hence proceed with the refund process as explained above.


During the import, and while using the plugin, there may be no feedback of whether everything is happening as expected. If something doesn’t seem right, the best place to go to is the log.

The plugin in fact processes several events during its work, and some of them generate messages in the log. To track these messages we use WooCommerce log UI, as shown in the picture below.

WooCommerce Logs
WooCommerce Logs

The log is essential for understanding and fixing problems related to import.

Besides we implemented a Debug Plugin that let testing process more easy to perform. For further info you can refer to The idealo Debug Plugin tutorial.

Please make sure you include the complete import log if you need to contact the support for any issue related to the plugin.