PrestaShop 1.6 Setup

Learn how to connect your PrestaShop 1.6 store to BlueSnap for global payment processing.

348

PrestaShop provides an open source, e-commerce software that enables merchants to create and manage their online store. By connecting your store to BlueSnap, you’ll be able to securely accept card payments. And since the payment form is embedded in your checkout form, shoppers will enjoy a frictionless checkout experience. You’ll also have access to BlueSnap’s reporting, allowing you to dig into your critical e-commerce data.

Supported features

Auth/Capture
Chargeback Management
Fraud Prevention
   Built-in Fraud Prevention and Risk Management
   Enhanced fraud using Device Data Collector
Multiple Currencies and Multiple Languages
Partner Sandbox Testing
Payment Analytics and Reporting
Payment Methods: Credit/Debit Cards and Splitit
Payment Optimization
Vaulted Shoppers

Requirements

The BlueSnap module is supported for PrestaShop versions 1.5 and 1.6.

PrestaShop and BlueSnap accounts

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

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

PrestaShop software

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

 For PrestaShop 1.6 documentation, click here.
 For PrestaShop 1.5 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 for Prestashop. For more information, check out PrestaShop's documentation.

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: Install and upload the BlueSnap module

The BlueSnap module is available for download on Prestashop.

  1. Download the BlueSnap module to your machine.

  2. Log in to PrestaShop as an admin, and go to Modules and Services > Modules and Services.

  3. Click Add a new module.

627
  1. In Add a New Module section, click Choose a file, and select the BlueSnap module file.

  2. Click Upload this module.

631
  1. After the module has finished uploading, go to the Modules List section, and search for the BlueSnap module.

  2. Next to the module, click Install.

624

Step 3: Configure the BlueSnap module

If you're not there already, go to Modules and Services > Modules and Services (or Modules and Services > Payment) in your PrestaShop admin account.

  1. Locate the BlueSnap module and click Configure.
631
  1. Locate the URL in the BlueSnap configuration. You'll add this URL to your BlueSnap account in Step 5 when you set up IPNs.
632
  1. Configure the following settings:
SettingDescription
Sandbox mode Select Yes to work with your BlueSnap sandbox account. If yes, enter your Sandbox username and Sandbox password.

Select No to work with your BlueSnap production account.

Note: Set this to No when you are ready to start accepting live transactions.
Sandbox usernameEnter your API username for your BlueSnap Sandbox account.
Sandbox passwordLeave the field blank if you don't want to change your Sandbox API password.
Is Debug Mode Enabled Select Yes to have communications between PrestaShop and BlueSnap recorded in the log file which is located in modules/bluesnap. We recommend using this option during the development of your site or if you're experiencing any problems.

Select No to opt out of logging communications between PrestaShop and BlueSnap
UsernameEnter your API username for your BlueSnap Production account.
Note: Be sure to enter your Production API credentials in order to go live.
PasswordLeave this field blank if you don't want to change your API password.
Statement Soft DescriptorThis descriptor will appear on the shopper's billing statement to help them identify the purchase.
Enable Vaulted Shoppers Select Yes to allow logged-in shoppers the option to store their credit card details for future purchases.

Select No to disable this option.
Use BlueSnap Exchange Rate ConverterBe sure to select Yes. This feature enables BlueSnap's currency exchange rates to be used during transaction.
  1. Click Save.

Step 4: Set up Crontab

It is recommended that you add a line to your crontab. The crontab is an application that runs in the server operating the PrestaShop application, and is in charge of scheduled actions. It handles exchange rate updates to ensure that currency conversion is done with the most updated rates.

The crontab file is available to you in most UNIX/Linux based machines, and often can be found in /var/spool/cron. If you are not sure where your crontab file is, please reach out to your IT team or hosting provider for more details.

  1. From your admin account, go to Localization > Currencies.
  2. In the Automatically Update Currency Rates section, locate the URL.
619
  1. Add a line to your crontab file that will get the updated currency rates from the URL in the previous step. Make sure to schedule the task to run regularly (i.e. every 5 min).

📘

Updating currency rates after re-enabling the BlueSnap module

If you need to re-enable the BlueSnap module for any reason, we recommend that you complete the following steps after you've re-enabled the module. These steps ensure that the currency rates will be updated with BlueSnap's rates.

  1. In your PrestaShop admin account, go to Modules and Services > Modules and Services, and click Configure next to the BlueSnap module.
  2. On the configuration page, click Save.

Step 5: Set up IPNs

Instant Payment Notifications (IPNs), also known as webhooks, are HTTP POST messages that are sent to your PrestaShop account when an important event occurs. Follow the steps below to set up IPNs.

  1. Log in to your BlueSnap account and go to Settings > General Settings.

  2. In the Notifications section, select Receive Instant Payment Notifications.

  3. Update the IPN URL(s) field with the URL you obtained in Step 3.

  1. Click Submit.