Skip to content

Oracle Commerce Cloud

Accept payments with Finix on Oracle Commerce Cloud.

Oracle Commerce Cloud

Oracle Commerce Cloud overview

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.

Finix requirements

  • Finix Live Account
  • Active Oracle Commerce Cloud instance

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 Oracle 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
  2. Sign up for Cybersource. For detailed instructions, see the Cybersource integration guide.
  3. 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 Oracle Commerce Cloud:
    • Merchant ID (also called Organization ID)
    • REST API Keys
Cybersource Key Management

Step 3: Set up your Oracle Commerce Cloud environment

Before proceeding, ensure your local development environment meets the following requirements:

  • Node.js v18.16.1 (use NVM to manage multiple versions)
  • Yarn v1.22.4
  • An active Oracle Commerce Cloud instance (OCC v23.11 or compatible)

Step 4: Register and upload the payment gateway extension

Before you proceed, ensure you have:

  • Approved Finix Merchant Account
  • Cybersource Gateway Integration linked to your Finix Merchant Account
  • Oracle Commerce Cloud instance with developer access
  • Node.js and Yarn installed per Step 3

To install the extension:

  1. Log into your Oracle Commerce Cloud admin and navigate to Settings → Extensions → Developer tab.
  2. Click Generate ID, name your extension, and copy the generated ID into packages/payment-gateway/ext.json.
  3. Zip all files in the packages/payment-gateway directory (exclude settings.json), then navigate to Settings → Extensions and click Upload Extension to upload your zip file.

For full installation details, refer to the Cybersource Oracle Commerce Cloud developer documentation.

Step 5: Configure the Cybersource payment gateway

In your Oracle Commerce Cloud admin, navigate to Settings → Payment Processing.

  1. Select the Payment Gateways tab, choose Cybersource Official from the list, and check Payment Gateway Enabled.
  2. Enter your Finix-provisioned Cybersource credentials. This includes the Merchant ID and API Keys.
  3. Return to the Payment Types tab and select the card brands you want to accept: Visa, Mastercard, Amex, Discover, Diners Club, JCB, Maestro, or others as needed.
  4. Navigate to Settings → Web APIs → Function APIs and configure the Production and Preview webhooks, replacing the {env} placeholder with your environment value. Save the secret key for your SSE deployment.

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.

Oracle Commerce Cloud transactions

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

  • In your Oracle Commerce Cloud admin under 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, see how to locate Cybersource transactions.