# boltpay/bolt-magento2

> Bolt payment gateway integration

`composer require boltpay/bolt-magento2`

Canonical URL: https://packagento.com/boltpay/bolt-magento2

## At a glance

- **Vendor**: boltpay (https://packagento.com/boltpay.md)
- **Latest version**: 2.27.9-rc3 — released 2026-05-22
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/boltpay/bolt-magento2 and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require boltpay/bolt-magento2:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Bolt payment gateway integration

## README

[![Latest Stable Version](https://poser.pugx.org/boltpay/bolt-magento2/v/stable.png)](https://packagist.org/packages/boltpay/bolt-magento2)
[![Build Status](https://circleci.com/gh/BoltApp/bolt-magento2.svg?style=shield)](https://circleci.com/gh/BoltApp/bolt-magento2)

#### 1. Requirements

+ **Magento 2.3.0 or greater**
+ **Composer PHP Dependency Manager**

#### 2. Plugin installation

+ 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
```

#### 3. Plugin configuration

Login to the store admin panel.
Navigate to `Stores` > `Configuration` > `Sales` > `Payment Methods` > `Bolt Pay`.
The essential settings are described below.

+ `Enabled` dropdown enables / disables the Bolt Payment method.
Select ***Yes*** to enable it.
+ Enter an appropriate `Title` such as ***Credit & Debit Cards***

> #### API credentials
> The following three required values, (i.e. `API Key`, `Signing Secret`, `Publishable Key`) can be found in your ***Bolt Merchant Dashboard***  under `Developers` > `API`
> The Publishable Key is for the multi-step checkout by default. You can find other publishable keys (Payment Only and Back-Office) in the division dropdown at the top-right corner.

> For production, these will be found at:
> https://merchant.bolt.com
>
> For sandbox mode, use the following URL:
> https://merchant-sandbox.bolt.com"


+ **API Key**
used for calling Bolt API from your back-end server
+ **Signing Secret**
used for signature verification in checking the authenticity of webhook requests
+ **Publishable Key - Multi Step**
used to open the Bolt Payment Popup typically on Shopping cart and product pages
+ **Publishable Key - Payment Only**
used to open the Bolt Payment Popup typically on checkout pages
+ **Publishable Key - Back Office**
used to open the Bolt Payment Popup typically on the admin order creation page 
+ **Sandbox Mode**
setting up testing vs. production execution environment
+ **Replace Button Selectors**
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` - the default, inserts the Bolt button in place of the element and removes the element
>>
>> `|append` suffix - *example-selector|append*, inserts Bolt button right after the element
>>
>> `|prepend` suffix - *example-selector|prepend*, inserts Bolt button right before the element
#### 4. Bolt Merchant Dashboard configuration
> #### Login to the Bolt Merchant Dashboard
> **Production**: https://merchant.bolt.com
>
> **Sandbox**: https://merchant-sandbox.bolt.com"

+ Navigate to `Developers`
+ Click on the `API` tab
+ Scroll down to the `Merchant API` section
+ Set **Webhook** URL to: `[store_url]/rest/V1/bolt/boltpay/order/manage`
+ Set **Shipping and Tax** URL to: `[store_url]/rest/V1/bolt/boltpay/shipping/methods`
+ Set **Create Order** URL to: `[store_url]/rest/V1/bolt/boltpay/order/create`

## Success!
Your Bolt Payment Plugin is now installed and configured.

## Changelog

### [v1.0.4] 2018-06-19
### [v1.0.5] 2018-08-21
### [v1.0.6] 2018-08-23
### [v1.0.7] 2018-09-07
### [v1.0.8] 2018-09-16
### [v1.0.9] 2018-09-19
### [v1.0.10] 2018-09-23
### [v1.0.11] 2018-10-01
### [v1.0.12] 2018-10-10
### [v1.1.0] 2018-10-11
### [v1.1.1] 2018-10-23
### [v1.1.2] 2018-10-30
### [v1.1.3] 2018-11-27
### [v1.1.4] 2018-12-04
### [v1.1.5](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.5) 2018-12-11
 - Use circleCI instead of TravisCI
 - Prevent order ceation API call with an empty cart
 - Complete order stays in payment review state on a long hook delay fix
 - Invalid capture amount failed hook fix
### [v1.1.6](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.6) 2018-12-13
 - Force approve/reject failed hook fix
### [v1.1.7](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.7) 2018-12-21
 - Amasty Gift Card support
 - No status after unhold fix
### [v1.1.8](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.8) 2019-01-09
 - Check if order payment method is 'boltpay'
 - Add currency_code field to cart currency data
 - Dispatch sales_quote_save_after event for active (parent) quotes only
 - Fixed consistency for Amasty Gift Card module
### [v1.1.9](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.9) 2019-01-24
 - Allow empty emails in shipping_and_tax API
 - Add feature to optionally not inject JS on non-checkout pages
 - Sent store order notifications to email collected from Bolt checkout
 - Create order from parent quote
 - Do not cache empty shipping options array
### [v1.1.10](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.10) 2019-02-11
 - Add support for item properties
 - Tax mismatch adjustment
 - Unirgy_Giftcert plugin support
 - Remove active quote restriction on order creation (backend order fix)
 - Reserve Order ID for the child quote, defer setting parent quote order ID until just before quote to order submission
### [v1.1.11](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.11) 2019-03-07
 - Backoffice hook no pending fix
 - Checkout initialization fix
 - Restrict plugin availability in regards to client IP address (white list)
 - Shipping and tax cart validation update - support for multiple items with the same SKU
 - Email field mandatory for back-office orders
 - Prevent setting empty hint prefill field
 - Cart data currency error fix
 - Back office order creation fix
 - Create invoice for zero amount order
 - Exclude empty address fields from save when creating the order
 - Store Credit on Shopping Cart support
 - Update populating the checkout address from hints prefill
### [v1.1.12](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.12) 2019-04-01
 - Allow Admin to update order manually
 - Back-office create order check for shipping method
 - Multi-store support
 - One step checkout support / disable bolt on payment only checkout pages
 - Add config for merchant to specify EmailEnter callback
 - Update ajax order creation error message
### [v1.1.12.1](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.12.1) 2019-04-10
 - Fix to support multi-stores with no default api key
### [v1.1.13](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.13) 2019-04-26
 - Various bug fixes
### [v1.1.14](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.14) 2019-05-28
 - Various bug fixes
### [v1.1.15](https://github.com/BoltApp/bolt-magento2/releases/tag/1.1.15) 2019-06-12
 - Fixes for multi-store backend support.
 - Option to toggle emulated session in api calls
### [v2.0.0](https://github.com/BoltApp/bolt-magento2/releases/tag/2.0.0) 2019-07-02
 - Introducing pre-authorized order creation
### [v2.0.1](https://github.com/BoltApp/bolt-magento2/releases/tag/2.0.1) 2019-09-06
 - Added generic ERP support
 - Removed Autocapture from settings
### [v2.0.2](https://github.com/BoltApp/bolt-magento2/releases/tag/2.0.2) 2019-09-12
 - Support for Paypal
### [v2.0.3](https://github.com/BoltApp/bolt-magento2/releases/tag/2.0.3) 2019-10-2

_(Changelog truncated for .md surface. Full history on https://packagento.com/boltpay/bolt-magento2.)_

## Recent Versions

| Version | Released |
|---|---|
| 2.27.9-rc3 | 2026-05-22 |
| 2.27.9-rc2 | 2026-05-21 |
| 2.27.9-rc1 | 2026-01-16 |
| 2.27.8 | 2025-08-07 |
| 2.27.8-rc3 | 2025-06-17 |
| 2.27.8-rc2 | 2025-06-03 |
| 2.27.8-rc | 2025-06-02 |
| 2.27.7.declarative.schema.zend.removed | 2025-03-07 |
| 2.27.7 | 2025-03-05 |
| 2.27.6-rc3 | 2025-02-26 |

Showing 10 of 254 versions. Full release history on https://packagento.com/boltpay/bolt-magento2.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| bugsnag/bugsnag | ^3.4 |
| magento/framework | 100.*\|101.*\|102.*\|103.* |
| magento/module-checkout | 100.*\|101.*\|102.*\|103.* |
| magento/module-payment | 100.*\|101.*\|102.*\|103.* |
| magento/module-sales | 100.*\|101.*\|102.*\|103.* |
| magento/module-tax | 100.*\|101.*\|102.*\|103.* |

### Require (dev)

| Package | Constraint |
|---|---|
| magento/magento-coding-standard | ^5.0 |
| mikey179/vfsstream | ^1.6 |
| phpunit/phpunit | ~6.2.0 |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["boltpay/bolt-magento2"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

boltpay is a Magento 2 vendor on Packagento. See https://packagento.com/boltpay.md for their full catalogue.