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


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 -

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
Admin consoleSystemCache ManagementFlush Cache

2.3 Magento Admin Configuration

From the Magento Admin navigate to SystemConfigurationPayment Methods
where you will find a tab labeled Bolt Pay. You will insert your Bolt Keys and Signing Secret that are available from the merchant dashboard.

Where to find keys

For production, these will be found at:

For sandbox mode, use the following URL:

  • 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 "Publishable Key - One Page Checkout" too. Otherwise keep it blank.

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

2.4 Bolt Merchant Dashboard Configuration

Login to the Bolt Merchant Dashboard

  • Select from the menu SettingsKeys and URLs
  • Scroll down to the URL Configurations section
  • Set Webhook URL to: https://[store_url]/boltpay/api/hook
  • Set Shipping and Tax URL to: https://[store_url]/boltpay/shipping (if present)
  • Set 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

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, use the following:
AdminSystemConfigureAdvancedDisable Modules OutputBolt_BoltpayDisable

Navigate to Admin consoleSystemPayment MethodsBolt Pay

  • Select the Enable Bolt Pay option

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

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.