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!

Miva Integration

Supported Versions

MIVA 9.0 or higher

1. Plugin Installation

  • The name of the module is boltpayments.mvc. Extract it from the ZIP file provided, if necessary.
  • Log into your MIVA Merchant administration backend (for example, https://www.domain.com/mm5/admin.mvc)
  • Navigate to Menu > Modules
  • Near the top right of the screen, click the “+” icon.
  • On the next screen, labeled Add Module, click the Upload button.
  • In the popup window, click the Choose File button (depending on your browser, the button label may be different.)
  • Navigate to the boltpayments.mvc file on your hard drive and select it.
  • Click the Upload button on the popup window.
  • The popup window will disappear, returning you to the Add Module screen. Click the +Add button near the top right.

2. Assigning the Module to your Store

  • Navigate to Menu > Payment.
  • Click the Add/Remove Modules tab, which may be hidden behind the ... button.
  • Under the Available Modules section, locate the Bolt (credit card) module. Click the +Install button inside the Bolt (credit card) module box.
  • If you have multiple stores on your domain, repeat steps 1-3 above for each store that you want to integrate with Bolt.

3. Configuring the Module and Bolt Account

  • In MIVA, go to Menu > Payment and then click the Bolt (credit card) tab.
  • Enter your Storefront Publishable Key, Back Office Publishable Key, API Key, and Signing Secret, all of which can be obtained by logging into your Bolt account and going to the Settings > Keys and URLs screen.
  • Choose whether you wish to work with the Sandbox or Production environments from the dropdown.
  • Next to Image Code, choose the code for the image you wish to send to Bolt. This will usually be main and that is the default setting, but you can change it if you use a different image code on your store.
  • Next to Method, indicate whether you wish to only authorize a credit card when the shopper places the order, or if you prefer to authorize and capture at the same time.
  • Click the turquoise Update button in the top right to save your settings.

4. Create the User Interface Item

The Bolt module requires an Item. This should be automatically created for you during installation. In case that fails, you can use the following steps to automatically create the item.

  • In MIVA, go to Menu > User Interface and then click on the Items tab.
  • Click the “+” button to create a new item
  • In the Code box, enter bolt.
  • Click the Look Up button to find the Bolt module, or you can just type boltpayment in the box labeled Module.
  • Click the +Add button to create the item.
  • Next, click the Pages tab. Toggle the item to the on position in the Assigned column for all customer-facing pages (usually everything but batch reports, emails, and similar).

5. Template Changes

The Bolt module also requires some template changes. These should be automatically added to the correct locations when you install the module. However, in case it fails, use the following steps to modify your templates.

If the templates were changed automatically, you may also desire to move the button to a different location. If so, find the code shown in step 4 below, on the BASK page basket template. Remove it from the bottom of that template and place it where you would like the button to appear.

  • In MIVA, go to Menu > User Interface.
  • Find and edit the BASK page
  • Just before the closing </head> tag, enter the following line of code:
    <mvt:item name="bolt" param="connect" />
  • Then wherever you would like the Bolt checkout button to appear, enter this code:
    <mvt:item name="bolt" param="button" />
    <mvt:item name="bolt" param="callback" />
  • Click the turquoise Update button to save your changes.
  • Return to Menu > User Interface, and then click the Settings tab.
  • In the box labeled Head Tag Content, insert this as the last line:
    <mvt:item name="bolt" param="track" />
  • Click the turquoise Update button to save your changes.

6. Adding the boltstatus Custom Field

The Bolt module also uses a new custom field to help you view the status on the Order Processing batch screen. This should be automatically created when you install the module. However, in case it fails, use the following steps to create the boltstatus page.

  • In MIVA, go to Menu > Utilities.
  • If there is a Custom fields tab, click it and skip to step 6.
  • If there is not a Custom fields tab, click the Add/Remove modules tab (which may be hidden under the “…” link).
  • Find the Custom Fields module and click its +Install button.
  • Click the Custom Fields tab.
  • Click the “+” button to add a new field
  • Choose Order Field for type.
  • Enter boltstatus for the code
  • Enter Bolt Status for the name
  • Leave other selections at their default value. You may enter Additional Information if you prefer.
    Click the turquoise Save button.

7. Upgrading the Module on your Domain

The process to upgrade the Bolt module on your store is similar to the installation process.

  • Extract boltpayments.mvc from the ZIP file provided.
  • Log into your MIVA Merchant administration backend (for example, https://www.domain.com/mm5/admin.mvc)
  • Navigate to Menu > Modules
  • Near the top right, in the box labeled “Search Modules...”, type in Bolt and then click the turquoise button with a magnifying glass icon.
  • Hover over the Bolt (credit card) module in the batch list, and on the far left you’ll see a button appear. It has a square with an arrow. Click this button.
  • On the next screen, click the Files tab.
  • Click the Upload button.
  • In the popup window, click the Choose File button (depending on your browser, the button label may be different.)
  • Navigate to the boltpayments.mvc file on your hard drive and select it.
  • Check the Overwrite checkbox.
  • Click the Upload button on the popup window.
  • The popup window will disappear, returning you to the Edit Module screen. Click the Update button near the top right.

Miva Integration


Suggested Edits are limited on API Reference Pages

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