opencart integration.md

OpenCart

Accept payments with Finix on OpenCart.

OpenCart Overview

OpenCart is a free, open-source eCommerce platform used by merchants worldwide to build and manage online stores. It offers a modular extension marketplace, multi-store and multi-language support, and a flexible admin panel for managing products, orders, and payments. Finix integrates with OpenCart through the Cybersource payment gateway, enabling merchants to accept payments directly within their OpenCart storefront and reconcile transaction data within their Finix Dashboard.

Finix Requirements

Integration

Step 1: Sign up for a Finix Account

To create a Finix account, you can follow our step-by-step guide or sign up directly for a live or sandbox account.

We recommend choosing Direct Merchant as your Customer Type.

Step 2: Create a Cybersource Gateway Integration

Finix supports OpenCart 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.
  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 OpenCart:
    • Merchant ID (also called Organization ID)
    • REST API Key

Step 3: Install the Cybersource Plugin

Before you proceed, ensure you have:

Download the official Cybersource plugin from the OpenCart Marketplace as a .zip file. For full installation details, refer to the Cybersource OpenCart developer documentation.

To install:

  1. In your OpenCart Back Office, navigate to Extensions → Installer.
  2. Click Upload and select the cybersource.ocmod.zip file.
  3. Confirm the upload progress reaches 100% and the file appears in the installed extensions list.
  4. Navigate to Extensions → Extensions and select Modules from the extension type dropdown.
  5. Locate Cybersource Configuration and click Install.

Step 4: Configure the Cybersource Plugin

Navigate to Extensions → Payments → Cybersource → Edit and enter the following:

General Configuration:

Report Configuration:

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.

If you need additional assistance contact support@finix.com.

OpenCart Transactions

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

These transactions will be ingested by Finix and added to Settlements. To track transfers between Finix and Cybersource, please refer to our guide, here.