📍 Bolt Help / Platforms / Solidus - SSO Commerce
Solidus - SSO Commerce
Learn how to integrate, configure, and update Bolt for Solidus.

Solidus SSO Commerce is in Limited Release and only available to a select number of Bolt merchants at this time.

Solidus is a highly flexible, extensible, open-source ecommerce platform developed as a gem for use within a Ruby on Rails application. It is free to download and use. With Solidus you can collect payments, manage product inventory and ship orders like any other ecommerce platform.

Bolt’s Embedded SSO Commerce integration with Solidus connects existing storefront customer accounts with a Bolt account, allowing shoppers to quickly check out using a one-click, passwordless login flow. This simplified account creation process makes checkout easy for customers and leads to more account creation for merchants.

Before You Start

This article assumes you have the following:

  • Familiarity with the command line and the Ruby programming language.
  • A Solidus store.

Install Bolt Plugin for Solidus

  1. Add the following configuration commands to your Gemfile gem 'multi_json', '~> 1.11', '>= 1.11.2' gem solidus_auth_devise
  2. Add your API keys as environment variables to your local ENV file by opening terminal and running the following:
export BOLT_ENVIRONMENT=sandbox  # {{production}} for use in a live store

…Then run bundle install.

  1. Run bundle add solidus_bolt then bin/rails generate solidus_bolt:install to add Bolt to Solidus.

Setup Bolt Account

  1. Navigate to your Solidus Store’s Dashboard and login using your store credentials.
  2. In the left-hand navigation, click the new Bolt section.
  3. At the top of the screen, select either Create a Production or Sandbox Merchant Account with Bolt depending on your use case.
  4. Fill out your store information, and click Create an Account.
  5. You will receive a One-Time Code from Bolt via email. Copy the code and paste it in the next screen.

Setup Payment Method

Once you’ve successfully created a Bolt account, you will be able to connect a payment processor.

  1. Click the Link button to link the payment method you have chosen to use with Bolt.


Click to expand.

  1. On the next screen titled Connect to Solidus, click Copy next to each credential.
  2. Navigate to the Solidus Dashboard > Bolt select your Bolt instance and click Edit.
  3. Paste in your API credentials.

Update Settings

solidus dash

You will need to activate Bolt as a payment method in your Solidus store.

  1. Navigate to Settings > Payments.
  2. Click New Payment Method.
  3. In the Type dropdown menu, select Bolt.
  4. Name it Bolt Payments so you will know this method belongs to your Bolt instance.
  5. Below Auto Capture ensure Use App Default (No) is selected.
  6. Ensure Available to Users, Available to Admin, and Active are checked.
  7. Click Create
  8. Once the method has been created, change Preference Source to bolt_config_credentials and click Update.

Setup Webhooks

  1. Navigate to Bolt in the left-hand navigation and click Configure Webhooks
  2. Enter the URL where you’d like to receive webhook updates.


Filter by Section
Filter by Topic