Support Center

Connecting to Shopware



Shopgate supports Shopware as a shopping cart system.

By setting up the Shopgate plugin for your Shopware (version 4 and 5) shop, you will get these wonderful features straight into your mobile shop and apps:


For instructions on an older version of Shopware, please read Connecting to Shopware 3.5
Supported Version Import to PrestaShop

Shopware 4 and 5

Sync Export to Shopgate Mobile Shop

Delivery Status "Shipped"
Order Status "Canceled"
Stock Quantity, on Product Detail Page
Product Tax Classes, Rates & Rules

Related Products, Upsell & Cross-sell

Customer Account Validate, upon Cart Changes

Login with Desktop Shop Account
Login to Desktop Shop with Mobile Account
Customer Groups / Tier Pricing
Show Desktop Orders on Mobile

Shipping Method
Payment Method
Product Availability

Supported Payments Notes

Shopgate, PayPal, PayPal Plus, Cash on Delivery, Prepayment, Invoice, Direct Debit, Billsafe, Sofort Überweising, Amazon Payments, Paymorrow (Invoice), Payolution

Up-sell products and DHL module supported.

Product and brand searches done in a search engine on a mobile device are now redirected to the shop's mobile website.

* Shopgate coupons will NOT work when using the DHL module. Regular shop coupons are not affected and will continue to work on the desktop and the mobile sites.


In this article, you will find the instructions to set up the Shopgate plugin for your Shopware 4 and 5 shop.


Topics covered in this article:

  1. Installing the Shopgate Extension
  2. Establishing connection between the plugin and the Shopgate system
  3. Updating an existing Shopgate plugin
  4. Configuring the Plugin
  5. Frequently Asked Questions (FAQ)



1. Installing the Shopgate Extension

Installing the Shopgate extension for your Shopware shop is fast and easy!

  1. Simply go to this link and get the Shopgate extension by clicking Add to shopping cart. This extension is completely free for our Shopgate users.
  2. Finish the checkout process. Log in with your Shopware ID and password, if you are not logged in yet.
  3. Install the extension by following the instructions.

That's it! Now the Shopgate extension has been installed in your Shopware shop.

If you would like to install the Shopgate extension using the zip file instead, here is how.


2. Establishing connections between the plugin and Shopgate

After the Shopgate plugin has been installed successfully, 2 simple tasks need to be done to connect your Shopgate mobile shop to your Shopware backend:

  • entering API credentials in your shop's backend, and
  • entering your shop's URL in your Shopgate's admin page.


2.1 Getting API credentials

  1. Log in to your Shopgate Admin page.

  2. Click on Integration from the menu bar, then select Install Interface.

  3. In the drop-down labeled Select system, search for Shopware 4.x and select it.

  4. A popup opens. Look for Customer number, Shop number, API key, and Alias under 2. Configure. These are the API credentials the plugin needs to authenticate at the Shopgate backend. Leave this page open - we will come back to enter the URL (explained in 2.2 Establishing connection)

  5. Copy Customer number, Shop number, API key, and Alias, and paste them individually onto the plugin configuration page in your Shopware Admin (Configuration -> Plugin Manager -> Shopgate Extension Settings). The rest of the options can be configured later. This is explained in Chapter 4. Configuring the Plugin). Click Save plugin settings.


2.2 Connecting your shop to Shopgate

  1. Go back to the pop-up window at your Shopgate merchant page (step 4).

  2. Under "3. Enter URL", enter the URL of your shop, ideally starting with “https://”. For example Click connect to establish the interface.

  3. If a connection is made successfully, a popup shown below will open. Here you will be able to assign jobs for your first connection. We recommend leaving all assignments to ON at this time. Click Save.

  4. That's it! Now the Shopgate backend will automatically start to import product data via the newly established interface. And welcome to the mobile world :)

3. Updating an existing Shopgate plugin

3.1 Checking for custom adaption

Before updating your Shopgate plugin to a newer version, make sure to check if your shop uses a customized version of the Shopgate plugin. If this is the case, a generic plugin update will NOT work for your shop.

To check if your plugin is customized...

You are using a customized version if

  • you have contacted Shopgate for making a 3rd party plugin to work in your mobile shop, or adding a special feature/function
  • Shopgate has sent you an adapted version of plugin
  • the plugin file you installed has "adaption" in the name

If your shop uses a customized Shopgate plugin...

Please email Shopgate each time before updating with the following details:


3.2 Updating the plugin

To update a customized Shopgate plugin, follow chapter 1 to install it manually.

To update a generic Shopgate plugin, follow the steps here:

  1. Download the latest plugin and upload it to your Shopware Admin.

  2. After a newer version of the plugin is successfully uploaded, a new button will appear in the Action(s) section. Click on it to update the plugin automatically.

  3. If no update button appears, save your current Shopgate plugin configurations somewhere else, and click on the Reinstall plugin button. Afterwards, you need to configure the plugin again with the data you saved before the reinstall.


4. Configuring the Plugin in Shopware

In the configuration panel of your Shopware Admin (Configuration -> Plugin Manager -> Shopgate Extension Settings), you are able to configure the plugin further.

Active Select Yes to activate the Shopgate plugin for your shop.
Customer Number This is your Shopgate Customer number. See Chapter 2.1 for more information.
Shop Number This is your Shopgate Shop number. See Chapter 2.1 for more information.
API Key This is your Shopgate API Key. See Chapter 2.1 for more information.
Alias This is your Shopgate Alias. See Chapter 2.1 for more information.
CNAME A CNAME is a subdomain of your own domain that points to your mobile website. For example, a CNAME could look like "". To configure a CNAME, please log on to your server hosting website. For more information, please read our help article Adding a CNAME record in your domain host
Redirect Type HTTP redirect is recommended for better performance and search engine rankings. However, using external cache engines (e.g. Varnish) might cause problems such as a "redirect loop". In that case, use JavaScript redirect instead.
Order status if shipping is not blocked Set order status to Offen if shipping is not blocked.
Source for importing shipping methods Select Zuordnung zu Shopgate-Versandart if you want to send all possible shipping methods for the current cart to your mobile website within the check_cart request.
Shipping method Select a fixed shipping method for Shopgate orders.
Send customer an order email Allow Shopware to send an email notification for each new order imported from Shopgate
Attribute ID's for product export All attribute ids will be exported in the property section of the product, format e. g. 3 for attr3
Server Do not change this setting unless instructed by your Shopgate support personnel.
Server URL Do not change this setting unless instructed by your Shopgate support personnel.


5. Frequently Asked Questions (FAQ)

5.1 Why is "generic payment" displayed instead of SOFORT Überweisung/Paypal/Credit card?

This is because payment methods that could not be automatically assigned from the Shopgate plugin will be listed as "Generic Payment".


5.2 Why couldn't my orders transfer from Shopware to plentyMarkets ERP system?

If you use plentyMarkets ERP (Enterprise Resource Planning) system in your Shopware Shopping Cart System, it is a known issue that Shopgate orders may not be transferred correctly.

To fix it, please make the following changes to the "plentyMarket Connector Module" in your Shopware settings:

  1. Navigate to Settings ->plentyMarkets.
  2. In plentymarket's configuration page, click Settings tab.
  3. Look for "Shopgate Zahlungsart(en)" under section"Export Aufträge".
  4. In the text field, select "Generische Zahlungsart von Shopgate - Greift, wenn keine passende Zahlungsart gefunden wurde" and "Shopgate Zahlungsart - Der Zahlungsfluss läuft über das Shopgate-Konto".


5.3 Why did an order failed to transfer?

This may be caused by the DHL module.

If you use the DHL module in your Shopware backend, an error might occur when a customer uses mobile coupons*. Desktop coupons created via your Shopware backend, however, should not cause this issue.

* Coupons created for the mobile website and/or apps in your Shopgate Admin.


5.4 How to install the Shopgate extension using the zip file?

You can also install the Shopgate extension for Shopware by downloading the zip file via this link then uploading it to your Shopware shop backend:

  1. Log in to your Shopware admin and navigate to Configuration -> Plugin Manager.

  2. On your Plugin Manager page, select "+ Add plugin manually". A new window will appear. Click Select plugin, select the zip file you just downloaded, and click "Upload plugin" button.

  3. After the Shopgate plugin has been successfully uploaded, the Shopgate plugin should be listed in the Plugin Manager as inactive. To activate the plugin, click the green "+" button on the right. 
  4. A configuration section will open. Check the box "Activate plugin" to activate the Shopgate Plugin.

That's it! Now you have installed the Shopgate plugin for your Shopware shop using the zip file.