📍 Bolt / Developers / Developer Guides / Checkout Setup / Custom API Checkout / Bolt Checkout Integration Guide

Bolt Checkout Integration Guide

Use this guide to set up a basic Bolt Checkout flow on your website.

How to Integrate with Bolt Checkout

  1. Generate an order token by sending a POST request to /v1/merchant/orders.
  2. Install the Checkout Button on your storefront.
  3. Learn how to interact with our Merchant API to handle various operations for the order, such as:
    • Populating shipping and tax options in checkout by responding to a order.shipping_and_tax request from Bolt.
    • Applying any discounts in checkout by responding to a discount.code.applyrequest from Bolt
    • Pre-authorizing an order by responding to an order.create request from Bolt
  4. Listen for webhook events related to the order’s changing transaction status.


You must have a Bolt Merchant account to begin. If you do not yet have an account, contact sales to begin onboarding.

API Keys

Both admin and developer-level roles have access to your merchant account’s settings. If you are a developer and you do not have access, reach out to your Bolt Admin.

  1. Login to the Merchant Dashboard.
  2. Navigate to Dashboards > API.
  3. Scroll to Keys.

Test the Bolt integration in your Merchant Staging environment first and never share your API Keys or Signing Secrets externally.

Sections in This Guide

How to Create a Bolt Order Token
Learn how to build a request that initiates checkout using a token.
How to Set Up Pre-Authorization
Learn how to create and test pre-authorization order flows.
How to Install the Checkout Button
Learn how to add scripts to your storefront and call Bolt Checkout.
1 article
About the Merchant API
Learn how to connect and communicate with your Merchant API.
How to Set Up Shipping & Tax Endpoints
Learn how to build and send shipping and tax payloads to Bolt Checkout.
How to Apply Discounts
How to call the Merchant API and verify discount codes submitted by a shopper.