📍 Bolt Help / Platforms / Adobe Commerce / Adobe Commerce - Managed Checkout / Set Up Bolt for Adobe Commerce Set Up Bolt for Adobe Commerce Learn how to integrate Bolt for Adobe (Magento) Commerce; includes supported versions and upgrade instructions. Page Contents Click to expand. Before You Start If you are migrating from a different cart platform, see the Re-platforming section. See the table below to ensure compatibility between Bolt and your version of Magento. Supported Versions Click to expand. Bolt Plugin Version Release Date Supported Until Open Source (CE) Commerce (EE) 2.27.0 03/30/2023 03/30/2024 ≥ 2.3 ≥ 2.3 2.26.3 11/21/2022 11/21/2023 ≥ 2.3 ≥ 2.3 2.26.2 11/03/2022 11/03/2023 ≥ 2.3 ≥ 2.3 2.26.1 08/22/2022 08/16/2022 ≥ 2.3 ≥ 2.3 2.25.2 02/25/2022 02/25/2023 ≥ 2.3 ≥ 2.3 (Legacy) 2.25.1 02/16/2022 02/16/2023 ≥ 2.3 ≥ 2.3 (Legacy) 2.25.0 01/31/2022 01/31/2023 ≥ 2.3 ≥ 2.3 2.24.1 11/02/2021 11/02/2022 ≥ 2.3 ≥ 2.3 2.24.0 10/20/2021 11/02/2021 ≥ 2.3 ≥ 2.3 2.23.0 09/02/2021 11/02/2021 ≥ 2.3 ≥ 2.3 2.21.2 05/12/2021 05/12/2022 ≥ 2.3 ≥ 2.3 2.21.0 04/08/2021 04/08/2022 ≥ 2.3 ≥ 2.3 2.20.0 03/04/2021 03/04/2022 ≥ 2.3 ≥ 2.3 2.19.0 02/10/2021 02/10/2022 ≥ 2.3 ≥ 2.3 2.18.0 01/07/2021 01/07/2022 ≥ 2.3 ≥ 2.3 2.17.0 11/03/2020 11/03/2021 ≥ 2.3 ≥ 2.3 2.16.0 10/19/2020 10/19/2021 ≥ 2.3 ≥ 2.3 2.15.0 10/05/2020 10/05/2021 ≥ 2.3 ≥ 2.3 2.14.0 09/15/2020 09/15/2021 ≥ 2.3 ≥ 2.3 2.13.0 08/26/2020 08/26/2021 ≥ 2.3 ≥ 2.3 2.12.0 08/11/2020 08/11/2021 ≥ 2.3 ≥ 2.3 2.11.0 07/29/2020 07/29/2021 ≥ 2.3 ≥ 2.3 2.10.0 07/20/2020 07/20/2021 ≥ 2.3 ≥ 2.3 2.9.0 06/24/2020 06/24/2021 ≥ 2.3 ≥ 2.3 2.8.1 06/17/2020 06/17/2021 2.2 & Above 2.2 & Above 2.8.0 06/04/2020 06/04/2021 2.2 & Above 2.2 & Above 2.7.0 05/12/2020 05/12/2021 2.2 & Above 2.2 & Above 2.6.0 04/24/2020 04/24/2021 2.2 & Above 2.2 & Above 2.5.0 04/10/2020 04/10/2021 2.2 & Above 2.2 & Above 2.4.1 03/20/2020 03/20/2021 2.2 & Above 2.2 & Above 2.4.0 03/20/2020 03/20/2021 2.2 & Above 2.2 & Above 2.3.0 02/25/2020 02/25/2021 2.2 & Above 2.2 & Above 2.2.0 02/03/2020 02/03/2021 2.2 & Above 2.2 & Above 2.1.0 09/21/2019 09/21/2020 2.2 & Above 2.2 & Above 2.0.2 10/08/2019 10/08/2020 2.2 & Above 2.2 & Above 2.0.1 09/06/2019 09/06/2020 2.2 & Above 2.2 & Above How to Install The location of the Magento 2 root folder depends on where you originally installed Magento and is also driven by your webhosting company. If you navigate to your Magento 2 root, you’ll see the following folders: app bin dev lib pub var vendor Step 1: Upload Plugin Open command prompt, go to <MAGENTO_ROOT> folder and run the following commands: $ composer require boltpay/bolt-magento2 $ php bin/magento setup:upgrade $ php bin/magento setup:di:compile $ php bin/magento setup:static-content:deploy $ php bin/magento cache:clean $ php bin/magento cache:flush Step 2: Configure Plugin Login to the store admin panel. Navigate to Stores > Configuration > Sales > Payment Methods > Bolt Pay. Set the Enabled dropdown to Yes. Enter an appropriate Title such as Credit & Debit Cards. Send Magento 2 API Keys to Bolt. Go to Advanced Options, then click Create and send API keys to Bolt. This will send your M2 API credentials directly to Bolt to establish an OAuth connection. Why do I need to send my Magento 2 API keys to Bolt? Click to expand. You must provide your Magento 2 API keys to enable an OAuth connection between your M2 account and Bolt. Bolt stores these tokens to make API calls to the M2 platform and is used for authenticating requests made to Magento 2 from Bolt. Bolt 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 Additional Settings Sandbox Mode: Setting up testing vs. production execution environment YES: Accepts test cards when placing an order NO: Requires real credit cards to place an order Replace Button Selectors: A comma-separated list of CSS selectors matching the elements to be replaced with Bolt Checkout buttons or Bolt checkout buttons placed alongside them: no suffix (default): inserts Bolt button in place of the element and removes the element append suffix: Inserts Bolt button right after the element (example-selector|append) prepend suffix: Inserts Bolt button right before the element (example-selector|prepend) Your Bolt Payment Plugin is now installed and configured. Optional Configuration Fraud Only If you are using Bolt’s Fraud-Only offering, complete the following steps in addition to those previously listed: Log into the store admin. Navigate to Store > Configuration > Sales > Payment Methods > Bolt Pay. Insert your Bolt key credentials for all of the following: API key Signing Secret Publishable Key - Payment Only Scroll to the Where to add Bolt? section. Enable all of the following: Native Checkout Page Uncheck all of the other options. Ensure there is no CSS in the Global CSS section. (In particular, any styling that might prevent the original checkout button from displaying.) Embeddable Account Editing Enable account editing components on your site using our component setup guides. Review Order Statuses & Platform Operations You can review Magento Commerce order statuses and platform operations in our Platform Operations guide. Update Plugin Use the following script with Composer to upgrade to the latest Bolt M2 Plugin Version. composer upgrade boltpay/bolt-magento2 php bin/magento setup:upgrade php bin/magento setup:di:compile php bin/magento setup:static-content:deploy php bin/magento cache:clean php bin/magento cache:flush To upgrade to a specific Bolt M2 Plugin Version, please replace the first command with: composer require boltpay/bolt-magento2:version Check Version See Magento Commerce’s documentation for more information. 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.