# Set up Bolt on Salesforce Commerce Cloud

> Install Bolt cartridges on Salesforce Commerce Cloud (SFCC) storefronts.

Source: https://help.boltapp.com/platforms/salesforce

Integrate Bolt into a Salesforce Commerce Cloud (SFCC) storefront using Bolt-provided cartridges. Bolt uses the Open Commerce API (OCAPI) to render the Bolt checkout button on the cart, minicart, and product pages.

**Platform support**

This guide is for Salesforce Commerce Cloud. Other platforms and custom web apps have their own quickstarts.

<IntegrationTable>
  <CommercePlatforms current="salesforce" />
</IntegrationTable>

## Choose an integration [#choose-an-integration]

| Integration                                                                  | Use it when                                                                                              |
| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| [SFRA V2 (Checkout)](/platforms/salesforce/sfcc-sfra-v2/installation/)       | You run a standard SFRA storefront and want Bolt's hosted checkout to replace the native SFRA checkout.  |
| [Composable Storefront](/platforms/salesforce/sfcc-sfra-v2/sfcc-composable/) | You run a headless PWA Kit storefront. Extends the SFRA V2 plugin with a React `BoltCheckout` component. |
| [Embeddable Checkout](/platforms/salesforce/sfcc-embedded/setup/)            | You keep your own checkout UX and want Bolt to add account SSO, one-click login, and payment methods.    |

## Prerequisites [#prerequisites]

* A working SFCC storefront with a base SFRA cartridge running
* Bolt API credentials (API Key, Signing Secret, Publishable Key) from the Merchant Dashboard
* OCAPI access, with Account Manager access granted to `dev@boltapp.com`
* System Object Extension enabled to store payment and basket data
* Embeddable Checkout also requires SFRA v6.0+ and your Bolt Merchant Division ID

## Install (SFRA V2) [#install-sfra-v2]

1. **Upload the cartridge:** clone `bolt-demandware-managed`, add a `dw.json`, and upload to your SFCC digital server.
2. **Activate the cartridge:** add `int_bolt_sfra:int_bolt_core` in front of the base cartridge path for each site.
3. **Authorize Bolt:** grant Account Manager access and share your API client credentials with Bolt.
4. **Configure OCAPI settings:** paste the provided `OCAPIshop.json` and `OCAPIdata.json`, replacing `client_id`, then disable OCAPI 404 response caching of dynamic content.
5. **Import metadata:** rename `RefArch` to your site ID, edit `library.xml`, then import `Bolt-meta-import`.
6. **Set site preferences:** configure the **Bolt Payment Setting** attributes (API key, signing secret, publishable key, environment).
7. **Add the checkout button:** wire the Bolt button into `cart.isml` via `boltModalConfigure.js`.

**Expected result:** the Bolt checkout button renders on the cart and sandbox checkout opens.

## Production checklist [#production-checklist]

* Switch to production API keys, credentials, and environment site preference
* OCAPI methods allowed through your CDN
* Live processor credentials configured in the Bolt dashboard

## Troubleshooting [#troubleshooting]

* Shoppers cannot check out: monitor **Administration > Operations > Service Status > `bolt.http`**.
* OCAPI requests break: confirm **OCAPI 404 Response Caching of Dynamic Content** is disabled.
* Email bypasses Bolt: a shopper already logged into SFCC may auto-fill their email. Use `Bolt-accountExists` to check for a Bolt account.

## Related [#related]

* [SFRA V2 installation](/platforms/salesforce/sfcc-sfra-v2/installation/)
* [Embeddable Checkout setup](/platforms/salesforce/sfcc-embedded/setup/)
* [Manage orders and operations](/platforms/salesforce/operations/)
* [Bolt Checkout](/products/checkout)
* [Embeddable Checkout](/products/embeddable-checkout)