Zettle by PayPal

Zettle by PayPal is a service that allows you to accept card payments wherever you are using a smartphone and tablet chip card reader and your own app.

The Zettle integration, which is part of the PayPal extension, gives you the opportunity to offer your products via the Zettle interface as an additional sales channel, which means you can offer your products locally, for example in a shop.
For more information about the service click here.

Installation

Zettle is not a extension in itself but is part of PayPal and therefore does not need to be installed separately. You can find out how to install the PayPal extension here.

Setup

To synchronise your products with Zettle, you need a new sales channel. If you create a new channel, you can now also use the Zettle sales channel. Once you have created it, the setup wizard will guide you step-by-step through the setup of the Zettle interface.

Account Setup

The first step is to establish a connection to an existing Zettle account. If you don't have a Zettle account yet, you can create one in this step or directly here.

Create Zettle-Account (1): If you don't have a Zettle account, you can go directly to the Zettle registration page here to create a new account.

API key (2): If you already have a Zettle account you can link it to Shopware here. This requires an API key from the Zettle administration. In your Zettle account you can create API keys on the left hand side via Integrations>Create API Keys.
The Generate API Key link (3) will take you directly to this configuration.

Here you first specify a key name, how the API key should be listed in the Zettle configuration. You can also see what rights the interface will be given.

Once you have created the key, it will be displayed and you can copy it. Then go back to the Shopware tab and paste the key into the API Key field.

Connection

After you have connected Shopware to your Zettle account in the first step, the account you are using will be shown here again for confirmation. If you have more than one Zettle account and have chosen the wrong one, you can disconnect in this window to return to the first step.
If the account is the right one, simply click Next.

Customisation

In the customisation, you first define a name (1) for the sales channel in your Shopware environment.
Then you enter your shop domain (2). This will be used by Zettle to download media data for the synchronised products.

Product selection

In the step product selection you enter the sales channel from which you want to transfer the products to the Zettel sales channel.

Product synchronisation

In the Product Synchronization step, you specify what to do with the products that were previously in the Zettle product library.

With the Replace Zettle Library option (1) you will ensure that all products currently in your Zettle account are removed. Only the products from Shopware will then be added.
If you select Add Shopware products (2), the products previously stored in Zettle will remain. The products from Shopware will be added to these products.

The number of variant groups must be between 1 and 3 (e.g. size, color, page). If there are more groups, the synchronization of the product will be cancelled

The maximum number of characters in the description is 1024

Price-synchronisation

Here you specify how you want to synchronise the prices of your products with Zettle.

On the one hand, you have the option to synchronise prices with VAT (1). With this option, the gross prices are transferred to Zettle including VAT.

On the other hand, you can choose don't synchronise prices (2). With this option, prices are not transferred to Zettle. After synchronisation, you can adjust the prices in the Zettle product library.

Configuration

Once you've successfully set up the Zettle interface, you can open it at any time and configure it later. To do this, open the Zettle sales channel you created in the Sales Channels section.

Account

The Account section gives you access to all information from your Zettle account at all times.

You can access your Zettle account at any time via the account link (1) to manage it. On the right hand side (2) you will find the current status and when the products were last synchronised.
You can always use the Edit connection button (3) to restart the setup wizard and connect to a new Zettle account.

Overview

In the tab Overview you will find all information about the synchronisation of the products.

In the synchronisation section (1) you can see the information about the last synchronisation. You can see if the last synchronisation was successful, when the last synchronisation was made and when a complete synchronisation was made. By clicking on the Synchronise Now (2 & 3) buttons you can directly perform a complete synchronisation.

Next to the Synchronize Now button you can use the arrow (4) to synchronize only the stock, the product images or the product details.

Synchronised Products

This tab gives you an overview of which products are currently synchronised via the Zettle interface.

Next to each product in the list you will be clearly shown whether (1) and at what time (2) it was updated.
Via the context menu (3) next to each product you can go directly to the product configuration to make adjustments to the respective product.

Settings

All the settings you made when setting up the Zettle interface can be changed later in this tab.
General Settings

Name (1): This is the name of the Zettle sales channel in the Shopware Administration.

Active (2): This button enables and disables the Zettle sales channel. When the sales channel is disabled, there will be no more synchronisation between the Zettle account and Shopware.
Your Shop Domain (3): The domain from your shop is required by Zettle to download media data for the synchronised products.

Synchronisation

With the option Synchronise prices with VAT (1) the gross prices are transferred to Zettle including VAT.

The Don´t synchronise prices option (2) will not transfer prices to Zettle. After synchronisation, you can adjust the prices in the Zettle product library.

Credentials

API-Key(1): An API-Key is required to give Shopware access with sufficient rights. You have already entered this key during the setup. At this point you can change it later.
Generate API Key (2): This button takes you to your Zettle account to generate the required API key with the necessary rights.

Options

Reset synchronisation (1): With this option you reset the synchronisation. All synchronised products will be marked as unsynchronised. This means that all products will be completely re-synchronised at the next synchronisation. Note that the next synchronisation may take much longer than usual depending on the amount of products.
Delete sales channel (2): If you delete the sales channel, it will be irrevocably removed. The sales channel will then no longer be available in the Shopware Administration and cannot be restored. However, all existing orders will remain. Even played catalogues will not be changed by this action. The connection to Shopware will be removed and no further synchronisation will take place afterwards.

Logs

In the log you can see all past synchronisations with the status (1) and date (2). If the status was not successful, you can use the context menu (3) to read the exact error message why the synchronisation was not successful.
With the button Clean up log (4) you can delete the list completely.