Pre-requisites
You must have a Bolt Merchant account to begin. If you do not yet have an account, contact sales to begin onboarding. A merchant account and API keys are not sufficient on their own. A payment processor, Trusted Domains, and a division set up as a custom cart are all required, and each one fails in a way that is hard to diagnose from the browser. See prerequisites and readiness for the full checklist and the checks you can run before wiring up a storefront.API Keys
You must have access to your merchant account’s production and sandbox keys to set up this integration. Both admin and developer-level roles have access to keys; if you are a developer and you do not have access, reach out to your Bolt Admin.- Login to the Merchant Dashboard.
- Navigate to Administration > API.
- Scroll to API Keys and click the eye icon to reveal your keys.
The Publishable Key supports the multi-step checkout use case by default. To build other checkout flows such as Payment-Only, switch divisions using the Division dropdown. The publishable key is a long string of lower and upper case letters and numbers that consists of three sections.
Environments
You must have all of the following merchant accounts set up to build, test, and deploy your integration:- Sandbox: https://merchant-sandbox.boltapp.com
- Staging: https://merchant-staging.boltapp.com
- Production: https://merchant.boltapp.com
Configure your integration
Set your API keys and environment URLs as configuration for whichever language or library you’re integrating with..env
TypeScript
The four pieces
- Generate an order token by sending a POST request to
/v1/merchant/orders. - Install the Checkout Button on your storefront using
/v1/checkout_button. - Build out your Merchant Callback API to interact with the Bolt API and handle various operations for the order, such as:
- Listen for transaction webhooks related to the order’s changing transaction status. These are configured separately from your Merchant Callbacks.