📍 Bolt Help / Platforms / BigCommerce / BigCommerce - Embedded Accounts / Set Up Bolt One-Click for BigCommerce Set Up Bolt One-Click for BigCommerce Follow the steps in this article to set up your BigCommerce site integration with Bolt One-Click. Page Contents Click to expand. This article assumes that you’ve already prepared your BigCommerce account according to the items listed in our Before You Start article. Steps Overview Connect to Bolt Create a Bolt Merchant Account Set Up Payment Processor Configure Capture Settings Enable Alternative Payment Methods Step 1: Connect to Bolt You can connect to Bolt from BigCommerce, or from our Quick Connect wizard. Via BigCommerce Admin Dashboard In the BigCommerce admin dashboard, navigate to Store Setup > Payments. In the Checkout Payment Settings tab, scroll to the Accelerated Checkout section to find Bolt. Click Get Started. On the Bolt Settings tab, click Connect. The Create a Bolt Merchant Account page loads. Quick Connect If you choose to connect using our Quick Connect wizard: Click the Open Quick Connect button below. Sign into your BigCommerce account when prompted. Continue to Step 2. Open Quick Connect Step 2: Create a Bolt Merchant Account On the Create a Bolt Merchant Account page, ensure the following information is populated: • First Name • Last Name • Email Address • Store Name • Website URL In the Payment Processor field, select the desired payment processor. Click Create Account. Step 3: Set Up Payment Processor After you have created your Bolt Merchant Account, you’ll be directed to the Payment Processor selection page. On this page: Select your payment processor from the provided list. If you do not see your processor, reach out to our Support Team. Fill out the requested information. Click on your processor from the list below for instructions on how to create and enter your connection credentials. Adyen Click to expand. Connect Adyen To connect Adyen, retrieve these credentials from your existing Adyen account. Credential Description Example Where to Find It Adyen Merchant Account Code A unique identifier for your Adyen account. 129413 From your Adyen account: Go to Settings. Find Merchant accounts. Find your account code, then copy the string for use in a later step. Adyen Webservice API Key A string created specifically for use with Bolt that allows connection between the Bolt and Adyen APIs. 324f...3ni9 From your Adyen account: Go to Developers, then API credentials, and select the web service credential that has a description of Bolt. If you don’t already have an API credential for Bolt, you should create a Web Service User credential and add Bolt in the description.When you click the credential, you’ll see the Configure API Credential Page.Go to the Authentication section, under Server Settings, and select Generate New API Key.Select Save changes at the bottom of the page, then copy the string for use in a later step. Adyen HMAC Key The hash-based message authentication code (HMAC) is a unique secret key that generated in your Adyen account. 44782DEF547...6BA056 You can generate and retrieve an HMAC signature by following the instructions listed in Adyen’s Verify HMAC Signatures article. Adyen Username The username for the Adyen API credential you use for reporting. Report@Company.BoltFinancial From your Adyen account: Go to Developers, then API credentials, and select the reporting credential. If you don’t already have one, you should create a Reporting credential.When you click the credential, you’ll see General Settings.Copy the value in Username for use in a later step. Adyen Password The password for the Adyen API credential you use for reporting. 56f3...99h6 From your Adyen account: Go to Developers, then API credentials, and select the reporting credential. If you don’t already have one, you should create a Reporting credential.When you click the credential, you’ll see General Settings.Go to the Authentication section and click Basic Auth. Click Generate password.Click Save changes at the bottom of the page, then copy the password for use in a later step. Live URL Prefix A unique snippet of an endpoint URL that allows Bolt to identify your Adyen account. Note: This value is only available in your live environment. Example endpoint: https://e73e0f17d7bd00d7-BoltFinancial-checkout-live.adyenpayments.com/checkout/v1/payments Example Live URL Prefix: e73e0f17d7bd00d7-BoltFinancial From your Adyen account: Go to Developers. Go to API URLs and copy the Live URL prefix from one of the endpoints. Activate Webhooks (Recommended) Webhooks keep your systems in sync, allowing Bolt and Adyen to easily exchange data about transaction events and disputes. Failure to set up webhooks will result in discrepancies between your systems. Log into the Adyen Customer Area. Refer to Adyen’s Notification Webhooks article to set up standard webhooks. • In URL, you’ll enter the Bolt webhook URL. To find this, log into the Bolt Merchant Dashboard, then navigate to Settings > Payments > Manage Adyen and copy the Bolt webhook URL. Save and test using Adyen’s Notification Webhooks article. Authorize.net Click to expand. To connect Authorize.net, enter the following information from your existing account: Credential Description Example Where to Find It Authorize.net API Login ID A complex value that identifies your account to the payment gateway when submitting transaction requests from the website. Ab&1R7ghT Log into the Merchant Interface.Navigate to Account > Settings > API Credentials & Keys. Find your API Login ID and paste it into the required Bolt Set Up field. Authorize.net Transaction Key A randomly generated value that adds an additional layer of authentication when submitting transaction requests from your website. Ao73tGh6ryB358nI Log into the Merchant Interface.Navigate to Account > Settings > API Credentials & Keys. Click New Transaction Key.Select the option that allows both keys to remain in use for up to 24 hours.After you’ve generated a new key, you have 24 hours to update your keys across all integrations. Obtain the PIN from your email and enter it on the verification page. Copy the Transaction Key and paste it into the required Bolt Set Up field. If you are using Authorize.net as an emulator for another payment processing tool and receive an authorization error for the credentials you use, please open a ticket with our Support Team. Braintree Click to expand. Connect Braintree To connect Braintree: Click Connect Braintree. Then, log into and verify your account credentials for your existing Braintree Account. Click Authorize Access. Activate Webhooks (Recommended) Webhooks keep your systems in sync, allowing Bolt and Braintree to easily exchange data about disputes or disbursements. Failure to set up webhooks will result in discrepancies between your systems. Log in to the Braintree Production Console or Braintree Sandbox Console. Navigate to Settings > API > Webhooks > Create new webhook. Configure the webhook. Find the following information from the Bolt Merchant Dashboard: • Destination URL: Navigate to Settings > Payments > Manage Braintree and copy the Bolt webhook URL. • Public ID: Navigate to Developers > Public ID. Replace <public-id> in the URL. Subscribe to the following event notifications: • Disputes: Enable Lost, Opened, and Won. • Disbursement: Enable Disbursement. Save. Locate the newly created webhook URL and select it to test. A success message should appear. CyberSource Click to expand. To connect CyberSource, enter the following information from your existing account: Credential Description Example Where to Find It CyberSource Merchant ID The unique identifier for your merchant account with CyberSource. Usually the same as your CyberSource User Name. api_integration_tests Find your initial CyberSource confirmation of registration email. The Merchant ID is listed here. CyberSource Shared Secret Key Base-64 encoded secret key used as the authentication ID for REST API requests. 0524a22e-e46a-4872- 59a79a264f03 Important: This page shows both the shared secret key and the shared secret. Make sure to save both values before you navigate away from this page. The shared secret is not retrievable in the future. Log into the Business Center and navigate to Payment Configuration > Key Management. Click Generate Key. Click Rest - Shared Secret > Generate Key. Copy and paste the key into the required Bolt Set Up Field. Optionally, click Download to save the keys information in a text file on your machine. CyberSource Shared Secret Base-64 encoded secret used as an authentication signature for REST API requests. vz2Ir2ivCuOEd43YThb47 QhcfP7bqgjYSycu49lAwYW= You can find more information about these keys in CyberSource's documentation. NMI Click to expand. Connect NMI To connect NMI, you must first generate Bolt-specific NMI API and Webhook Signing keys. Then, enter the following credentials from your existing account into the Bolt Set Up fields: Credential Description Example Where to Find It NMI API Key A 32-character api key, generated by you, specifically for use in this set up process. jlsdfLS3FDd3skfas2hdfZ4ds3274k8f Generate in your NMI account: Go to My Settings > Security Keys > Add a New Private Key.Click generate a new API key.Copy and paste the key into the required Bolt Set Up Field. Webhook Signing Key A webhook URL that combines the base Bolt webhook with your Bolt Merchant Public ID. This allows Bolt to coordinate chargeback handling with your payment processor. https://api.bolt.com/v1/webhooks/nmi/{public-id} Replace {public-id} with your “Merchant Public ID” (a 12-character string), found in the Developers tab in your Bolt Merchant Dashboard. If you find that you cannot access this key, please reach out to our Support team. Activate Webhooks (Recommended) Webhooks keep your systems in sync, allowing Bolt and NMI to easily exchange data about chargebacks. Failure to set up webhooks will result in discrepancies between your systems. Log into your NMI merchant account. Navigate to Webhooks. Click Create. Find the following information from the Bolt Merchant Dashboard: • URL: Navigate to Settings > Payments > Manage NMI and copy the Bolt webhook URL. • Public ID: Navigate to Developers > Public ID. Replace <public-id> in the URL. Enable chargeback.batch.complete . Save. Copy the webhook’s signing key. Log into the Bolt Merchant Dashboard. Navigate to Settings > Payments. Click Manage NMI. Add the NMI Signing Key. Stripe Click to expand. To connect Stripe: Click Connect Stripe. Then, log into and verify your account credentials for your existing Stripe Account. Click Log In. Do not click "Create New Account" - this may create an additional Stripe account and freeze transactions for 14 business days. After your payment processor is connected, click Complete setup. How Bolt works with existing card processors For your customer to have a streamlined experience inputting their credit card information, Bolt will automatically disable duplicate instances of your payment processor to prevent confusion for your shoppers. Doing so ensures that Bolt is displayed as “Credit/Debit Card”. Because you have successfully integrated with Bolt One-Click Checkout, Bolt will now be a gateway between your checkout and your payment processor. This does not disable payment providers’ transactions from your site, nor does it disable your payment processor or alternative payment methods. INFO Bolt will only disable duplicate credit card processors when it is the same one connected to your Bolt account. If you are using a card processor that is not supported by Bolt, you must disable these other card processors manually. Step 4: Configure Capture Settings After you connect your desired payment processor, you need to configure transaction Capture Settings. In the Capture Settings dropdown, select the desired capture method. Option Definition Example Also Known As… Auto-capture The system captures funds at point of purchase. The system charges the user’s card when they purchase the item. Immediate Capture Manual Captures funds either partially or in full at a later date upon explicit confirmation from the merchant. This confirmation can be manual or can be automated through a shopping cart integration. For example, the system charges the user’s card after the item is marked as “shipped” by the merchant. Delayed Capture Click Connect [Processor Name], where the [Processor Name] is the processor you selected. INFO If, in the future, you need to change your capture settings, create a ticket with Bolt Support and request the change. Step 5: Enable Alternative Payment Methods (APMs) In the event that your APMs were disconnected from your checkout during this process, you’ll see a message letting you know that you may need to reconnect your APM. We recommend you select “Yes” and re-enable your APMs directly into the checkout. BigCommerce will take you through the flow you need to properly configure your settings. Options for {{Your APM}} ✕ This action will disable both credit card payments and {{Your APM}}. Do you want to change your selection? Yes. Activate {{Your APM}} only. No. Disable both credit card payments and {{Your APM}}. Cancel Continue Next Steps Next, we recommend diving into the Bolt experience and using the Merchant Dashboard for your transaction analytics, and more. You can learn more about your Merchant Dashboard in this Merchant Dashboard Tour video, tailored for BigCommerce Merchants!
This article assumes that you’ve already prepared your BigCommerce account according to the items listed in our Before You Start article. Steps Overview Connect to Bolt Create a Bolt Merchant Account Set Up Payment Processor Configure Capture Settings Enable Alternative Payment Methods