{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition","tabs","tab"]},"type":"markdown"},"seo":{"title":"SAP Commerce Cloud Integration","description":"Integrate Finix with SAP Commerce Cloud to accept card transactions via our Cybersource Gateway integration.","siteUrl":"https://docs.finix.com/","llmstxt":{"hide":false,"sections":[{"title":"Getting Started","includeFiles":["guides/getting-started/**/*.md"],"excludeFiles":[]},{"title":"Online Payments","includeFiles":["guides/online-payments/**/*.md"],"excludeFiles":["guides/online-payments/payment-features/fsa-hsa-non-healthcare-mcc.md"]},{"title":"In-Person Payments","includeFiles":["guides/in-person-payments/**/*.md"],"excludeFiles":[]},{"title":"Subscriptions","includeFiles":["guides/subscriptions/**/*.md"],"excludeFiles":[]},{"title":"After the Payment","includeFiles":["guides/subscriptions/after-the-payment/**/*.md"],"excludeFiles":[]},{"title":"Managing Operations","includeFiles":["guides/managing-operations/**/*.md"],"excludeFiles":[]},{"title":"Platform Payments","includeFiles":["guides/platform-payments/**/*.md"],"excludeFiles":[]},{"title":"Payouts","includeFiles":["guides/payouts/**/*.md"],"excludeFiles":[]},{"title":"Developers","includeFiles":["additional-resources/developers/**/*.md"],"excludeFiles":[]},{"title":"Plugins","includeFiles":["additional-resources/plugins/**/*.md"],"excludeFiles":[]},{"title":"Industry Considerations","includeFiles":["guides/industry-considerations/**/*.md"],"excludeFiles":[]},{"title":"Regional Considerations","includeFiles":["guides/regional-considerations/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"sap-commerce-cloud","__idx":0},"children":["SAP Commerce Cloud"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accept payments with Finix on ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.sap.com/products/crm/commerce-cloud.html"},"children":["SAP Commerce Cloud"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/sap-commerce-cloud-logo.1a18444619096456bfddb2dc596595d1bdb81242f6132ecb60426c1f89489f5d.a7b6f700.png","alt":"SAP Commerce Cloud","withLightbox":false,"style":"width: 750px; height: auto"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sap-commerce-cloud-overview","__idx":1},"children":["SAP Commerce Cloud Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"finix-requirements","__idx":2},"children":["Finix Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Finix Live Account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Active SAP Commerce Cloud tenant"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration","__idx":3},"children":["Integration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-sign-up-for-a-finix-account","__idx":4},"children":["Step 1: Sign up for a Finix Account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a Finix account, you can follow our step-by-step ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/getting-started/finix-sign-up"},"children":["guide"]}," or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://finix.payments-dashboard.com"},"children":["sign up"]}," directly for a live or sandbox account."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":""},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend choosing Direct Merchant as your Customer Type."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-create-a-cybersource-gateway-integration","__idx":5},"children":["Step 2: Create a Cybersource Gateway Integration"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Cybersource Integration"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Finix supports SAP Commerce Cloud via our Cybersource Gateway integration. Please note that there is an additional fee for using our Cybersource integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information, please reach out to your Finix point of contact."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To create a Cybersource integration, navigate to the Integrations page on your Finix Dashboard."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/direct_merchant_integration_tab.e40b62fd3a5e39d86b2f89d2bf8f7474bcdd6785f5e5807355d8ee1230ac9de8.08ff7529.png","alt":"Cybersource Merchant Integrations","withLightbox":false,"style":"width: 100%; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); border-radius: 8px"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign up for Cybersource. You can view detailed instructions in our guide, ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/gateway-integration/cybersource#creating-a-cybersource-integration-using-the-dashboard"},"children":["here"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After accepting the Cybersource invitation email, retrieve the following credentials from the Cybersource Business Center under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment Configuration → Key Management"]}," — you'll need these to configure SAP Commerce Cloud:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant ID"]}," (also called Organization ID)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST API Key"]}]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/cybersource-key-management.8ca4ad79eaed0ff8320a9a6c38bac88625381127fb749b31f80a4ec6c4f5b99b.08ff7529.png","alt":"Cybersource Key Management","withLightbox":false,"style":"width: 100%; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); border-radius: 8px"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-set-up-your-sap-commerce-cloud-environment","__idx":6},"children":["Step 3: Set Up Your SAP Commerce Cloud Environment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before proceeding, ensure your SAP Commerce Cloud environment is ready:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["SAP Commerce platform release ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["v2011"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Java 11"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Maven repository with required dependencies"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Administrator access to your SAP Commerce Cloud landscape"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-install-the-cybersource-payment-plugin","__idx":7},"children":["Step 4: Install the Cybersource Payment Plugin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you proceed, ensure you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Approved Finix Merchant Account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cybersource Gateway Integration linked to your Finix Merchant Account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cybersource credentials from Step 2"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sap-commerce-payment-plugin-3.2.0.zip"]}," downloaded from Cybersource"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For full installation details, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.cybersource.com/technology-partners/SAP_CommerceCloud.html"},"children":["Cybersource SAP Commerce Cloud developer documentation"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two installation options: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Automated Installation"]}," using a custom Gradle recipe, or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manual Installation"]}," for a step-by-step approach."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Automated Installation","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using a custom recipe, Gradle manages most of the configuration automatically."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Extract the SAP Commerce suite:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"unzip sap-commerce-suite-2011.zip\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Deploy the payment plugin extensions:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"unzip sap-commerce-payment-plugin.zip -d sap-commerce-suite-2011\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/resources/isvpaymentsampledata/import"]},", rename ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".tpl"]}," files to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".impex"]}," and add your merchant details."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Run the installation recipe for your storefront type:"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# B2C\n./install.sh -r b2c_acc_isv\n\n# B2B\n./install.sh -r b2b_acc_isv\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Initialize the platform and start the server:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"./install.sh -r b2c_acc_isv initialize\n./install.sh -r b2c_acc_isv start\n","lang":"bash"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Manual Installation","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The manual approach requires individual file placement and configuration at each step."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Extract the SAP Commerce suite and install the B2C or B2B accelerator components."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Generate a storefront extension using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extgen"]}," tool."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the payment plugin extensions into your project, maintaining the required folder structure."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["localextensions.xml"]}," to include the Cybersource payment extensions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["local.properties"]}," with your Java version and payment-specific settings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Install the payment add-ons using Ant:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"ant addoninstall -Daddonnames=\"isvpaymentaddon\" -DaddonStorefront.yacceleratorstorefront=\"yb2cacceleratorstorefront\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":7},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update your system hosts file for local DNS resolution:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"# B2C\n127.0.0.1 apparel-de.local apparel-uk.local\n\n# B2B\n127.0.0.1 powertools.local\n"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":8},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Initialize the platform and start the server."]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5-configure-the-cybersource-plugin","__idx":8},"children":["Step 5: Configure the Cybersource Plugin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["local.properties"]}," file, add the following merchant-specific configuration:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"properties","header":{"controls":{"copy":{}}},"source":"isv.payment.api.rest.runEnvironment=CyberSource.Environment.SANDBOX\nisv.payment.api.rest.authenticationType=http_signature\nisv.payment.api.rest.<merchant_id>.merchantKeyId=<your_REST_API_Key_ID>\nisv.payment.api.rest.<merchant_id>.merchantsecretKey=<your_REST_API_Shared_Secret>\n","lang":"properties"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<merchant_id>"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<your_REST_API_Key_ID>"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<your_REST_API_Shared_Secret>"]}," with your credentials from Step 2. Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["runEnvironment"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CyberSource.Environment.PRODUCTION"]}," for live payments."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PCI Strategy"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site.pci.strategy"]}," to your preferred card capture method:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FLEX"]}," — Flex Microform (default, most secure)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HOP"]}," — Secure Acceptance Web/Mobile"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SOP"]}," — Secure Acceptance Silent Order POST"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After completing configuration, you can now take payments through Finix via our Cybersource Gateway Integration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn more about our Cybersource Gateway Integration, you can read our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/gateway-integration/cybersource"},"children":["guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need additional assistance contact ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"mailto:support@finix.com"},"children":["support@finix.com"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sap-commerce-cloud-transactions","__idx":9},"children":["SAP Commerce Cloud Transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you run a transaction on SAP Commerce Cloud, you'll see it:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your SAP Commerce Cloud Backoffice under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Order Management → Orders"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the Cybersource Business Center."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your Finix Dashboard under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transactions"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payments"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These transactions will be ingested by Finix and added to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Settlements"]},". To track transfers between Finix and Cybersource, please refer to our guide, ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/gateway-integration/cybersource#locating-cybersource-transactions"},"children":["here"]},"."]}]},"headings":[{"value":"SAP Commerce Cloud","id":"sap-commerce-cloud","depth":1},{"value":"SAP Commerce Cloud Overview","id":"sap-commerce-cloud-overview","depth":2},{"value":"Finix Requirements","id":"finix-requirements","depth":3},{"value":"Integration","id":"integration","depth":2},{"value":"Step 1: Sign up for a Finix Account","id":"step-1-sign-up-for-a-finix-account","depth":3},{"value":"Step 2: Create a Cybersource Gateway Integration","id":"step-2-create-a-cybersource-gateway-integration","depth":3},{"value":"Step 3: Set Up Your SAP Commerce Cloud Environment","id":"step-3-set-up-your-sap-commerce-cloud-environment","depth":3},{"value":"Step 4: Install the Cybersource Payment Plugin","id":"step-4-install-the-cybersource-payment-plugin","depth":3},{"value":"Step 5: Configure the Cybersource Plugin","id":"step-5-configure-the-cybersource-plugin","depth":3},{"value":"SAP Commerce Cloud Transactions","id":"sap-commerce-cloud-transactions","depth":2}],"frontmatter":{"seo":{"title":"SAP Commerce Cloud Integration","description":"Integrate Finix with SAP Commerce Cloud to accept card transactions via our Cybersource Gateway integration."},"keywords":{"includes":["sap commerce cloud","hybris"]}},"lastModified":"2026-04-25T00:54:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/additional-resources/plugins/sap-commerce-cloud-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}