Skip to content

SAP Commerce Cloud

Accept payments with Finix on SAP Commerce Cloud.

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

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

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

  1. Extract the SAP Commerce suite:
unzip sap-commerce-suite-2011.zip
  1. Deploy the payment plugin extensions:
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:

# B2C
./install.sh -r b2c_acc_isv

# B2B
./install.sh -r b2b_acc_isv
  1. Initialize the platform and start the server:
./install.sh -r b2c_acc_isv initialize
./install.sh -r b2c_acc_isv start

Step 5: Configure the Cybersource Plugin

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

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.

If you need additional assistance contact 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.