Set Up SFCC for Bolt
Upload the cartridge and install code snippets.

Before You Start

Step 1: Install Cartridge

  1. Login to Business Manager.
  2. Navigate to Administration > Sites > Manage Sites and select the Settings tab.
  3. Add int_bolt_embedded_sfra to the cartridge path.
  4. Unzip the Bolt cartridge and upload it. For detailed instructions on doing this, see Upload Code for SFRA.

Step 2: Configure Business Manager

The next step is configuring metadata, site preferences, service, payment methods and OCAPI

Import Metadata

  1. Navigate to Business Manager > Administration > Site Development > Site Import & Export.
  2. Upload the metadata zipfile contained in the cartridge by running the following:
    • npm run zipMetadata
    • npm run uploadMetadata

Site Preferences

  1. In Business Manager, navigate to Merchant Tools > Site Preferences > Custom Preferences.
  2. Set the following values in preference group Bolt Payment Setting - Embedded: - API Key: Your Bolt API key. - Bolt Merchant Division ID: The unique ID associated with the merchant Bolt Account division. - Publishable Key: Your Bolt merchant division specific value. The publishable key is a string of lower and upper case letters and numbers that consists of three sections, separated by periods. publishable key - Bolt Environment: String Enum used to switch between different Bolt environment endpoint hostnames. Select either Sandbox, or Production. - Enable Bolt Pay: Enable or disable Bolt Pay. - **Enable Auto Capture**: Enable or disable auto-capture.

Payment Method

Ensure Bolt Payments is enabled by navigating to Merchant Tools > Ordering > Payment Methods. BOLT_PAY should be enabled and the payment processor should appear configured.

HTTP Service

Navigate to Administration > Operations > Services and ensure bolt.http is selected.

Authentication Flow

Review the Bolt Accounts diagram to gain insight into how Bolt and your backend work to authenticate customers, populate the Bolt login modal, and authorize checkout.

Step 3: Add Bolt to Template

To include Bolt in your template take the following steps.


  1. In /templates/default/checkout/checkout.isml add the following code snippet before the first <isscript> tag:
<isinclude template="checkout/boltEmbed" />
  1. Add a check for which type of Bolt shopper is checking out:
<div id="checkout-main" class="container data-checkout-stage <isif condition=" ${pdict.order.usingMultiShipping && pdict.order.shipping.length > 1}">multi-ship</isif>" data-customer-type="${pdict.isBoltShopperLoggedIn ? 'boltShopper' : (pdict.customer.registeredUser ? 'registered' : 'guest')}" data-checkout-stage="${pdict.currentStage}"


  1. In /templates/default/checkout/shipping/shipmentCard.isml add the following snippets to the file in the places illustrated by the example below:
<div class="card-body shipping-content">

<form class="shipping-form" autocomplete="on" novalidate
? URLUtils.url('CheckoutAddressServices-AddNewAddress')
: URLUtils.url('CheckoutShippingServices-SubmitShipping')}"
data-address-mode="${((pdict.isBoltShopperLoggedIn && pdict.boltAddressId && !pdict.shippingAddressDataMissing) || shippingModel.matchingAddressId) ? 'edit' : 'new'}"  // This line


<div class="shipping-address ${pdict.order.usingMulitShipping ? 'd-none' : ''}">
    <fieldset class="shipment-selector-block ${(pdict.order.usingMultiShipping || shipmentLoopState) || (pdict.customer.addresses && pdict.customer

|| (pdict.isBoltShopperLoggedIn && pdict.boltStoredShippingAddress) ? '' : 'd-none'} "> // This line

  1. In /templates/default/checkout/shipping/shipmentSelectorOptions.isml before this line
<iselseif condition="${pdict.customer.addresses && pdict.customer.addresses.length > 0}">

…add the following statement:

<isif condition="${pdict.isBoltShopperLoggedIn && pdict.boltStoredShippingAddress}">
   <option disabled>${Resource.msg('msg.account.addresses', 'checkout', null)}</option>
   <isloop items="${pdict.boltStoredShippingAddress}" var="address">
       <option value="${'ab_'}" ${ ? 'selected="selected"' : '' }
       data-first-name="${address.first_name||''}" data-last-name="${address.last_name||''}"
       data-address1="${address.street_address1||''}" data-address2="${address.street_address2||''}"
       data-city="${address.locality||''}" data-state-code="${address.region_code||''}"
       data-country-code="${address.country_code||''}" data-postal-code="${address.postal_code||''}"
       data-phone="${address.phone_number||''}" data-is-gift="${''}" data-gift-message="${''}"
       ${address.first_name || ''} ${address.last_name || ''} ${address.street_address1 || ''} ${address.street_address2 || ''} ${address.locality || ''}${!address.locality || ','} ${address.region_code||''} ${address.postal_code||''}

  1. In /templates/default/checkout/shipping/shippingAddress.isml on line 8, add the following snippet:
<input type="hidden" name="${addressFields.boltAddressId.htmlName}" value="${pdict.boltAddressId}">


  1. In /templates/default/checkout/billing/paymentOptions/paymentOptionsTabs.isml add the following line of code as illustrated by the example below:

<isloop items="${pdict.order.billing.payment.applicablePaymentMethods}" var="paymentOption">
    <isif condition="${paymentOption.ID === 'BOLT_PAY'}"> // This statement
        <isinclude template="checkout/billing/paymentOptions/bolt/paymentTab" />

  1. In /templates/default/checkout/billing/paymentOptions/paymentOptionsContent.isml add following code snippet as illustrated by the example below:
<isloop items="${pdict.order.billing.payment.applicablePaymentMethods}" var="paymentOption">
    <isif condition="${paymentOption.ID === 'BOLT_PAY'}"> // This statement
        <isinclude template="checkout/billing/paymentOptions/bolt/paymentContent" />
  1. In /templates/default/checkout/billing/paymentOptions/paymentOptionsSummary.isml add following code snippet as illustrated by the example below:
<div class="payment-details">
    <isloop items="${pdict.order.billing.payment.selectedPaymentInstruments}" var="payment">
        <isif condition="${payment.paymentMethod === 'BOLT_PAY'}" /> // this statement
	        <isinclude template="checkout/billing/paymentOptions/bolt/paymentSummary" />


  1. In /forms/default/address.xml add following code snippet on line 6
<field formid="boltAddressId" label="label.input.boltAddressid" type="string" binding="boltAddressId" mandatory="false" />
  1. In /forms/default/billing.xml add following code snippet within the <form></form> tag at the top of the file:
<include formid="boltCreditCard" name="boltCreditCard"/>

Step 4: Configure Bolt Selectors

The Bolt login modal relies on several SFCC native front end components to attach Bolt component’s to email fields, and other parts DOM elements. Go to boltEmbed.isml to check that your DOM elements have the correct ids or classes. The most important field is checkoutEmailField, which Bolt uses to use show a login modal when the shopper types in their email in checkout. The remaining fields are for Ignite SSO.

window.BoltSelectors = {
    checkoutEmailField: "#email-guest",

    // ----- SSO ----- //

    // Sign In page
    signInEmailField: "#login-form-email",
    forgetPasswordButton: "#password-reset",

    // Registration page
    registerEmailField: "#registration-form-email",

    // Checkout page'
    checkoutEmailSummary: ".customer-summary-email",
    editShippingHeader: ".shipping-section h2",
    shippingSummary: ".address-summary",
    addPayment: ".payment-information",
    paymentSummary: ".payment-details",
  • Bolt uses the email fields' keyup to listen for emails with Bolt accounts. After a debounce time, will then prompt the shopper with a Login modal. On success, Bolt authenticates the user and sends it to your server to pre-fill shopper information.
  • The forgot password button will listen to click events to also load the Login Modal in a similar manner.
  • The remaining shipping and payment fields aim to add Bolt Login buttons to your forms to faster checkout.'

Add Delivery Fee to Checkout

You can add a delivery fee at checkout based on the order’s shipping destination. Use this functionality to comply with local laws such as Colorado’s Delivery Fee.

  1. In SFCC Business Manager, navigate to Merchant Tools > Ordering > Shipping Methods.
  2. For each currently available shipping method, add an exclusion rule to exclude addresses from Colorado from receiving the shipping method.
  3. For each available shipping method, create a corresponding shipment method which includes the $0.27 fee in the shipping value. The Description field can be used to render a new description in Bolt Checkout UI for the shipping method.

About Data Storage

This integration requires the following system object extensions.

  • OrderPaymentInstrument custom attribute:
    • boltCardBin(String): Store the credit card bin
    • boltPaymentMethodId(String): Bolt Payment Method ID
    • boltCreateAccount(Boolean): Indicates whether the user has chosen to create a Bolt account
    • boltTokenType(String): Bolt token type
  • SitePreferences custom attributes:
    • boltAPIKey(String): Bolt-provided merchant account identifier
    • boltMultiPublishableKey(String): Used to retrieve your Bolt merchant division key
    • boltEnvironment(String): String Enum (Sandbox, Staging, Production); used to switch different Bolt environment endpoint hostnames
    • BoltEnable(Boolean): Indicates whether Bolt is enabled
    • boltMerchantDivisionID(String): Bolt merchant division ID
    • boltEnableAutoCapture(Boolean): Indicate if funds are captured
    • boltGuestCheckoutOnly(Boolean): Indicates whether Bolt appears only in Guest Checkout. Leave empty or set to false if it appears both in Guest and Logged-In Checkout.

About Logs

Bolt Embedded adds several new custom logs.

  • Bolt Custom Log: Similar to This log file contains all logs from the int_bolt_embedded_sfra cartridge.
  • Service Communication Logs: These logs contain every request and response to the Bolt API endpoint. To enable these logs, navigate to Administration > Operations > Services > bolt.http and check Communication Log Enabled.
Filter by Section
Filter by Topic