# Drupal Commerce

Accept payments with Finix on [Drupal Commerce](https://drupalcommerce.org).

Drupal Commerce
## Drupal Commerce Overview

Drupal Commerce is a flexible, open-source eCommerce framework built on Drupal, trusted by thousands of developers to power content-rich commerce sites. It provides a highly customizable architecture for managing products, orders, payments, and promotions — making it a popular choice for organizations that need tight integration between their content management and commerce layers. Finix integrates with Drupal Commerce through the Cybersource payment gateway, enabling merchants to accept payments directly within their Drupal Commerce storefront and reconcile transaction data within their Finix Dashboard.

### Finix Requirements

- Finix Live Account
- Active Drupal Commerce site (Drupal 10.3 or later)


## 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 Drupal Commerce 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 Drupal Commerce:
  - **Merchant ID** (also called Organization ID)
  - **REST API Key**


Cybersource Key Management
### Step 3: Install the Cybersource Module

Before you proceed, ensure you have:

- Approved Finix Merchant Account
- Cybersource Gateway Integration linked to your Finix Merchant Account
- Cybersource credentials from Step 2
- Drupal Commerce site running Drupal 10.3 or later
- Composer installed


For full installation details, refer to the [commerce_cybersource module page](https://www.drupal.org/project/commerce_cybersource).

Run the following command to install the module:


```bash
composer require 'drupal/commerce_cybersource:^1.8'
```

Then enable the module in your Drupal admin under **Extend**.

### Step 4: Configure the Cybersource Payment Gateway

The `commerce_cybersource` module supports two integration methods: **Secure Acceptance Hosted Checkout (SAHC)** — an off-site redirect to CyberSource's hosted payment page, and **Flex Microform v2** — an on-site iframe that keeps customers on your storefront. Choose the method that best fits your PCI requirements.

In your Drupal admin:

1. Navigate to **Commerce → Configuration → Payment gateways**.
2. Click **Add payment gateway** and select **Cybersource**.
3. Enter the following credentials from Step 2:
  - **Merchant ID** — your Cybersource Organization ID
  - **REST API Key ID** — your REST Key ID
  - **REST API Shared Secret** — your REST Shared Secret
4. Select your **Integration method** (SAHC or Flex Microform v2).
5. Set the **Mode** to **Test** for sandbox or **Live** for production.
6. Save the configuration and clear the Drupal cache.


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).

## Drupal Commerce Transactions

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

- In your Drupal admin under **Commerce → 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).