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.

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

Supported WooCommerce Versions

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.