{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"Oracle Commerce Cloud Integration","description":"Integrate Finix with Oracle 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/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":"Low-Code / No-Code","includeFiles":["low-code-no-code/**/*.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":[]},{"title":"Release Notes","includeFiles":["release-notes/**/*.md"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"oracle-commerce-cloud","__idx":0},"children":["Oracle Commerce Cloud"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accept payments with Finix on ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.oracle.com/cx/commerce/"},"children":["Oracle Commerce Cloud"]},"."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/oracle-commerce-cloud-logo.600d3a458f56de44ece1280bf1b42531ebfeadaa64754c0963771dbca9eac50e.a7b6f700.png","alt":"Oracle Commerce Cloud","withLightbox":true,"style":"width: 750px; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); border-radius: 8px"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"oracle-commerce-cloud-overview","__idx":1},"children":["Oracle Commerce Cloud overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Oracle Commerce Cloud is Oracle's enterprise SaaS commerce platform designed for mid-market and enterprise retailers running B2C and B2B storefronts. It offers a fully managed, cloud-native environment with built-in tools for catalog management, promotions, order management, and personalization. Cybersource is pre-integrated as the default payment gateway, making it straightforward to connect to Finix."]},{"$$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 Oracle 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 Oracle 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/company-integrations-tab-direct-merchant.122c2c1c825f4eae56179fbbab7dccd64e2a27d406350be889d295ab1b71122a.08ff7529.png","alt":"Cybersource Merchant Integrations","withLightbox":true,"style":"width: 100%; box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15); border-radius: 8px"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sign up for Cybersource. For detailed instructions, see the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/gateway-integration/cybersource#creating-a-cybersource-integration-using-the-dashboard"},"children":["Cybersource integration guide"]},"."]},{"$$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 Oracle 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 Keys"]}]}]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/cybersource-key-management.8ca4ad79eaed0ff8320a9a6c38bac88625381127fb749b31f80a4ec6c4f5b99b.08ff7529.png","alt":"Cybersource Key Management","withLightbox":true,"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-oracle-commerce-cloud-environment","__idx":6},"children":["Step 3: Set up your Oracle Commerce Cloud environment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before proceeding, ensure your local development environment meets the following requirements:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Node.js"]}," v18.16.1 (use ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://github.com/nvm-sh/nvm"},"children":["NVM"]}," to manage multiple versions)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yarn"]}," v1.22.4"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An active Oracle Commerce Cloud instance (OCC v23.11 or compatible)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-register-and-upload-the-payment-gateway-extension","__idx":7},"children":["Step 4: Register and upload the payment gateway extension"]},{"$$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":["Oracle Commerce Cloud instance with developer access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Node.js and Yarn installed per Step 3"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To install the extension:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log into your Oracle Commerce Cloud admin and navigate to Settings → Extensions → Developer tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click Generate ID, name your extension, and copy the generated ID into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages/payment-gateway/ext.json"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Zip all files in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["packages/payment-gateway"]}," directory (exclude ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settings.json"]},"), then navigate to Settings → Extensions and click Upload Extension to upload your zip file."]}]},{"$$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/OracleCommerceCloud.html"},"children":["Cybersource Oracle Commerce Cloud developer documentation"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-5-configure-the-cybersource-payment-gateway","__idx":8},"children":["Step 5: Configure the Cybersource payment gateway"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your Oracle Commerce Cloud admin, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Payment Processing"]},"."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment Gateways"]}," tab, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cybersource Official"]}," from the list, and check ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment Gateway Enabled"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your Finix-provisioned Cybersource credentials. This includes the Merchant ID and API Keys."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Return to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment Types"]}," tab and select the card brands you want to accept: Visa, Mastercard, Amex, Discover, Diners Club, JCB, Maestro, or others as needed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Web APIs → Function APIs"]}," and configure the Production and Preview webhooks, replacing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{env}"]}," placeholder with your environment value. Save the secret key for your SSE deployment."]}]},{"$$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":"oracle-commerce-cloud-transactions","__idx":9},"children":["Oracle Commerce Cloud transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you run a transaction on Oracle Commerce Cloud, you'll see it:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your Oracle Commerce Cloud admin under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/online-payments/gateway-integration/cybersource#locating-cybersource-transactions"},"children":["how to locate Cybersource transactions"]},"."]}]},"headings":[{"value":"Oracle Commerce Cloud","id":"oracle-commerce-cloud","depth":1},{"value":"Oracle Commerce Cloud overview","id":"oracle-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 Oracle Commerce Cloud environment","id":"step-3-set-up-your-oracle-commerce-cloud-environment","depth":3},{"value":"Step 4: Register and upload the payment gateway extension","id":"step-4-register-and-upload-the-payment-gateway-extension","depth":3},{"value":"Step 5: Configure the Cybersource payment gateway","id":"step-5-configure-the-cybersource-payment-gateway","depth":3},{"value":"Oracle Commerce Cloud transactions","id":"oracle-commerce-cloud-transactions","depth":2}],"frontmatter":{"seo":{"title":"Oracle Commerce Cloud Integration","description":"Integrate Finix with Oracle Commerce Cloud to accept card transactions via our Cybersource Gateway integration."},"keywords":{"includes":["oracle commerce cloud"]}},"lastModified":"2026-08-20T01:30:42.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/additional-resources/plugins/oracle-commerce-cloud-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}