Access to the demo environment#

This guide walks you through creating your own app for the Mergado Store, connecting it to the Mergado API, and safely testing it directly in Mergado without having to pay. Mergado allows developers to build custom integrations (“apps”) that extend the editor’s functionality or communicate with its API. There is no official “demo environment” with preloaded data — instead, you’ll set up your own test project in just a few steps.

Step-by-step guide#

1) Create a Mergado account#

If you don’t have an account yet, create one at app.mergado.com.

2) Create your own app#

  1. Open: https://app.mergado.com/developers/create-app/
  2. Fill in the basic app details.
  3. After creation, you’ll get access credentials (specifically, access to entities where the app is enabled).

3) Set up a test project (if your app works at the project level)#

  1. Create a new project in Mergado for testing.
  2. Upload a test feed — a small feed with a few products is enough.
  3. In the project settings, switch the project to test mode so you don’t have to pay for testing.

4) Enable the app on the project#

In the project settings, enable (turn on) your app. This gives it access to the entities (feeds/projects) it has permission to read and modify.

5) Authorization and API calls#

Note about the API version: The version you use affects endpoint behavior. If the version doesn’t match, behavior may differ from the documentation.

Tips for efficient testing#

  • There is no central demo shop — each developer sets up their own test project.
  • Test mode ensures you don’t pay for testing.
  • If your app requires project-level access, enable it on a specific project.
  • For quick tests, a small feed with a few products is enough — no need to upload production data.
  • Use a separate test account/project for integrations so you don’t affect production data.

FAQ#

Is there an official demo environment with data?#

No. There is no central demo data available. Create your own test project in Mergado.

Where do I create a Mergado account?#

At app.mergado.com.

Where do I create my app?#

At https://app.mergado.com/developers/create-app/. After filling in the basic details, you’ll get access to entities where the app is enabled.

How do I test without charges?#

Enable test mode in the project settings.

Do I need a project if my app works with projects?#

Yes. Create a test project, upload a small feed, and enable the app on the project.

How do I grant my app access to project data?#

Enable the app in the project settings. It then gets access to the feeds/projects it can read/modify.

Where can I find the API authorization process?#

In the documentation: https://mergado.github.io/docs/api/authorization.html.

Where is the full API documentation?#

At https://mergado.docs.apiary.io/#.

An endpoint behaves differently than documented. What should I do?#

Check the API version. Endpoint behavior is versioned, and a different version may lead to different behavior.

How large a feed should I use for tests?#

A small feed with a few products is enough — it’s ideal for fast iteration.

How do I protect production data during development?#

Use a separate test account/project so changes don’t affect production.

Backward For Developers
🇨🇿 🇬🇧 🇩🇪 🇭🇺