Settings
The Settings section is the centralised location where you manage all elements of the SparkLayer integration on your website. To begin with, it is used as part of the Onboarding Process, and once you're up and running, it can then be used as a ongoing systems health-check.
The Setup section guides you through the process of configuring SparkLayer. You can learn more about this Getting Started. Once all steps are completed, your integration is ready to go!
Each step can be clicked either to take you to the appropriate area of the Dashboard to be configured, or expanded to show you information right there. For the last two steps, manual testing is required and you'll be asked to check a variety of boxes before marking the step as complete.
Please note Access to the SparkLayer API is only available on the Pro and Enterprise Plans
In order to interact with the SparkLayer API, you'll first need to generate a unique API key that you'll use as part of your integration.
To get started, from within the API Key section, click the 'Create new API Key' button
When you click 'Create API Key', you'll then see your unique Client ID and Client Secret that you'll need for the SparkLayer API.
Important You will only see the Client Secret code once when you create your API Key so make sure to make a note of it.
Once you've created an API Key, you'll then see this listed on the page and you can begin your integration. If you require additional API keys to be created, simply follow the same process noted above.
The Integrations section lets you specify which eCommerce platform you'll be installing SparkLayer on. For listed third-party platforms, this has the added benefit of automatically connecting your website to SparkLayer.
Platform | Details |
Shopify | If choosing Shopify, you'll be prompted to enter your Shopify merchant ID. When you click "Save", you'll be taken off to Shopify to install the SparkLayer app. This will connect your Shopify store to SparkLayer and products and customer data will automatically be sent through |
BigCommerce | If choosing BigCommerce, you'll be prompted to enter your BigCommerce Store ID. When you click "Save", you'll be taken off to BigCommerce to install the SparkLayer app. This will connect your Shopify store to BigCommerce and products and customer data will automatically be sent through |
Custom | If choosing Custom, you'll need to manually send SparkLayer all necessary data. |
Setting up a test environment With SparkLayer Test Mode, you can configure a live and test environment.
You can additionally configure specific order actions for your store.
Setting | Details |
Automatically complete Shopify draft orders | If you're using manual payments (such as Payment by Invoice) these will be default enter the Shopify admin as Draft orders. This setting allows you to automatically mark these as completed and the orders will instead show in the Shopify Orders admin as soon as they are placed |
Automatically mark Shopify draft orders as paid | For new draft orders, the payment method will be set as payment pending. It's possible to automatically mark these orders as paid allowing you to process the orders faster. To enable this, first tick the 'Automatically complete Shopify draft orders' toggle, then choose from the following settings;Payment on Account orders - automatically mark as paidPayment by Invoice orders - automatically mark as paid |
The Widgets section guides you through installing the Frontend Interfaces on your website. There are the following key steps:
- Installing the Core script
- Installing the product page scripts
- Customising the Design by using CSS
You can read our full guide on how this works in our Frontend Integration Guide.
Configurations let you configure specific options for your customers when they're using the Frontend.
Learn more about configurations To see all available configurations on SparkLayer, please refer to our guide here.
Setting | Details |
Stock level display limit | If you're displaying stock levels on a product page, you can choose the maximum stock number customers see. For example, if you enter 51, on the frontend this will display as 50+ to the customer if you have more than 50 in stock. |
Apply tiered pricing across variants | If a product has variants (e.g. sizes), tiered pricing will by default be applied across all variants. You can adjust this to apply only so specific variants instead. |
Internal Purchase ID Prefix/Postfix | When a purchase is internal to SparkLayer, we use an internal ID. This is the case for purchases that are not in Shopify, e.g. orders for approval, and quotes. You can customise this ID to have a prefix and/or postfix. By default, the prefix is #P. |
To learn about how shipping works, please refer to our Shipping guide.