Install Step 2: Enable Fast Checkout on SFCC
The cartridge includes the necessary code for Fast buttons to appear and work on the following pages without requiring any changes:
- Simple Product Detail Page (PDP)
- Cart
Requirement
Before proceeding with storefront configuration, ensure you have already downloaded the Fast Cartridge for SFCC and uploaded it to your storefront.
Configuration
- Log in to your Commerce Cloud site with your Business Manager credentials.
-
Activate the previously uploaded
int_fast_sfraCartridge to the site by adding it to your storefront's Effective Cartridge Path.- Navigate to:
Administration → Sites → Manage Sites → {site_id} → Settings - In the Settings tab, add
int_fast_sfrato the Effective Cartridge Path (e.g.int_fast_sfra:app_storefront_base, as Cartridge names must be provided as a colon-separated list) - Click "Apply"
- Navigate to:
-
Import Fast's metadata XML file to enable custom attributes that support Fast payments.
- Navigate to:
Administration → Site Development → Import & Export → Manage Import Files -
Find the
system-objecttype-extensions.xmlunder/metadata/fast-meta-import/metaFor reference, this is the location of the file in Fast's SFCC Integration GitHub repository.
- Navigate to:
Proceed in Sandbox
Please limit changes to Sandbox configuration settings so that Fast can evaluate your Sandbox configuration before proceeding with changes that will affect your production storefront.
-
Connect to OCAPI
- Navigate to:
Administration → Site Development → Open Commerce API Settings - Select Type: Shop
- Select Context: Global (organization-wide)
-
Paste in the OCAPI configuration file (provided in JSON format) provided to you by Fast
Be sure to update
"client_id":"<<client_id>>"with the Client ID you obtained prior to starting the installation process
- Navigate to:
-
Open Fast configuration settings
- Navigate to:
Merchant Tools → Site Preferences → Custom Preferences. - Click on Fast Configs
- Navigate to:
-
Enter your Fast configuration details
-
Set Instance Type
During initial testing, set Instance Type to "Sandbox". Instance Type should only be changed to "Production" after Fast has evaluated your Sandbox setup and you are ready to go live with your changes
-
Set FAST JS URL
Sandbox: "https://js.sandbox.fast.co/fast.js"
Production: "https://js.fast.co/fast.js" -
Set Is Fast Enabled option to "Enabled"
This is a store-level configuration setting that allows you to quickly enable or disable Fast.
-
Set Fast App ID
Enter the Sandbox App ID (
app_id) provided to you previously by FastYou will not obtain a productionFast APP ID
The Fast App ID (
app_id) can be found in the Install section of your Fast Seller Dashboard. You can also retrieve your Sandbox App ID from the Sandbox Seller Dashboard.app_iduntil your Sandbox setup has been validated by Fast -
Set Fast Theme
ProTip: Select dark theme if your site has a dark/black background.
-
- Save Config
-
Implement Custom Code to Display the Fast Checkout Button
-
Add custom code (provided by Fast) to your storefront's Base ISML files
The default storefront Cartridge is normally
app_storefront_base - To view the current versions of these ISML files, Navigate to:
Administration → Site Development → Development Setup → {Code Version} → {Cartridge:app_storefront_base} → cartridge templates default - Insert custom code in the following files at locations specified by Fast:
-
| File | Custom Code Content |
|---|---|
| cartridge/templates/default/common/layout/page.isml | Include the fast.js file in the HTML Head of your storefront to enable Fast features |
| cartridge/templates/default/cart/cart.isml | Include the Fast Checkout button on Cart Pages |
| cartridge/templates/default/checkout/cart/miniCart.isml | Include the Fast Checkout button on Mini-Cart Pages |
| cartridge/templates/default/product/productDetails.isml | Include the Fast Checkout button on Product Detail Pages |




