OpenCart Setup

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

Requirements

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.

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:

Setting
Description

Mode

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.

Username

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.

Password

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.

Total

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.

OpenCart Setup

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