Guided setup
Sign up for free and set up your organization
Last updated
Getting started
Sign up for free and set up your organization
Last updated
As soon as you and your account is successfully confirmed, you will be prompted to . To begin receiving orders and making sales through Commerce Layer, you need to configure it so that it meets some minimum requirements. A simple wizard on the Dashboard UI will guide you through the necessary steps to configure it.
The wizard is split into three main sections:
To create your first sample organization all you need to do is choose a meaningful name for it and select the region where your data will be stored.
Once the organization is created, the chosen data storage location cannot be changed anymore.
For starters, you need a market where to sell your products. To create a market you must first define your business model by setting up:
The setup wizard will guide you through all the necessary steps to create all the resources above and your progress will be displayed in the Dashboard UI:
Now you can use those resources to create your first market. You can optionally specify a market code and, at a later time, connect other optional resources such as:
To be able to ship your product to your customers, you need to configure one or more shipping methods. To create a shipping method you must first set up:
The setup wizard will guide you through all the necessary steps to create all the resources above and your progress will be displayed in the Dashboard UI:
Offer free shipping if the order total or subtotal is over a certain amount.
Make the shipping method available for the previously created shipping zone, shipping category, stock location, or interval of shipment's weight.
To be able to receive payments from your customers, you need to configure one or more payment methods. To create a payment method you must first set up:
You're almost there! What you're still missing to start selling is some product variants with the related availability and prices for the previously created market:
The setup wizard will guide you through all the necessary steps to create all the resources above and your progress will be displayed in the Dashboard UI, until completion:
You can now use them to authenticate and start using the APIs.
This guided setup is intended to help you put together a basic configuration for your organization but just scratches the surface of what you can build and achieve with Commerce Layer.
If — for whatever reason — you need to delete one or more of the organizations you created, please ask the organization owner to reach out to our support team and send a specific request to specifying the list of the organization slug you want to be deleted.
A — the seller or owner of each market in your organization. You need to provide a name and your company address.
A — the physical (or virtual) warehouse from where to ship your products and/or to where to return them. You need to provide a name, an address, and an optional code. From here you can also choose the shipping label format.
An — from here you can choose the inventory strategy, set up some parameters related to stock reservations and stock transfers, and specify how you want to manage the stock (e.g. manually).
A — a container for all the prices of your products in a specific currency. Here is where you also need to specify whether the prices in the price lists will include taxes (e.g. B2C VAT) or not (e.g. B2B VAT, sales taxes).
A — to make the market private
A — to manage order subscriptions.
A — to calculate taxes for the market's orders
A — to automatically geocode addresses
From here you can also manage some market-specific features (e.g. or ) using an external service.
A — you need to provide the category name and an optional code.
A — you need to provide a name for the zone and country code / state code / ZIP code based RegEx that defines it.
Now you can create a and optionally restrict it to the or to a specific currency. Here you can also:
Decide how to manage the cost of the shipping method (it can be a fixed cost for all the shipments, a based on the shipment weight, or a custom cost calculated ).
A — Commerce Layer is currently with some of the most used payment providers. (e.g. cash on delivery, wire transfers) and the option to integrate are also available.
Now you can create a , associate it with the and payment gateway, and set the cost (if any) that will be charged when customers select it. Here you can also manage some specific options related to the transactions associated with the orders processed via this payment method, such as:
— to automatically place orders upon receiving a successful webhook from the payment gateway.
— to automatically capture payments upon authorization.
— to fulfill orders without requiring payment capture and manually capture them when ready to ship.
— specific product variations that are being sold. You need to provide the unique SKU code and you can add a name, a description, and an image URL to be used internally. Here you can also associate the , specify the item's weight, and indicate if the SKU refers to a digital product that doesn't involve shipments (do not ship) or to items with virtually unlimited stock (do not track).
— the SKU's inventory in a specific stock location. Here you need to select the SKU, associate the , and specify the quantity of available units.
— the defined cost of an SKU associated with a currency and price list. Here you need to select the SKU, associate the , and specify the value in the selected currency. You can also set an original price to be displayed with a strikethrough and/or enable a tiered pricing policy based on or .
At the moment of the creation of the organization, a couple of API credentials (one of type and one of type ) are also automatically created:
For example, you can try to create an order using the directly from the Dashboard and leverage our to place it!
Take your time to explore the rest of this guide, check the , have a look at our recipe-like , and become a pro!
Do you need to extract some kind of data information from your Commerce Layer's organization? Check our and see how it can enable you to gather and aggregate useful data that you can leverage to measure the health and performance of your ecommerce business.
If you want to exercise greater control over your organizational structure and user roles and be able to manage provisioning tasks programmatically instead of manually, leverage our .
Would you like to benefit from a DSL that enables you to define promotional rules? If you're an enterprise customer, you can ask to test our and start setting up almost any kind of promotions to boost your sales, from the simplest to the most complex.
For everything else, and feel free to ask any questions to the team or get involved in the conversation with the rest of our developers' community.
If you want to dig deeper into how Commerce Layer's data model is structured, feel free to skip this initial wizard by clicking on the related text in the upper right corner and seed your organization , as explained in the following step-by-step guide.
