OpenCart Setup

Learn how to connect OpenCart's eCommerce platform and BlueSnap's global payment gateway solution.

OpenCart provides an open source, e-commerce platform, which includes a product catalog, payments, shipping/tax, SEO optimization, and everything in between for you to effectively run your business. By connecting to BlueSnap, you’ll be able to securely process global credit and debit card payments, as well as utilize BlueSnap’s reporting capabilities to better understand and track your business.


The BlueSnap extension is supported for OpenCart versions 1.x, 2.x, and 3.x.

BlueSnap and OpenCart accounts

You must have accounts at both BlueSnap and OpenCart to proceed.

If you need a BlueSnap account, go to the BlueSnap site to get started.
If you need an OpenCart account, go to the OpenCart site to sign up.

OpenCart software

This guide assumes that you already have the OpenCart software installed and uploaded to your server.

For OpenCart's documentation, click here.

HTTPS configuration

BlueSnap requires a secure connection to process payments. You'll need to ensure that your domain is SSL certified and SSL is enabled for OpenCart. Click here to learn how.

Supported currencies

BlueSnap supports the currencies listed here. We recommend configuring your store to only accept currencies supported by BlueSnap.

Supported countries

BlueSnap supports the countries listed here. If a shopper is located in one of these supported countries, they will be able to purchase with the BlueSnap payment module.

PCI compliance

A PCI compliance of SAQ-A is required.

Step 1: Configure your BlueSnap account settings

Before you install the BlueSnap extension in OpenCart, complete these steps in your BlueSnap Production and/or Sandbox accounts:

  1. Set up your BlueSnap API Credentials and define the authorized IP address for your server. Make note of your API username and password. You'll need them in Step 3.

  2. Configure your payout settings.

Step 2: Download and install the BlueSnap extension

The BlueSnap extension is available for download on the OpenCart Marketplace.

  1. Go to the OpenCart Marketplace, and click DOWNLOAD next to the BlueSnap extension.
  1. If you're not logged in to your OpenCart account, you'll be asked to do so.

  2. In the Action column, click DOWNLOAD. The zip file will begin downloading to your machine, and it contains extension files for all the supported versions of OpenCart.

  3. Depending on your OpenCart version, copy the appropriate file contents to your web root folder.

  4. Log in to OpenCart as an admin, and go to Extensions > Payments.

  5. Next to the BlueSnap extension, click Install.

You're now ready to begin configuring the extension! Move on to the next step.

Step 3: Configure the BlueSnap extension

If you're not there already, go to Extensions > Payments in your OpenCart admin account.

  1. Click Edit next to the BlueSnap extension.

  2. Configure the following settings:



Select Sandbox for testing. Select Production when you're ready to start accepting live transactions.

Note: Make sure this is set to Production when you're ready to go live.


If you're working in Sandbox mode, enter your Sandbox API Username. If you're working in Production mode, enter your Production API username.

Note: Make sure to enter your Production credentials when you're ready to go live.


If you're working in Sandbox mode, enter your Sandbox API Password. If you're working in Production mode, enter your Production API Password.

Note: Make sure to enter your Production credentials when you're ready to go live.

Soft Descriptor

A descriptor that will appear on the shopper's billing statement to help them identify the purchase. Descriptors typically contain the business name and a support phone number.

Your Server IP

Your web server's IP. This IP will be whitelisted to allow communications between your server and BlueSnap.

Debug Enabled

Set this to Yes to have communications between BlueSnap and OpenCart logged. This is helpful during development to troubleshoot any issues that might come up.


Defines the minimum amount that an order’s total (in your store’s default currency) must reach for the BlueSnap payment module to become available.

Geo Zone

The geographic zone(s) that the BlueSnap payment module applies to. Shoppers in the selected geographic zone(s) will be able to purchase with the BlueSnap payment module.

Note: We recommend configuring this setting according to BlueSnap's supported countries.

When you're done, you can click the Play button on the top right of the page to verify your settings, or click the Save button to save your settings.

Locating Transactions

Every transaction attempt is logged to maintain a detailed history for order management and reconciliation.

Transactions can be located in one of two ways:

  1. via BlueSnap extension
  2. via Orders page

Locating transactions via BlueSnap extension

In the Transactions tab of the BlueSnap extension, you'll find a comprehensive list of transactions. With powerful filtering capabilities, you'll be able to quickly locate and view the details.

For a more detailed snapshot of a specific transaction, click the icon next to it.

Locating transactions via Orders page

In the Orders page, click the Action tab of the particular transaction to get a detailed snapshot.

Best practices & tips

Considering shopper impact of currency conversions

While transactions are placed in your store’s base currency, you might have your store configured to display product prices in multiple currencies. To account for any differences between the currency conversion rates used to display prices on your website and the rates used by the shopper’s issuing bank, we recommend including a note on your checkout page that informs shoppers of potential price variations. For example: “The price listed is approximate and may vary slightly”.


Use BlueSnap's reporting capabilities to gain a comprehensive understanding of your business through the detailed transaction and payout reports, through payment conversions reports, and much more. Reports can be viewed right in your BlueSnap Console or pulled via the Reporting API to be parsed or pushed to your third-party reporting tools.