Tickets - Login

Set Up Bolt for Magento 1

Prerequisites

  • Your production Magento server needs to be on HTTPS with a valid certificate
  • Self-signed certificates are not allowed
  • You should have a Sandbox Bolt Merchant Dashboard where you can access API keys for testing.
  • If you have security settings or DDoS protection against bots, please add the domain of our User-Agent to the Auto-Approve List: Bolt - https://www.bolt.com

How to Install

1. Upload Plugin

  1. Download the Bolt Magento plugin.
  2. Navigate to the top-level of your Magento Store installation.
  3. Copy and paste the contents of the Bolt Magento plugin files.
  • If you are upgrading, you can simply paste the content of the zip file in the top-level directory, overwriting the older version.

2. Clear Magento Cache

Magento cache must be cleared for the server to pick up the new plugin.

  1. Navigate to Admin console > System > Cache Management.
  2. Select Flush Cache.

3. Configure Plugin

Configure the Magento Admin with your API keys found in the Bolt Merchant Dashboard.

  1. Navigate to System > Configuration > Payment Methods.
  2. Locate the Bolt Pay tab.
  3. Insert your Bolt API Keys and Signing Secret.
  4. If Bolt is your only payment option, select Yes for the Skip Payment Method Step.

API Credentials

The following values can be found in the Bolt Merchant Dashboard by navigating to Developer > API > Keys. You must set up at least one publishable key.

Key Description Required?
API Key Calls Bolt API from your back-end server Yes
Signing Secret Verifies signature by checking the authenticity of webhook requests Yes
Publishable Key - Multi-Step Opens the Bolt Payment Popup typically on Shopping cart and product pages No
Publishable Key - Payment Only Opens the Bolt Payment Popup typically on checkout pages No
Publishable Key - Back-office Used in the back office of Magento for manually-created orders. No

Each Publishable Key type requires a separate division is set up for your account.

Environments

4. Add Webhook Endpoints in Merchant Dashboard

  1. Login to 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]/boltpay/api/hook
    • Set the Shipping and Tax URL to: https://[store_url]/boltpay/shipping
    • Set the Create Order URL to: https://[store_url]/boltpay/api/create_order

5. Enable Bolt

This step activates Bolt and display Bolt Checkout in your store to begin accepting payments.

  1. Navigate to Admin console > System > Payment Methods > Bolt Pay.
  2. Select the Enable Bolt Pay option.

Your Bolt Payment Plugin is now installed and configured.

Review Order Statuses & Platform Operations

You can review Magento 1 order statuses and platform operations in our Platform Operations guide.

Update Bolt Plugin

To update the Bolt Plugin you must simply overwrite the old files with the new.

  1. Download & unzip the new version of the Bolt Plugin.
  2. Open a terminal and navigate to your Magento 1 root folder.
  3. Run cp -rf your-bolt-plugin-version/* your-magento-root/
  4. Clean or flush the cache.
  5. Log out and then back into Admin.
  6. Ensure the plugin has been updated.

Supported Versions

Bolt Plugin Version Release Date Supported Until Open Source (CE) Commerce (EE)
2.9.0 09/02/2020 02/28/2021 1.9 & Above 1.12 & Above
2.8.0 06/08/2020 02/28/2021 1.9 & Above 1.12 & Above
2.7.0 05/12/2020 02/28/2021 1.9 & Above 1.12 & Above
2.6.0 04/24/2020 02/28/2021 1.9 & Above 1.12 & Above
2.5.0 04/10/2020 02/28/2021 1.9 & Above 1.12 & Above
2.4.1 03/20/2020 02/28/2021 1.9 & Above 1.12 & Above
2.4.0 03/20/2020 02/28/2021 1.9 & Above 1.12 & Above
2.3.0 02/25/2020 02/28/2021 1.9 & Above 1.12 & Above
2.2.0 02/03/2020 02/28/2021 1.9 & Above 1.12 & Above
2.1.0 09/21/2019 02/28/2021 1.9 & Above 1.12 & Above
2.0.3 10/28/2019 02/28/2021 1.9 & Above 1.12 & Above
2.0.2 10/08/2019 02/28/2021 1.9 & Above 1.12 & Above
2.0.1 06/27/2019 02/28/2021 1.9 & Above 1.12 & Above
2.0.0 06/12/2019 02/28/2021 1.9 & Above 1.12 & Above
1.4.1 06/27/2019 02/28/2021 1.9 & Above 1.12 & Above

Disable Bolt Plugin

If at any point the plugin setup does not work within your environment and you wish to completely disable it in order to troubleshoot, do the following:

  1. Navigate to Admin > System > Configure > Advanced > Disable Modules Output > Bolt_Boltpay.
  2. Select Disable.

Uninstall Bolt Plugin

To uninstall, you must first delete all Bolt files and then flush the Magento cache.

  1. Find and delete all of the following from your Magento root:
  • app/code/community/Bolt
  • app/design/adminhtml/default/default/layout/boltpay.xml
  • app/design/adminhtml/default/default/template/boltpay
  • app/design/frontend/base/default/layout/boltpay.xml
  • app/design/frontend/base/default/template/boltpay
  • app/etc/modules/Bolt_Boltpay.xml
  • js/boltpay
  • lib/Boltpay
  • skin/adminhtml/base/default/boltpay
  • skin/frontend/base/default/boltpay
  • skin/frontend/base/default/css/boltpay
  1. Navigate to System > Cache Management.
  2. Select Flush Cache Storage.
  3. Delete everything from the var/cache/ directory.
  4. Reload your website in your browser.

Related Articles

Bolt.com | Support | Submit a Ticket
© Bolt Financial, Inc. Privacy Policy | Terms