# VTEX Integration

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

![VTEX](/assets/vtex-logo.bdd965f1da4b95c5fffa7f17851869d5611c1692b5ac1f8db0b3fdbb3c15ff5d.a7b6f700.png)

## VTEX Overview

VTEX is a global composable commerce platform serving 3,200+ enterprise customers including roughly 40% of the top global brands, with especially strong adoption in Latin America.

### Finix Requirements

- Finix Live Account
- Active VTEX 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 VTEX 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 VTEX.


### Step 3: Install the Cybersource App for VTEX

Install the Cybersource app from the VTEX App Store via **Apps → App Store**, then configure it from **Store Settings → Payment → Providers**.

- **VTEX setup guide:** [VTEX Help — Setting up Cybersource Gateway](https://help.vtex.com/docs/tutorials/setting-up-cybersource-gateway)


### Step 4: Configure VTEX

In your VTEX Admin:

1. Navigate to **Apps → Installed Apps → Cybersource → Configure**.
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 and assign the Cybersource affiliation to your store's payment condition.
5. Save the configuration.


For full details, refer to the [VTEX Cybersource setup guide](https://help.vtex.com/docs/tutorials/setting-up-cybersource-gateway).

### Step 5: Run a Test Transaction

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

## VTEX Transactions

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

- In your VTEX Admin under **Orders → All 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).