1. Help Centre
  2. Getting started

How to connect your Zalando store to MerchantSpring

Zalando credentials

MerchantSpring requires your Business Partner ID, Client ID, and Client Secret for Zalando in order to connect it to the Marketplace Manager and display data.

Step 1: Acquiring API credentials

Creating and Managing Apps


Go to your Zalando account. Please make sure that you are logged in as developer-admin before accessing the Applications Management module.

zdirect-login-as-developer

If you see the error page below, please switch your account to the tech account you need to access.

zdirect-login-as-non-dev-error-page

Introduction

Creating an app in the zDirect Portal creates an OAuth client recognized by the zDirect Platform. The client is assigned a unique client ID and a client secret, which may then be used for validation.

In the Apps Management section of the zDirect Portal, you may:
  • Create or delete apps
  • Get your client ID and client secret for API authentication
  • Set your app to sandbox or production mode
  • Configure access control and permissions (scopes)

Creating an App


To create an app:
  1. Navigate to the Applications section of the zDirect Portal.
  2. Click Create Application.
  3. Fill in the app name and description.
zdirect-fill-app-data

All new apps are set to sandbox mode by default. For more information, see Sandbox Testing.

Scopes: Configuring Access Control for Apps

Many zDirect APIs require clients to have specific permissions or scopes for read or write access.

When a zDirect Platform Tech Partner is invited by a Fashion Partner to integrate on their behalf, the Fashion Partner assigns the zDirect Platform Technical Partner account granular read and write access permissions, such as authorization to access specific APIs.

Developers may assign any or all of the permissions that have been granted to their account to the apps they create. An app's access permissions may be changed at any time.

To set access permissions for your app:
  1. Log in to the Applications section of the zDirect Portal.
  2. Select the app you wish to configure.
  3. Scroll down to "Access Control", and select the desired values for Fashion Partner and Merchants in the pulldown menus.
  4. Specify your app's access to each service.

    zdirect-app-permissions

  5. When you are finished, click Edit Application in the lower right to save your changes.

A single app may be used by multiple Merchants associated with the same Fashion Partner. Simply select all of the Merchants you want to have access in the Merchants pulldown menu.

If you want different Merchants to have different access rights, you will need to create multiple apps.

A single app may not be used by multiple Fashion Partners.

For more information on the developer and client permissions, see Fashion Partners, Technical Partners, and Merchants in the Getting Started Guide.

Setting your App to Sandbox or Production Mode


All apps may be set to sandbox mode or production mode in the zDirect Portal. For more information, see Sandbox Testing in the Getting Started Guide.

To set your app to sandbox or production mode, or to verify which mode it is in:

  1. Navigate to the Applications section of the zDirect Portal.
  2. Click on the app you wish to configure.
  3. You will see a prominent message on the top of the page telling you if the app is set to sandbox mode or production mode.

    zdirect-sandbox
  4. Enable Production Mode to set the app to production mode.


Step 2: Connect your Zalando store to MerchantSpring


  1. Login to your MerchantSpring account. Go to "+ ADD CHANNEL". Click "search for channels", then type "Zalando".

    Screenshot 2023-06-07 at 3.06.55 PM

  2. Enter your Zalando store country, Business Partner ID, Client ID, and Client Secret. Assign a Shop/Channel Name.

    Screenshot 2023-06-07 at 3.07.07 PM


  3. After this screen, your Bol.com will be connected to the Marketplace Manager and will start syncing data. Congratulations!

 

If you need any help just say hi in chat or book time with us. We’ll set up a screen share and do it with you.

If you have any other questions, just let us know. We're always happy to help!