Articles in this section

See more

BigCommerce Integration

  • Updated

How to Install

You must have an approved Bolt account to begin the installation. If you do not have an account, sign up for your free account.

1. Add a Bolt User to BigCommerce

  1. Log in to BigCommerce.
  2. Navigate to Settings or Account Settings > Users.
  3. Select Create a User Account.
  4. Add dev@bolt.com as a user by completing the following fields:
    • Email: dev@bolt.com
    • Status: Active
    • User Role: Sales Manager
    • System Admin Permissions: (enable the following)
      • Manage Settings
      • Manage Payments
      • Store Design
      • Design Mode
      • Store Logs
    • Enable WebDav: Yes
  5. Save.

BigCommerce automatically sends dev@bolt.me an email to activate the login.

2. Install Plugin

  1. Navigate to Bolt’s page in the BigCommerce eCommerce Apps Marketplace.
  2. Select Get This App.
  3. Select Install > Confirm.

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.

3. Add Webhook Endpoints in Merchant Dashboard

  1. Login to the Bolt Production Merchant Dashboard and Sandbox Merchant Dashboard.
  2. Navigate to Developer > Webhooks
  3. Scroll to Webook Endpoints.
    • Verify the Webhook URL has populated automatically.
    • Set the Shipping and Tax URL to: insert url here

Leave this tab open to refer back to in part 4. 

4. Add Bolt as Payment Method 

  1. In your browser tab from part 3, navigate to Developer > API > Keys. 
  2. Copy the following keys:
    • API Key
    • Signing Secret
    • Publishable Key
  3. In a new tab, Log in to BigCommerce.
  4. Navigate to Store Setup > Payments.
  5. Scroll to Online Payment Methods > Bolt.  
  6. Select Setup. 
  7. Paste your keys into the required fields.
  8. Save.

Your Bolt Payment plugin is now installed and configured. You can optionally enable Test Mode for sandbox or staging tests. 

Install the Bolt Sandbox App

The Bolt sandbox app is different than Bolt production app. It is not displayed in BigCommerce’s eCommerce App Marketplace and requires a direct link.

  1. Log in to your BigCommerce Admin Console.
  2. Copy and Edit the following URL: https://{your_store_url}/manage/marketplace/apps/22164
  3. Paste the URL in your browser to navigate to the Bolt Sandbox App.
  4. Select Get This App.
  5. Select Install > Confirm.

Production vs Sandbox Scripts

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

Production Script

<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">

Sandbox Script

<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>

 

Apple Pay 

The following steps apply only to those using Bolt’s native BigCommerce integration (released December 2020).

  1. Log into BigCommerce.
  2. Navigate to Store Setup > Payment Methods > Digital Wallets.
  3. Choose Apple Pay.
  4. Select Set up.
  5. Save.

If you previously provided Apple Pay for your shoppers using a different processor, you may have to disable that payment method first before activating Apple Pay with Bolt.