# commercetools Integration

Accept payments with Finix on [commercetools](https://commercetools.com).

![commercetools](/assets/commercetools-logo.0b906990dec93b157679703d3dcf63af9734a4adf8b242f23480eee8180ca403.a7b6f700.svg)

## commercetools Overview

commercetools is a headless, API-first, MACH-based commerce platform powering global enterprises with composable commerce experiences and serving roughly 200 enterprise customers.

### Finix Requirements

- Finix Live Account
- Active commercetools account


## 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 commercetools 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 commercetools.


### Step 3: Install the Cybersource commercetools Plugin

Cybersource publishes a commercetools plugin on GitHub. Install the `cybersource-plugins-commercetools` module in your commercetools project following the README.

- **Developer documentation:** [developer.cybersource.com/technology-partners/commercetools.html](https://developer.cybersource.com/technology-partners/commercetools.html)


### Step 4: Configure commercetools

In your commercetools Merchant Center:

1. Navigate to **Settings → Project settings → Payment**.
2. Add a new payment connector using the Cybersource plugin.
3. Enter the credentials from your Finix-provisioned Cybersource account:
  - Merchant ID
  - REST API Key ID
  - REST API Shared Secret
4. Select the environment (**Test** for sandbox, **Production** for live).
5. Save the configuration and deploy the plugin to your commercetools project.


For full details, refer to the [Cybersource commercetools integration guide](https://developer.cybersource.com/technology-partners/commercetools.html).

### Step 5: Run a Test Transaction

Place a test order through your commercetools 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).

## commercetools Transactions

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

- In your commercetools Merchant Center under **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).