Bolt Developer

Welcome to the Bolt developer hub. You'll find comprehensive guides and documentation to help you start working with Bolt as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Docs

Magento 1 Integration

This is a guide to setup Bolt on Magento

Supported Magento Versions

Open Source (CE)
1.9, 1.9.1, 1.9.2, 1.9.3
Commerce using on prem (EE)
1.12, 1.14, 1.14.1, 1.14.2, 1.14.3

Supported PHP version

5.4+

1. Requirements

  • Download the Bolt Magento plugin: Bolt Magento plugin
  • Your production Magento server needs to be on HTTPS with a valid certificate
  • Self-signed certificates are not allowed
  • You should have account to Bolt merchant dashboard sandbox where you can access API keys for testing.
  • If you have security settings or DDoS protection against bots, please whitelist our User-Agent: Bolt - https://www.bolt.com

2. Setup Bolt Extension

2.1 Copy the plugin to your Magento server

In the top level of your Magento store installation, copy and paste the contents of the Bolt Magento plugin files.

Upgrading the extension from pre 1.0 version

If you are upgrading the plugin, you can simply paste the content of the zip file in the top-level directory, overwriting the older version.

If you are upgrading from version 1.0.0 or below, you will also need to delete the folder magento_installation_folder/app/code/local/Bolt

2.2 Clear Magento Cache

Magento cache needs to be cleared for the server to pick up the new plugin:

  1. Navigate to Admin console | System | Cache Management
  2. Select Flush Cache.

2.3 Magento Admin Configuration

From the Magento Admin:

  1. Navigate to System | Configuration | Payment Methods.
  2. Locate the tab labeled Bolt Pay.
  3. Insert your Bolt Keys and Signing Secret that are available from the Bolt Merchant Dashboard.

Where to find keys

For production, these will be found at:
https://merchant.bolt.com/settings

For sandbox mode, use the following URL:
https://merchant-sandbox.bolt.com/settings

  • API Key — used for calling Bolt API from your back-end server
  • Signing Secret — used for signature verification to check the authenticity of webhook requests
  • Publishable Key - Multi-Page Checkout — used to open the Bolt Payment Popup in Shopping cart page

If you use Bolt in checkout page to collect only billing information (non-standard), set the Publishable Key - One Page Checkout too, otherwise keep it blank.

If Bolt is your only payment option, select Yes for the Skip Payment Method Step.

2.4 Bolt Merchant Dashboard Configuration

Login to the Bolt Merchant Dashboard

  1. Go to Settings tab.
  2. Select Keys and URLs.
  3. Scroll to the URL Configurations section
  4. Set the Webhook URL to: https://[store_url]/boltpay/api/hook
  5. Set the Shipping and Tax URL to: https://[store_url]/boltpay/shipping (if present)
  6. Set the Create Order URL to: https://[store_url]/boltpay/api/create_order (if present)

3. Enabling Bolt

This is the final step in the configuration. This will turn on Bolt and will enable your site to start accepting payments from Bolt.

  • Navigate to Admin console | System | Payment Methods | Bolt Pay
  • Select the Enable Bolt Pay option

Disabling Bolt Extension

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

Success! You are all set to start accepting payment via Bolt

Updated 11 days ago

Magento 1 Integration


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.