# Drupal Commerce Integration

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

![Drupal Commerce](/assets/drupal-commerce-logo.b7d39791792f089767172914bb7350ca870396bc6a7373db7fb261d433485bb2.a7b6f700.svg)

## Drupal Commerce Overview

Drupal Commerce is a leading flexible open-source eCommerce framework built on Drupal, contributed to by thousands of developers to power content-rich commerce sites.

### Finix Requirements

- Finix Live Account
- Active Drupal Commerce site (Drupal 9 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 your Cybersource Merchant ID and REST API keys from the Cybersource Business Center — you'll need these to configure Drupal Commerce.


### Step 3: Install the Cybersource Module for Drupal Commerce

Install the `commerce_cybersource` module from Drupal.org using Composer or the Drupal admin UI, then enable the module.

- **Module page:** [drupal.org/project/commerce_cybersource](https://www.drupal.org/project/commerce_cybersource)


### Step 4: Configure Drupal Commerce

In your Drupal admin:

1. Navigate to **Commerce → Configuration → Payment gateways → Add payment gateway → Cybersource**.
2. Enter the credentials from your Finix-provisioned Cybersource account:
  - Merchant ID
  - REST API Key ID
  - REST API Shared Secret
3. Select the environment (**Test** for sandbox, **Production** for live).
4. Enable the payment methods you want to offer.
5. Save the configuration and clear the Drupal cache.


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

### Step 5: Run a Test Transaction

Place a test order through your Drupal Commerce storefront to verify the integration. The payment will route through Cybersource and be captured by Finix for settlement.

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 (transactions appear after 24 hours).
- In your Finix Dashboard under **Transactions** → **Payments**, with the **Integration** field set to `Cybersource`.


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