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!

Drupal Integration

This is a guide to installing the Bolt Payment Plugin to a Drupal Commerce store.

Supported Versions

This plugin is designed to work with Drupal Commerce 7.x

1. Requirements

The minimal set of activated drupal modules required for the plugin to run is as follows:

Module Dependencies

The commerce_bolt module is dependant on the following modules:

  • commerce
  • commerce_customer
  • commerce_line_item
  • commerce_price
  • commerce_product
  • commerce_order
  • commerce_payment
  • addressfield
  • entity
  • rules

They are specified as dependencies of the aforementioned required modules.

2. Module installation

You can enable the module from the store admin panel or with the drush command: drush en commerce_bolt -y

3. Module configuration

With the commerce_bolt module enabled there is a Boltpay menu item in the admin panel. It opens the Bolt Payment Configuration page containing the following data-entry fields:

  • Enabled
    enabling / Disabling the Bolt Payment method
  • Sandbox Mode
    setting up testing vs. production execution environment
  • 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 - Payment Only Checkout
    used by Bolt JavaScript Payment Only Checkout window
  • Publishable Key - Multi-Page Checkout
    used by Bolt JavaScript Multi-Page Checkout window

The required keys can be found on the Bolt Merchant Dashboard

  • Automatic Capture Mode
    capturing funds configuration

YES - both authorization and capture are done in a single step
NO - the funds are captured in a separate request, initiated either from the store admin panel or from the Bolt merchant dashboard

  • BOLT Checkout Pages
    pages in the commerce checkout flow that should display Bolt Multi-Page Checkout button
  • SHOPPING CART
  • CHECKOUT
  • SHIPPING
  • Display Button with Credit Card Icons
    show credit card logos below checkout buttons

Populate the form fields and click the Submit button.

4. Payment Method configuration

  • Login to the store admin panel
  • Go to the store Payment methods configuration page
  • Find Boltpay under the payment method rules
  • If Boltpay is disabled click on the enable link in the operations column to enable it

5. Bolt Merchant Dashboard configuration

  • Login to the Bolt merchant dashboard
  • From the Settings menu select Users and keys
  • Scroll down to the URL Configurations section
  • Set Webhook URL to: [store_url]/boltpay/order_update
  • Set Shipping and Tax URL to: [store_url]/boltpay/shipping_and_tax

Success!

Your Bolt Payment Plugin is now installed and configured.

Drupal Integration


Suggested Edits are limited on API Reference Pages

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