# SAP Commerce Cloud

Accept payments with Finix on [SAP Commerce Cloud](https://www.sap.com/products/crm/commerce-cloud.html).

SAP Commerce Cloud
## SAP Commerce Cloud Overview

SAP Commerce Cloud (formerly Hybris) is SAP's enterprise commerce platform built for B2B, B2C, and B2B2C brands. It delivers a unified commerce experience across web, mobile, and in-store channels — with tools for product catalog management, personalization, order management, and checkout. Cybersource is the only payment service provider natively integrated across three SAP commerce products. Finix integrates with SAP Commerce Cloud through the Cybersource payment gateway, enabling merchants to process payments and reconcile transaction data within their SAP Commerce environment.

### Finix Requirements

- Finix Live Account
- Active SAP Commerce Cloud tenant


## 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 SAP 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 SAP Commerce Cloud:
  - **Merchant ID** (also called Organization ID)
  - **REST API Key**


Cybersource Key Management
### Step 3: Set Up Your SAP Commerce Cloud Environment

Before proceeding, ensure your SAP Commerce Cloud environment is ready:

- SAP Commerce platform release **v2011**
- Java 11
- Maven repository with required dependencies
- Administrator access to your SAP Commerce Cloud landscape


### Step 4: Install the Cybersource Payment Plugin

Before you proceed, ensure you have:

- Approved Finix Merchant Account
- Cybersource Gateway Integration linked to your Finix Merchant Account
- Cybersource credentials from Step 2
- `sap-commerce-payment-plugin-3.2.0.zip` downloaded from Cybersource


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

There are two installation options: **Automated Installation** using a custom Gradle recipe, or **Manual Installation** for a step-by-step approach.

Automated Installation
Using a custom recipe, Gradle manages most of the configuration automatically.

1. Extract the SAP Commerce suite:



```bash
unzip sap-commerce-suite-2011.zip
```

1. Deploy the payment plugin extensions:



```bash
unzip sap-commerce-payment-plugin.zip -d sap-commerce-suite-2011
```

1. In `/resources/isvpaymentsampledata/import`, rename `.tpl` files to `.impex` and add your merchant details.
2. Run the installation recipe for your storefront type:



```bash
# B2C
./install.sh -r b2c_acc_isv

# B2B
./install.sh -r b2b_acc_isv
```

1. Initialize the platform and start the server:



```bash
./install.sh -r b2c_acc_isv initialize
./install.sh -r b2c_acc_isv start
```

Manual Installation
The manual approach requires individual file placement and configuration at each step.

1. Extract the SAP Commerce suite and install the B2C or B2B accelerator components.
2. Generate a storefront extension using the `extgen` tool.
3. Copy the payment plugin extensions into your project, maintaining the required folder structure.
4. Update `localextensions.xml` to include the Cybersource payment extensions.
5. Configure `local.properties` with your Java version and payment-specific settings.
6. Install the payment add-ons using Ant:



```bash
ant addoninstall -Daddonnames="isvpaymentaddon" -DaddonStorefront.yacceleratorstorefront="yb2cacceleratorstorefront"
```

1. Update your system hosts file for local DNS resolution:



```
# B2C
127.0.0.1 apparel-de.local apparel-uk.local

# B2B
127.0.0.1 powertools.local
```

1. Initialize the platform and start the server.


### Step 5: Configure the Cybersource Plugin

In your `local.properties` file, add the following merchant-specific configuration:


```properties
isv.payment.api.rest.runEnvironment=CyberSource.Environment.SANDBOX
isv.payment.api.rest.authenticationType=http_signature
isv.payment.api.rest.<merchant_id>.merchantKeyId=<your_REST_API_Key_ID>
isv.payment.api.rest.<merchant_id>.merchantsecretKey=<your_REST_API_Shared_Secret>
```

Replace `<merchant_id>`, `<your_REST_API_Key_ID>`, and `<your_REST_API_Shared_Secret>` with your credentials from Step 2. Set `runEnvironment` to `CyberSource.Environment.PRODUCTION` for live payments.

**PCI Strategy**

Set `site.pci.strategy` to your preferred card capture method:

- `FLEX` — Flex Microform (default, most secure)
- `HOP` — Secure Acceptance Web/Mobile
- `SOP` — Secure Acceptance Silent Order POST


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).

## SAP Commerce Cloud Transactions

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

- In your SAP Commerce Cloud Backoffice under **Order Management → 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).