Set up Bolt on Solidus

Add Bolt to a Solidus store to connect existing storefront accounts with Bolt for a one-click, passwordless login flow. This integration uses Bolt SSO Commerce.

Solidus SSO Commerce is in limited release and available to a select number of Bolt merchants. Confirm availability with Bolt before you start.

Platform support

This guide is for Solidus. Other platforms and custom web apps have their own quickstarts.

Commerce Platforms

Custom app Shopify BigCommerce Adobe Commerce Salesforce WooCommerce Volusion

Prerequisites

Bolt merchant account
A Solidus store
Command line and Ruby familiarity

Install the plugin

Add the required gems to your Gemfile:

Ruby

gem 'multi_json', '~> 1.11', '>= 1.11.2'
gem 'solidus_auth_devise'

Set your environment in your local ENV file (sandbox for testing, production for a live store), then run bundle install:

Terminal

export BOLT_ENVIRONMENT=sandbox

Add and install the Bolt gem:

Terminal

bundle add solidus_bolt
bin/rails generate solidus_bolt:install

Expected result: a Bolt section appears in your Solidus store dashboard.

Create your Bolt account

In the Solidus dashboard, open the Bolt section.
Create a Production or Sandbox merchant account and fill in your store information.
Enter the one-time code Bolt emails you to verify the account.

Connect a payment method and webhooks

In the Bolt section, link your payment processor and copy each credential into Solidus Dashboard > Bolt > Edit.
Under Settings > Payments, add a New Payment Method of type Bolt. Name it Bolt Payments, leave Auto Capture on Use App Default (No), and check Available to Users, Available to Admin and Active.
Once the method exists, set its Preference Source to bolt_config_credentials and click Update.
In the Bolt section, select Configure Webhooks and enter https://[store_url]/webhooks/bolt, the endpoint the gem provides.

Expected result: Bolt is available as a payment method and receives webhook updates.

Production checklist

Set BOLT_ENVIRONMENT=production
Switch to production API keys and dashboard
Live processor credentials linked in the Bolt section

Troubleshooting

Bolt section missing: confirm bin/rails generate solidus_bolt:install completed without errors.
Payments not processing: verify Preference Source is set to bolt_config_credentials.