OpenCart Setup

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

OpenCart provides an open source, ecommerce 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.

Supported features

3-D Secure
Built-in Fraud Prevention and Risk Management
Chargeback Management
Credit and Debit Card Processing
Hosted Payment Fields
Multiple Currencies
Multiple Languages
Payment Analytics and Reporting
Payment Optimization
Vaulted Shoppers

Requirements

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

OpenCart and BlueSnap accounts

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

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

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 need to ensure that your domain is SSL certified and SSL is enabled. 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

Complete these steps in your BlueSnap Console for production or sandbox.

  1. Get your BlueSnap API credentials and define the authorized IP addresses for your server. Both of these actions are performed on the same page; for instructions click here.

  2. To get paid, you need to configure your payout settings. Refer to Payout for more information.

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.

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”.

Reporting

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.

OpenCart Setup


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

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.