Bolt Checkout Plugin for Magento 2

1. Requirements

• Magento 2.2.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 four required values, (i.e. API Key, Signing Secret, Publishable Key - Multi Step, and Publishable Key - Payment Only can be found in your Bolt Merchant Dashboard under Settings > Users and Keys

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
• 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 Settings > Keys and URLs
• Scroll down to the URL Configurations 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

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 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 2018-12-13

• Force approve/reject failed hook fix

v1.1.7 2018-12-21

• Amasty Gift Card support
• No status after unhold fix

v1.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 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 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 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 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 2019-04-10

• Fix to support multi-stores with no default api key

v1.1.13 2019-04-26

• Various bug fixes

v1.1.14 2019-05-28

• Various bug fixes

v1.1.15 2019-06-12

• Fixes for multi-store backend support.
• Option to toggle emulated session in api calls

v2.0.0 2019-07-02

• Introducing pre-authorized order creation

v2.0.1 2019-09-06

• Added generic ERP support
• Removed Autocapture from settings

v2.0.2 2019-09-12

• Support for Paypal

v2.0.3 2019-10-28

• Testing and logging fixes
• Beta merchant metrics feature
• Various bug fixes

v2.1.0 2019-11-21

• Paypal payment support
• [Beta] Feature switches
  • graphQL client for Bolt server communication
• BSS store credit support
• Improved checkout metricing
• Various bug fixes

v2.2.0 2020-02-05

• [Beta] Simple Product Page Checkout
• Staged Rollout
• Some M2 2.3.4 compat. fixes
• Multicurrency improvements
• Various bug fixes

v2.3.0 2020-02-20

• Custom checkboxes
• Re-order feature for logged-in customers
• Product page checkout improvements
• Various bug fixes

v2.4.0 2020-03-11

• Bug fixes
• Added JS event for when hints are set

v2.4.1 2020-03-18

• Fix Bolt checkout not opening on IE

v2.5.0 2020-03-27

• Add support for boltPrimaryActionColor
• Moved some CSS to M2 config page
• Custom options support for simple products in product page checkout
• Webhook log cleaner cron
• Improved api result caching
• Improved debug webhook data collection
• Bug fixes

v2.6.0 2020-05-04

• Debug webhook now fully available
• In-store pickup feature
• Pay-by-link added
• Unit tests and code cleanup
• Admin page reoganization
• Development quality of life fixes
• Support for shipping discounts
• Add Bolt account button for order management
• Added Amasty store credit support

v2.7.0 2020-05-12

• Add catalog price rule support for backoffice
• Unit tests
• Bug fixes

v2.8.0 2020-05-28

• Splitting shipping and tax endpoints
• Add always-present Bolt checkout button
• Added custom url validation
• Bug fixes
• Unit tests

v2.8.1 2020-06-11

• Fix PPC javascript error in Magento 2 version 2.3.5
• Fix unknown RevertGiftCardAccountBalance error