The first step required to add Bolt to BigCommerce is to add Bolt to your BigCommerce dashboard.

Note — If you a sandbox or test store, you should use Bolt sandbox account.

Adding Bolt user to your dashboard

1. Go to User Settings. Depending upon your version of BigCommerce this may be under:
   1. Settings | Users
   2. Account Settings | Users
   3. Click Create a User Account
   4. Add dev@bolt.com as a user
      • Under Email, type indev@bolt.com.
      • Under Status, selectActive.
      • UnderUser Role, selectSales Manager.
      • UnderSystem Admin Permissionsturn on these permissions:
        • Manage Settings
        • Manage Payments
        • Store Design
        • Design Mode
        • Store Logs
      • Under Enable WebDav, check Yes.
   5. Click Save on the bottom right. BigCommerce will automatically send dev@bolt.me an email to activate the login.

Install Bolt App

1. Go to marketplace and install Bolt app
   The URL to marketplace is https://{your_store_domain}/manage/marketplace/apps/13488
   
   • If the URL does not work or get you to the install page, you can also navigate there manually: Apps > Marketplace  click on the BIGCOMMERCE.COM/APPS button > This will open a new tab
2. Search 'Bolt' in the search bar and click on Bolt app banner
3. Click the GET THIS APP button. This should take you to the install page. (It might prompt you to log in to BigCommerce account again)
4. Click Install and then the Confirm button to initiate your installation.
5. When the install succeeds, you will see a success screen as follows.

If the installation fails, please let Bolt know immediately. It's usually a configuration tweak on Bolt's end. Bolt will make sure your store profile is set up properly. 

Bolt Merchant Dashboard Configuration

To complete the configuration, log in to theBolt Merchant Dashboard using the login details provided by Bolt.

Configure using these steps:

1. Navigate to Settings and select Keys and URLs.
2. Scroll down to the URL Configurations section
3. Verify that the Webhook and Shipping and Tax URLs are set. For BigCommerce the Webhook URL is auto-populated when Bolt plugin is installed, but the Shipping and Tax URL must be filled manually.

Installing the Bolt Sandbox App

Note — The Bolt sandbox app is different than Bolt production app.

1. Go to the BigCommerce App marketplace and search for 'Bolt Sandbox'. You may not see Bolt sandbox app in the search result, but you should see the Bolt app. If you do see the Bolt sandbox app, please proceed to install and skip through to step 4.
   Otherwise, click on the Bolt App and then click Get This App and then go to the app install page. Don't click on install yet!.
   • If the search result showing only 'Bolt' app, and no 'Bolt Sandbox' app.
2. When you are on the install page as in the image below
   
3. Click on browser URL and change the app ID from 13488 to 22164 and hit enter.
   
   • Before:https://{your_store_url}/manage/marketplace/apps/**13488**
     
   • After:https://{your_store_url}/manage/marketplace/apps/**22164**
     
     Now you should see Bolt sandbox app.
     You can now proceed to install Bolt sandbox App

4. Once the install is complete and successful, you should see something like this:

If you see 'Bolt could not be installed' message, it is likely because there's a misconfiguration in your store settings, please let us know and we will fix it on our end.

Scripts

The only differences are to use the sandbox URL for Bolt's connect script embedded on the site and the sandbox publishable key.

Instead of this (on production):

  <script
  id="bolt-connect"
  type="text/javascript"
  src="https://connect.bolt.com/connect-bigcommerce.js"<
  data-publishable-key="{PUBLISHABLE_KEY}"
  data-shopping-cart-id="BigCommerce">

Use this:

  <script
  id="bolt-connect"
  type="text/javascript"
  src="https://connect-sandbox.bolt.com/connect-bigcommerce.js"
  data-publishable-key="{SANDBOX_PUBLISHABLE_KEY}"
  data-shopping-cart-id="BigCommerce">
  </script>