All Collections
Connect your Store
How do I connect my Magento store?
How do I connect my Magento store?
Updated over a week ago

Start your free 30-day trial now. Connect your Magento store to Koongo in a few steps. In case a firewall protection is used, please check Koongo IP addresses to be whitelisted

Note: The HTTP basic authentication has to be turned off for Koongo API integration.

The REST API cannot connect a webshop with active HTTP basic authentication.

About Koongo

Koongo provides smooth integration to various online marketplaces and price comparison websites worldwide. Koongo solution enables you to import your Shopify products to Koongo.

You can optimize your data. And create automatic connections to marketplaces and price comparison websites of your choice.

Koongo offers order management functionality for selected online marketplaces. Koongo transfers marketplace orders back to your Shopify store. Marketplace orders can be fulfilled directly in Shopify just like ordinary orders.

1. Download Koongo Install Packages

Download both Koongo module and Order extension

2. Install Koongo Extensions

To install both Koongo extensions, you can use either Magento Connect Manager or upload over FTP

2.1. Magento Connect Manager Installation

You can use Magento Connect Manager to install both Koongo extensions

  1. Log into your Magento Connect Manager


  2. Upload both installation packages, as shown on the image below:


2.2. FTP/SSH Installation

You can install Koongo API extensions over FTP or SSH/SCP client.

  1. Unpack the downloaded install packages.

  2. Upload API Extension content to your Magento installation folder. Please ignore the file package.xml in the installation package.


  3. Upload Order Extension content to your Magento installation folder.


3. Clear Magento Cache

Log into your Magento backend and clear your Magento cache


4. Connect Koongo

Start Koongo wizard and connect your Magento store to Koongo

  1. Start Koongo wizard by selecting System -> Webservices -> Kaas access authorization


  2. Insert user password you used for log in to your Magento backend


  3. Authorize Koongo connection​


5. Sign Up for Koongo Account

The Koongo wizard will re-direct you to the Koongo registration website

  1. Sign up or log into your Koongo account


  2. Authorize Koongo access


In case the Koongo Authorize form is not available, please check if Mage_Oauth is Enabled. Simply go to System -> Configuration -> Advanced -> Advanced and enable Mage_Oauth.


In case the store was not added properly, please check if your /api/rest returns error 404 - https://yourstore/api/rest

If your Magento store runs on an apache server, you can fix that in .htaccess by uncommenting this part of the code or adding this code if it missing there:

############################################ ## rewrite API2 calls to api.php (by now it is REST only) RewriteRule ^api/rest api.php?type=rest [QSA,L]

!!! IMPORTANT !!! this RewriteRule MUST be before the ending rule, which everything else redirects to your homepage!

RewriteRule .* index.php [L]

Also is important to turn on HTTP authorization in your .htaccess file. You must uncomment this part of the code:

RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

If you have an NGINX server, .htaccess is not used. In that case, you must solve all redirections and settings in the Nginx configuration.

6. Add Store

Add a store to your Koongo account by clicking the "Add New" button.



7. Create a Product Feed

Follow Quick Start Guide, Add new feed part. Feel free to contact Koongo support at

8. Order API - General Settings

For Order API, it is possible to set various Order API parameters.

To set them up please go to System → Configuration → Koongo → Order API


8.1. General

  • GTIN Attribute - Select GTIN attribute for order item identification during import. You can use EAN, UPC, GTIN, etc

  • Default Shipping Method - default shipping method for imported orders

  • Secondary Shipping Method - backup shipping method for imported orders

  • Import Backorders - allows you to import orders if the ordered item is not available for sale - e.g. product is out of stock

  • Display Channel Columns In Order Grid - allows you to display channel and marketplace in order grid

  • Order Increment Id Format - Format of order increment id. Default Magento format or Koongo format ##{{channel_code}}-##{{marketplace_code}}-##{{channel_order_id}} are available.

  • Debug mode - Debug mode allows advanced logging.

8.2. Customer Account Management

  • Assign Order To Customer Account - If set to Yes, then imported orders are assigned to customer accounts. A new customer account is created, if the account does not exist for the given email address

  • Customer Group - default customer group for new customers

Did this answer your question?