Skip to content

Salesforce Commerce Cloud

Accept payments with Finix on Salesforce Commerce Cloud.

Salesforce Billing

Salesforce Commerce Cloud Overview

Salesforce Commerce Cloud is an enterprise eCommerce platform used by global brands to deliver B2C and B2B digital shopping experiences. It provides a fully managed, cloud-hosted environment with tools for storefront merchandising, AI-driven personalization, order management, and omnichannel fulfillment. Finix integrates with Salesforce Commerce Cloud through the Cybersource payment gateway enabling merchants to accept payments directly within their B2C Commerce storefront.

Finix Requirements

  • Finix Live Account
  • Active Salesforce B2C Commerce Cloud instance

Integration

Step 1: Sign up for a Finix Account

To create a Finix account, you can follow our step-by-step guide or sign up directly for a live or sandbox account.

We recommend choosing Direct Merchant as your Customer Type.

Step 2: Create a Cybersource Gateway Integration

Cybersource Integration

Finix supports Salesforce Commerce Cloud via our Cybersource Gateway integration. Please note that there is an additional fee for using our Cybersource integration.

For more information, please reach out to your Finix point of contact.

  1. To create a Cybersource integration, navigate to the Integrations page on your Finix Dashboard.
Cybersource Merchant Integrations
  1. Sign up for Cybersource. You can view detailed instructions in our guide, here.
  2. After accepting the Cybersource invitation email, retrieve the following credentials from the Cybersource Business Center under Payment Configuration → Key Management — you'll need these to configure Salesforce Commerce Cloud:
    • Merchant ID (also called Organization ID)
    • REST Shared Secret Key and Key ID (required for Microform)
    • SOAP Toolkit Key (used for all other integrations)
Cybersource Key Management

Step 3: Set Up Your Salesforce Commerce Cloud Environment

Before proceeding, ensure your environment is ready:

  • Active Salesforce Commerce Cloud subscription
  • Store Front Reference Architeciture (SFRA) app_storefront_base cartridge installed and configured

Step 4: Install and Upload the Cybersource Cartridge

Before you proceed, ensure you have:

  • Approved Finix Merchant Account
  • Cybersource Gateway Integration linked to your Finix Merchant Account
  • Salesforce Commerce Cloud instance with developer access
  • Node.js and npm installed

To install the cartridge:

  1. Download the integration package from Salesforce AppExchange.
  2. Create a Cybersource folder in your project workspace and place the int_cybersource_sfra cartridge inside it.
  3. Configure your dw.json file with your SFCC instance credentials for IDE integration:
{
  "hostname": "your-sandbox-hostname.demandware.net",
  "username": "yourlogin",
  "password": "yourpwd",
  "version": "version_to_upload_to",
  "cartridge": [
    "int_cybersource_sfra",
    "app_storefront_base",
    "modules"
  ]
}
  1. Install sgmf-scripts and copy-webpack-plugin with the following commands:
npm install sgmf-scripts
npm install copy-webpack-plugin
  1. Compile cartridge assets:
npm run compile:js
npm run compile:scss
  1. Upload the cartridge to your Salesforce Commerce Cloud instance:
npm run uploadCartridge

For full installation details, refer to the Cybersource Salesforce Commerce Cloud developer documentation.

Step 5: Configure Salesforce Commerce Cloud Cartridge

Once the cartridge is uploaded, complete the following configuration in Business Manager:

Cartridge Path

Navigate to Administration → Sites → Manage Sites → [Your Site] → Settings and add the following to your cartridge path:

int_cybersource_sfra:app_storefront_base

Import Metadata

  1. In the downloaded package, navigate to Cybersource/metadata/sfra_meta/sites/ and rename the yourSiteID folder to match your actual site identifier.
  2. Compress the sfra_metadata folder as a .zip file.
  3. Import it via Administration → Site Development → Site Import & Export.

This imports payment processors, payment methods, site preference groups, and Cybersource services.

Credentials and Endpoint

Navigate to Merchant Tools → Custom Preferences → Cybersource Core and enter:

  • Merchant ID
  • REST API Key or SOAP Key — your credentials from Step 2
  • API Endpoint — select Test for sandbox or Production for live
SFCC Cybersource Core Configuration

Step 6: Set Up Payment Methods

Navigate to Merchant Tools → Ordering → Payment Methods → CREDIT_CARD and verify the Payment Processor is set to CYBERSOURCE_CREDIT.

For Microform card capture, navigate to Merchant Tools → Site Preferences → Custom Preferences → Cybersource_SecureAcceptance and:

  • Set Secure Acceptance Type to SA_FLEX
  • Enter your REST Key ID and Shared Secret
  • Configure the CS Transaction Type based on your business requirements
SFCC Cybersource Core Configuration

After completing configuration, you can now take payments through Finix via our Cybersource Gateway Integration.

To learn more about our Cybersource Gateway Integration, you can read our guide.

If you need additional assistance contact support@finix.com.

Salesforce Commerce Cloud Transactions

When you run a transaction on Salesforce Commerce Cloud, you'll see it:

  • In your Business Manager admin under Merchant Tools → Ordering → Orders.
  • In the Cybersource Business Center.
  • In your Finix Dashboard under Transactions → Payments.

These transactions will be ingested by Finix and added to Settlements. To track transfers between Finix and Cybersource, please refer to our guide, here.