# Oracle Commerce Cloud

Accept payments with Finix on [Oracle Commerce Cloud](https://www.oracle.com/cx/commerce/).

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](/guides/getting-started/finix-sign-up) or [sign up](https://finix.payments-dashboard.com) 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
1. Sign up for Cybersource. You can view detailed instructions in our guide, [here](/guides/online-payments/gateway-integration/cybersource#creating-a-cybersource-integration-using-the-dashboard).
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 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](https://github.com/nvm-sh/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](https://developer.cybersource.com/technology-partners/OracleCommerceCloud.html).

### 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](/guides/online-payments/gateway-integration/cybersource).

If you need additional assistance contact [support@finix.com](mailto: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, please refer to our guide, [here](/guides/online-payments/gateway-integration/cybersource#locating-cybersource-transactions).