Set Up
Learn how to integrate Bolt with your Solidus store.
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
- Add the following configuration commands to your
Gemfile
gem 'multi_json', '~> 1.11', '>= 1.11.2'
gem solidus_auth_devise
- 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
.
- Run
bundle add solidus_bolt
thenbin/rails generate solidus_bolt:install
to add Bolt to Solidus.
Setup Bolt Account
- Navigate to your Solidus Store’s Dashboard and login using your store credentials.
- In the left-hand navigation, click the new Bolt section.
- At the top of the screen, select either Create a Production or Sandbox Merchant Account with Bolt depending on your use case.
- Fill out your store information, and click Create an Account.
- 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.
- Click the Link button to link the payment method you have chosen to use with Bolt.
- On the next screen titled Connect to Solidus, click Copy next to each credential.
- Navigate to the Solidus Dashboard > Bolt select your Bolt instance and click Edit.
- Paste in your API credentials.
Update Settings
You will need to activate Bolt as a payment method in your Solidus store.
- Navigate to Settings > Payments.
- Click New Payment Method.
- In the Type dropdown menu, select Bolt.
- Name it Bolt Payments so you will know this method belongs to your Bolt instance.
- Below Auto Capture ensure Use App Default (No) is selected.
- Ensure Available to Users, Available to Admin, and Active are checked.
- Click Create
- Once the method has been created, change Preference Source to
bolt_config_credentials
and click Update.
Setup Webhooks
- Navigate to Bolt in the left-hand navigation and click Configure Webhooks
- Enter the URL where you’d like to receive webhook updates.
Resources
- View the open-source code for the Bolt-Solidus plugin in Github.
- Visit Solidus' documentation for information on developing your store.