Support

Recent Posts

Archive

WooCommerce Setup

WooCommerce is an open source, e-commerce platform for businesses around the globe. Connect your WooCommerce store to BlueSnap to benefit from the ability to accept card payments worldwide. Note that you can connect multiple WooCommerce stores (i.e. domains) to a single BlueSnap account for streamlined account management. You can also connect other shopping carts to the same BlueSnap account.

Step 1: Plugin Installation and Configuration

Make sure you have a working WordPress platform. WooCommerce is a WordPress plugin that is installed on top of the WordPress platform. If you don't yet have a working WordPress installation, you may want to contact your website hosting provider, as many of them supply a quick-install process for WordPress.

Install the BlueSnap Payment Gateway plugin on top of your WordPress platform. Click Plugins > Add New in the left menu. Search for BlueSnap in the search box in the top right side. Click the BlueSnap Payment Gateway plugin and install it.

Now you are ready to activate the plugins. Click Plugins > Installed Plugins in the left menu. In the installed plugin screen, activate the following plugins, in this order:

WooCommerce

WooCommerce Subscriptions (optional)

WooCommerce Pre-Orders (optional)

BlueSnap Payment Gateway

Important

In order for the installation to be performed properly, you must activate them in the order listed above.

Verify that your WooCommerce installation complies with what is described in the filename section in https://docs.woothemes.com/document/jquery-cookie-fails-to-load/.Otherwise, your shoppers might experience errors that will prevent their transactions from going through.In addition, please check that there are no Javascript errors in your browser’s console (usually accessed via F12 on Windows or command+option+i on MAC-OS).

Step 2: Setting the Default Currency

Step 3: Currency Conversion Configuration

BlueSnap works with many currencies (see a complete list here). The BlueSnap plugin for WooCommerce includes a built-in currency converter that you must configure in order to enable successful purchasing via BlueSnap. Follow these steps:

In the left menu of the WooCommerce admin console, go to WooCommerce > Settings.

From this page, select "Checkout" on the top tab, and "BlueSnap Card Payments" from the options within this page.

Verify that the Enable BlueSnap currency converter checkbox is selected.

Select the currencies to use in your store. Make sure you select all the currencies that the WooCommerce store supports.

Step 4: Force secure checkout (SSL)

In order to use BlueSnap, you must use SSL and force secure checkout in WooCommerce.

There are two methods available:

Setup for WooCommerce versions earlier than 3.4

Setup for WooCommerce versions 3.4 and later

Please complete these two requirements for versions earlier than 3.4:

Install SSL on your server.

In WooCommerce, go to Settings > Checkout and select the Force secure checkout option. This means that WooCommerce will force an SSL check.

For versions 3.4 and above, please complete the following requirements:

Install SSL on your server.

In WooCommerce, go to Settings > Advanced and set the woocommerce_force_ssl_checkout option to "yes."

If applicable, set up the woocommerce_force_ssl_checkout option to display while the site is loading via HTTPS; otherwise, it will be hidden (see explanation below).

Important

The Force SSL option only appears if the site is not already loading via HTTPS.

If the site does load over HTTPS, the Force SSL option will be hidden. If you’d like to toggle this option regardless of whether the site is loading via HTTPS, then go to https://<yourwebsite.com>/wp-admin/options.php and set the woocommerce_force_ssl_checkout option to either Yes or No. (Remember to change <yourwebsite.com> to your actual domain.)

For example, the following screen shot of the options.php page displays where you can toggle the option:

Caution

Only advanced users should use the options.php page – it allows you to change settings directly on your database, so make a backup before making this change.

Step 5: Crontab Setup

It is recommended that you add a line to your crontab. The crontab is an application that runs in the server operating the WordPress application, and is in charge of periodic actions. It ensures that subscriptions continue to charge on time even if your WooCommerce store has no traffic, stores automatic renewals, handles pre-orders, and handles rate updates and log cleanups.

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.

Best Practices & Tips

Base Currency

BlueSnap enables you to take payments in multiple currencies. Each store has a single base currency, in which you define the price of your products.

Tip

We do not recommend changing the store’s base currency.

If you allow your shoppers to place an order in a different currency, the price is converted from your base currency and the shoppers pay the amount they see in their local currency. You will then see this sale reported in your dashboard in your base currency, via BlueSnap conversion rates. If this is an ongoing subscription, your shoppers will keep paying the same amount in their selected currency. This means you will receive a different amount (in your base currency) with each payment.

When your shoppers access their account via “My Account”, they will see their previous purchases listed in the store’s base currency, which may be different from the currency they paid in. The shopper will be able to see the currency and price they paid in only if they access a specific order.

Tip

You may want to consider having different stores, each with a different base currency, so you can view the sales amounts correctly in each currency.

Supported Currencies

Some card brands have restrictions regarding the currencies they can process. If the transaction fails due to unsupported currency, it is most likely due to the shopper attempting a combination of card type and currency that is not available. Visa and Mastercard should work with most currencies. Please note that Brazilian Real is not supported.

Refunds & Cancellations

All refunds and cancellations must be performed directly through the shopping cart console to avoid having WooCommerce and BlueSnap out of sync with each other.Note: Pending orders that you cancel in WooCommerce will still appear to be pending in BlueSnap, although they are in fact cancelled.

Supported WooCommerce Plugins

WooCommerce Pre-Orders, for capturing payment information prior to product availability, and then processing those payments automatically when the pre-order becomes available.Note: Uncaptured authorizations/pre-orders will expire after 7 days. If you are unable to deliver during the 7 days you'll need to perform a subsequent authorization.

Process Logs

Process logs can be a useful tool for developers, particularly for troubleshooting. To access process logs for the BlueSnap plugin, go to WooCommerce > System Status. Once on this page, select the Logs tab.