---

Bolt has launched a new Merchant Dashboard experience. See this page for help documentation that reflects the previous dashboard.

---

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
• If you are migrating from a different cart platform, see the Re-platforming section.

How to Install

Step 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 paste the content of the zip file in the top-level directory, overwriting the older version.

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

Step 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 Administration > API > API Keys. Scroll to Identifiers and set up at least one Publishable Key. The publishable key is a long string of lower and upper case letters and numbers that consists of three sections.

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

• Production
• Sandbox
• Staging

Step 4: Add Webhook Endpoints in Merchant Dashboard

1. Login to 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]/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

Step 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 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

2. Navigate to System > Cache Management.
3. Select Flush Cache Storage.
4. Delete everything from the var/cache/ directory.
5. Reload your website in your browser.

---

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.