{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"Salesforce Commerce Cloud Integration","description":"Integrate Finix with Salesforce 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":"salesforce-commerce-cloud","__idx":0},"children":["Salesforce Commerce Cloud"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accept payments with Finix on ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.salesforce.com/commerce/"},"children":["Salesforce Commerce Cloud"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/salesforce-billing-logo.c41c746f835701b95930dcadde7e459a25191b74339df7a0a80290e62e4059fe.a7b6f700.png","alt":"Salesforce Billing","withLightbox":false,"style":"width: 600px; height: auto; display: block; margin: 0 auto"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"salesforce-commerce-cloud-overview","__idx":1},"children":["Salesforce Commerce Cloud Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$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 Salesforce B2C Commerce Cloud instance"]}]},{"$$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 Salesforce 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 Salesforce 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 Shared Secret Key and Key ID"]}," (required for Microform)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SOAP Toolkit Key"]}," (used for all other integrations)"]}]}]}]},{"$$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-salesforce-commerce-cloud-environment","__idx":6},"children":["Step 3: Set Up Your Salesforce Commerce Cloud Environment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before proceeding, ensure your environment is ready:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Active Salesforce Commerce Cloud subscription"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store Front Reference Architeciture (SFRA) ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["app_storefront_base"]}," cartridge installed and configured"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-install-and-upload-the-cybersource-cartridge","__idx":7},"children":["Step 4: Install and Upload the Cybersource Cartridge"]},{"$$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":["Salesforce Commerce Cloud instance with developer access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Node.js and npm installed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To install the cartridge:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the integration package from ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://appexchange.salesforce.com/appxListingDetail?listingId=a0N4V00000JfuFgUAJ"},"children":["Salesforce AppExchange"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cybersource"]}," folder in your project workspace and place the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["int_cybersource_sfra"]}," cartridge inside it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dw.json"]}," file with your SFCC instance credentials for IDE integration:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"hostname\": \"your-sandbox-hostname.demandware.net\",\n  \"username\": \"yourlogin\",\n  \"password\": \"yourpwd\",\n  \"version\": \"version_to_upload_to\",\n  \"cartridge\": [\n    \"int_cybersource_sfra\",\n    \"app_storefront_base\",\n    \"modules\"\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":4},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Install ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sgmf-scripts"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["copy-webpack-plugin"]}," with the following commands:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npm install sgmf-scripts\nnpm install copy-webpack-plugin\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Compile cartridge assets:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npm run compile:js\nnpm run compile:scss\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload the cartridge to your Salesforce Commerce Cloud instance:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npm run uploadCartridge\n","lang":"bash"},"children":[]},{"$$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/salesforce-commerce-cloud.html"},"children":["Cybersource Salesforce Commerce Cloud developer documentation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5-configure-salesforce-commerce-cloud-cartridge","__idx":8},"children":["Step 5: Configure Salesforce Commerce Cloud Cartridge"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the cartridge is uploaded, complete the following configuration in Business Manager:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cartridge Path"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Administration → Sites → Manage Sites → [Your Site] → Settings"]}," and add the following to your cartridge path:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"int_cybersource_sfra:app_storefront_base\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Import Metadata"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the downloaded package, navigate to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cybersource/metadata/sfra_meta/sites/"]}," and rename the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["yourSiteID"]}," folder to match your actual site identifier."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Compress the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sfra_metadata"]}," folder as a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".zip"]}," file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Import it via ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Administration → Site Development → Site Import & Export"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This imports payment processors, payment methods, site preference groups, and Cybersource services."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Credentials and Endpoint"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Tools → Custom Preferences → Cybersource Core"]}," and enter:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant ID"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST API Key"]}," or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SOAP Key"]}," — your credentials from Step 2"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API Endpoint"]}," — select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Test"]}," for sandbox or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Production"]}," for live"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/sfcc-cybersource-core-config.d34624ad7f7f01261b3ddc17fbb4b95be8dcbf91569ae512ea1a427e5979b35b.08ff7529.png","alt":"SFCC Cybersource Core Configuration","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-6-set-up-payment-methods","__idx":9},"children":["Step 6: Set Up Payment Methods"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Tools → Ordering → Payment Methods → CREDIT_CARD"]}," and verify the Payment Processor is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CYBERSOURCE_CREDIT"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Microform card capture, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Tools → Site Preferences → Custom Preferences → Cybersource_SecureAcceptance"]}," and:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secure Acceptance Type"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SA_FLEX"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["REST Key ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shared Secret"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CS Transaction Type"]}," based on your business requirements"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/sfcc-payment-method-setup.27b9644c7557886ad5f97219f629c88fb3b53478df3705a6e6f21958e4fbde93.08ff7529.png","alt":"SFCC Cybersource Core Configuration","withLightbox":false,"style":"width: 100%; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); border-radius: 8px"},"children":[]},{"$$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":"salesforce-commerce-cloud-transactions","__idx":10},"children":["Salesforce Commerce Cloud Transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you run a transaction on Salesforce Commerce Cloud, you'll see it:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your Business Manager admin under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant Tools → Ordering → 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":"Salesforce Commerce Cloud","id":"salesforce-commerce-cloud","depth":1},{"value":"Salesforce Commerce Cloud Overview","id":"salesforce-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 Salesforce Commerce Cloud Environment","id":"step-3-set-up-your-salesforce-commerce-cloud-environment","depth":3},{"value":"Step 4: Install and Upload the Cybersource Cartridge","id":"step-4-install-and-upload-the-cybersource-cartridge","depth":3},{"value":"Step 5: Configure Salesforce Commerce Cloud Cartridge","id":"step-5-configure-salesforce-commerce-cloud-cartridge","depth":3},{"value":"Step 6: Set Up Payment Methods","id":"step-6-set-up-payment-methods","depth":3},{"value":"Salesforce Commerce Cloud Transactions","id":"salesforce-commerce-cloud-transactions","depth":2}],"frontmatter":{"seo":{"title":"Salesforce Commerce Cloud Integration","description":"Integrate Finix with Salesforce Commerce Cloud to accept card transactions via our Cybersource Gateway integration."},"keywords":{"includes":["salesforce commerce cloud","sfcc","demandware"]}},"lastModified":"2026-05-14T20:16:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/additional-resources/plugins/salesforce-commerce-cloud-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}