📍 Bolt Help / Platforms / WooCommerce / WooCommerce - Managed Checkout
WooCommerce - Managed Checkout
Learn how to integrate Bolt for WooCommerce; includes supported versions and upgrade instructions

New Dashboard Notice

Bolt has launched a new Merchant Dashboard experience. See this corresponding page for help documentation that reflects the Legacy Dashboard.

Please note that Legacy Dashboard documentation may no longer have up to date information on our newest features and releases.

Prerequisites

  • If you are migrating from a different cart platform, see the Re-platforming section.

How to Install

Step 1: Upload Plugin

  1. Log into the WordPress Admin Dashboard.
  2. Navigate to Plugins.
  3. Select Add New.
  4. Search for bolt checkout.
  5. Select Install Now.
  6. Select Activate after installation is complete.

Step 2: Configure Plugin

  1. Log into the WordPress Admin Dashboard.
  2. Navigate to Plugins > WooCommerce Bolt Checkout > Settings.
    • Enable Bolt Gateway.
    • Enable Bolt Sandbox Mode for testing; disable for production.

Step 3: Add Webhook Endpoints in Merchant Dashboard

To complete the configuration, log into the Bolt Merchant Dashboard using the login details provided by Bolt.

  1. Log into the Bolt Production Merchant Dashboard and Sandbox Merchant Dashboard.
  2. Navigate to Administration > API.
  3. Scroll to Merchant Callbacks.
    • Set the Webhook URL to: https://[store_url]/wp-json/bolt/response
    • Set the Shipping URL to: https://[store_url]/wp-json/bolt/shipping
    • Set the Tax URL to: https://[store_url]/wp-json/bolt/tax
    • Set the Create Order URL to: https://[store_url]/wp-json/bolt/create-order

Approve Bolt IPs

Ensure the IPs provided by Bolt are approved to allow access to the endpoints above.

Step 4: Enable Single Sign-On (Optional)

If you want customers to be able to use SSO to login to their store account, follow the steps below.

  1. Contact your Bolt Account Manager to enable SSO for your store.
  2. In the Wordpress Dashboard navigate to Pages > My Account and add the Shortcode component to the page with the shortcode [bc_login]
  3. The shortcode populates the Bolt login link on your store.

woo link 4. When a user clicks the link, the Bolt login modal appears.

Product Variants

Fraud Only

If you are using Bolt’s Fraud-Only offering, complete the following steps in addition to those previously listed:

  1. Log into the Bolt Merchant Dashboard.
  2. Navigate to Administration > API > API Keys.
  3. Copy all of the following keys:
    • API Key
    • Publishable Key - Payment Only. The publishable key is a long string of lower and upper case letters and numbers that consists of three sections. publishable key
    • Signing Secret
  4. Open a separate browser tab.
  5. Log into the store admin.
  6. Navigate to Plugins > WooCommerce Bolt Checkout > Settings.
  7. Insert your Bolt key credentials for all of the following:
    • API key
    • Publishable Key - Payment Only
    • Signing Secret
  8. Scroll to the Where to add Bolt? section.
  9. Enable all of the following:
    • Native Checkout Page
    • Pay for Order
  10. Deselect all of the other options.
  11. Ensure there is no CSS in the Additional CSS section. (In particular, any styling that might prevent the original checkout button from displaying.)

Review Order Statuses & Platform Operations

You can review WooCommerce order statuses and platform operations in our Platform Operations guide.

Extensions

Most customizations should only be made from the plugin settings page. For special use cases with unique requirements, the Bolt Integrations team can provide a custom zip file to the merchant containing added functionality. This section details how to install the merchant-specific Bolt Extensions.

Step 1: Upload Extension

  1. Log into the WordPress Admin Dashboard.
  2. Navigate to Plugins.
  3. Select Add New.
  4. Search for WooCommerce Bolt Checkout Extensions - Merchant Name.
  5. Select Install Now.
  6. Select Activate after installation is complete.

Step 2: Verify Extension is Active

  1. Navigate to Plugins.
  2. Verify that the extension plugin appears and is activated.

Update Bolt Plugin

Each plugin in WooCommerce is located in a separate directory inside wp-content/plugins/

  1. Delete the old extension plugin.
  2. Install the new extension plugin.
  3. Activate the new extension plugin.

See WooCommerce’s official documentation for more information.

TIP

If you are upgrading your version of the Bolt plugin and have the Bolt Extension plugin installed as well, be sure to update both plugins. Failing to upgrade Bolt Extension plugin could break some functionality of the primary Bolt plugin.

Supported WooCommerce Versions

Bolt Plugin Version Release Date Supported Until Platform Versions
2.20.0 01/04/2024 01/04/2025 WooCommerce 3.7 & Above
2.19.0 11/29/2023 11/29/2024 WooCommerce 3.7 & Above
2.18.0 02/02/2023 02/02/2024 WooCommerce 3.7 & Above
2.17.0 11/4/2022 11/04/2023 WooCommerce 3.7 & Above
2.16.0 7/25/2022 07/25/2023 WooCommerce 3.7 & Above
2.15.0 03/14/2022 03/14/2023 WooCommerce 3.7 & Above
2.14.1 04/21/2021 04/21/2022 WooCommerce 3.7 & Above
2.14.0 03/04/2021 03/04/2022 WooCommerce 3.7 & Above
2.13.1 10/13/2020 10/13/2020 WooCommerce 3.7 & Above
2.13.0 09/29/2020 09/29/2021 WooCommerce 3.7 & Above
2.12.0 08/19/2020 08/19/2021 WooCommerce 3.7 & Above
2.11.0 07/09/2020 07/09/20201 WooCommerce 3.7 & Above
2.10.0 06/17/2020 06/17/2021 WooCommerce 3.7 & Above
2.9.0 05/27/2020 05/27/2021 WooCommerce 3.7 & Above
2.8.0 05/12/2020 05/12/2021 WooCommerce 3.7 & Above
2.7.1 04/22/2020 04/22/2021 WooCommerce 3.7 & Above
2.7.0 04/15/2020 04/15/2021 WooCommerce 3.7 & Above
2.6.0 03/24/2020 03/24/2021 WooCommerce 3.7 & Above
2.5.0 03/03/2020 03/03/2021 WooCommerce 3.7 & Above
2.4.0 02/04/2020 02/04/2021 WooCommerce 3.7 & Above
2.2.0 01/09/2020 01/09/2021 WooCommerce 3.7 & Above
2.1.0 12/15/2019 12/15/2020 WooCommerce 3.7 & Above
2.1.1 11/21/2019 11/21/2020 WooCommerce 3.7 & Above
2.0.11 11/21/2019 11/21/2020 WooCommerce 3.7 & Above
2.0.10 09/13/2019 09/13/2020 WooCommerce 3.7 & Above
2.0.5 09/03/2019 09/03/2020 WooCommerce 3.7 & Above
2.0.2 06/27/2019 06/27/2020 WooCommerce 3.7 & Above

Disable Bolt Plugin

  1. Log into WordPress as an Admin.
  2. Navigate to Installed Plugins.
  3. Scroll to the Bolt Plugin.
  4. Select Deactivate.

Uninstall Bolt Plugin

  1. Log into WordPress as an Admin.
  2. Navigate to Installed Plugins.
  3. Scroll to the Bolt Plugin.
  4. Select Deactivate. The delete button populates.
  5. Select Delete and confirm.
  6. Repeat this process for all Bolt Extension Plugins to ensure all Bolt elements are removed.

Re-platforming

When re-platforming, you must keep in mind all of the following:

  • Use the Merchant Dashboard for order refunds. Do not use a platform-specific backoffice flow that’s connected to a deprecated account division.
  • Disable all of your old webhooks for the deprecated account division.
Filter by Section
Filter by Topic