# Salesforce Commerce Cloud

Accept payments with Finix on [Salesforce Commerce Cloud](https://www.salesforce.com/commerce/).

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](/guides/getting-started/finix-sign-up) or [sign up](https://finix.payments-dashboard.com) 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](/guides/online-payments/gateway-integration/cybersource#creating-a-cybersource-integration-using-the-dashboard).
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](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000JfuFgUAJ).
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:



```json
{
  "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:



```bash
npm install sgmf-scripts
npm install copy-webpack-plugin
```

1. Compile cartridge assets:



```bash
npm run compile:js
npm run compile:scss
```

1. Upload the cartridge to your Salesforce Commerce Cloud instance:



```bash
npm run uploadCartridge
```

For full installation details, refer to the [Cybersource Salesforce Commerce Cloud developer documentation](https://developer.cybersource.com/technology-partners/salesforce-commerce-cloud.html).

### 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](/guides/online-payments/gateway-integration/cybersource).

If you need additional assistance contact [support@finix.com](mailto: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](/guides/online-payments/gateway-integration/cybersource#locating-cybersource-transactions).