Skip to content

Storefronts and access keys

One catalogue, several shops: domain, language, currency, and the key a shop connects with.

Requires the module E-commerceAvailable to roles AdminOpen in the app (Opens in a new tab)
On this page

Monokaido does not assume a single shop. The same catalogue can serve several storefronts — a different domain per country, wholesale alongside retail — and each connects with its own key.

The storefront screen with buttons to create a storefront and an API key, and a documentation link
Fig. 1 Shops. One screen for two different ways of getting the catalogue to a customer.

Controls on this screen

  1. Two things at onceStorefronts (a ready-made shop) and API keys (your own front end). Not two ways to do the same thing — two different routes.
  2. Create storefrontA shop running on Monokaido. The domain, look and content are configured afterwards.
  3. Create API keyAccess for your own front end. It takes the catalogue over the API and you own the presentation.
  4. API documentationOpens the interface reference. This link is for a developer, not for an operator.
  5. Empty stateUntil one exists, the catalogue is published nowhere — the module is on but has no output.
  6. Where it livesIn the left ecommerce menu under Shops, straight after customers.

What a storefront defines

FieldWhat it doesNote
NameThe internal name.
DomainThe address the shop runs at.It also decides which links appear in emails and exports.
LanguageThe default content language.From the languages in Settings → Languages (Opens in a new tab).
Currency and regionWhat it charges in and where it sells.Tied to Regions (Opens in a new tab) — tax and shipping follow from them.
Access keyThe secret string the shop authenticates with.Shown once, at creation. Store it immediately.

What is shared and what is per shop

LayerExampleWhere it is configured
Shared across storefrontsProducts, parameters, categories, brands.The Products, Parameters and Categories sections.
Per storefrontDomain, language, currency, content, emails, shipping and payments.The E-commerce section.
I lost the key.

It cannot be shown again. Create a new one and replace it in the shop; revoke the old one.

Can two shops have different prices?

Prices belong to the catalogue, but currency and region belong to the shop — so conversion and tax do differ.

Will the second shop see the first one's orders?

Orders belong to the storefront they were placed on, and can be filtered by it.