📍 Bolt Help / Core Products / Managed Checkout / Set Up Bolt for WooCommerce

Set Up Bolt for WooCommerce

Bolt has launched a new Merchant Dashboard experience, which is currently in Beta. See this page for help documentation that reflects the new dashboard.


Prerequisites

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

How to Install

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.

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.

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 Developer > Webhooks.
  3. Scroll to Webhook Endpoints.
    • 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.

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

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.

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.

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.17.0 11/4/2022 11/4/2023 WooCommerce 3.7 & Above
2.16.0 7/25/2022 7/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.

Add Delivery Fee at Checkout

Beginning July 1st, 2022, the state of Colorado introduced a mandatory shipping fee on the delivery of goods shipping to a Colorado address. Follow the steps below if you would like to add the $0.27 fee to shipping.

  1. In the WordPress Admin dashboard, navigate to WooCommerce > Settings > Shipping > Shipping Zones and select Add Shipping Zone.
  2. Enter a descriptive Zone Name, and select Colorado in Zone Regions that apply.
  3. Select which Shipping Methods should be available to this zone. For the native shipping method for WooCommerce, add $0.27 to the total cost. For third-party plugin shipping methods (e.g., WooCommerce FedEx Shipping), use the Price Adjustment $ column to add a flat fee to the shipping quote or add handling fees to each method.
  4. Shipping zones are applied in the order they appear. The zones at the top will take precedence over the ones below. To ensure the tax is applied to Colorado shoppers, drag it to the top of the Shipping Zones list.

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.
📖On This Page
Filter by Section
Filter by Topic