README

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.