• Log in
  • Contact Us

Get in touch  

Concepts • Moltin setup

Getting started with Moltin

Last updated: 14 Oct 2019

Getting Started walks you through a basic project configuration in dashboard (Setup), and lists some typical steps to consider before you launch your project (Launch Checklist).

  1. Get yourself up and running in 5 simple steps:
  2. Sign up as a Moltin user to get access to Moltin account and dashboard.
  3. Set up a Moltin project.
  4. Optionally, invite your colleagues to collaborate.
  5. Get the Moltin eCommerce API Keys.
  6. Start making your first API requests.


Basic project configuration happens through the Moltin Dashboard. You'll need to register as a user to get access to API keys and stores.

Sign up as a user

Use the Moltin website to sign up for an account and add your first project. Once you've created an account and added your project(s), you'll get access to dashboard where you can manage your existing projects. From now on, you can sign in to your dashboard and account separately.

Manage your account

Once you are a registered user and have a Moltin account with access to dashboard, you can create multiple projects (also known as stores), and invite team members to collaborate.

Invite team members

Invite team members to join specific projects. Each team member will have full access to your project via the API and Dashboard.

Every team member has their own unique API client_id and client_secret. This is really helpful if you invite external developers to work on your project, you can easily revoke their access at any time.

You can invite users that are already registered with Moltin, but it is not a requirement. An invitation for unregistered users additionally includes the link to the registration form.

Delete team members

Deleting users is permanent. You can re-add deleted users who will receive a new set of credentials (client_id and client_secret).

Project owners

Each user can invite and delete other users; however, normal users can't delete the project owner. You can manage your team under Settings > Team Management.

Manage your projects

Projects (aka stores) are managed through the Dashboard. If you have multiple projects, switch between them using the dashboard's store switcher.

Use the dashboard to manage projects. In detail you can:

  • Add or delete products.
  • Organise products into catalogs, brands and categories.
  • Manage project settings, such as currency, payment method, etc.
  • Manage your inventory.
  • Assign and manage promotions.
  • Add and manage Flows (custom data).
  • Add and manage integrations.

Project settings

Moltin's API provides the ability to to configure global settings across your project at the API-level only. See: Settings for more details.

Get your API Keys

Access to Moltin's API is protected by authentication tokens. Tokens are generated using API keys and can be found via the Moltin Dashboard.

Every user is provided with client_id and client_secret keys. These API keys are unique to every user and every project, and are used to generate two types of authentication tokens.

You should never share the client_secret or use it client side.

Now that you are all set up with your project, you can make your first API request! If you selected Developer as the user type in your project, your dashboard home page will give you access to the onboarding tutorial that will walk you through the entire checkout workflow, showing you code examples and useful tips.

Launch checklist

Below are a few things to consider before launching an online store, mobile app or IoT integration. Depending on the type of project you're launching, your checklist may look a little different.

Consider these as helpful reminders. 😉

  • Added a payment gateway While we provide a number of out of the box payment gateways, you may wish to integrate your own payment gateway via the manual gateway option. Before you launch a store that accepts payments, you will need to have an active (enabled) payment method.
  • Set a default currency By default we assign USD as the default currency when you create a new project. You may wish to add or update this currency with your preferred options.
  • Set product prices Make sure to set a price for your products you have set as live. This will prevent any mistakes when selling items for free when they should be paid. You can also set products as draft that you don't want to sell immediately. Only live products are displayed in your project.
  • Export optimised images You will want to modify the images you deliver to be optimised for mobile. This will reduce the time it takes your visitors to browse pages of your app.

Further reading

Explore More Concepts

01 Jul 2019

How to calculate cart and order totals

There are two methods that may be used to calculate cart and order totals. The method used depends on the calculation_method setting. The default is currently the simple method and this will continue...

Read More
James Carter
in Orders | Carts
18 Jun 2019

How promotions work

Promotions allow you to provide discounts to customers. By defining a Promotion and a code, you put in place the facility to offer discounts to customers applied directly to their shopping carts.

Read More
George FitzGibbons
in Carts | Promotions
06 Jun 2019

When to use a custom cart

Custom carts allow you to process an order for any type of item you wish to sell. The item does not need to exists in Moltin, which means custom cart items can be used for all sort of use cases.

Read More
George FitzGibbons
in Carts