Accept cards, ACH, Apple Pay and Google Pay, along with support for WooCommerce Subscriptions and Pre-orders on a global payments gateway.
Why use the BlueSnap Payment Gateway for WooCommerce
A secure and frictionless checkout flow
The BlueSnap Payment Gateway for WooCommerce uses our Hosted Payment Fields to provide you with a seamless, PCI-compliant checkout experience that works within any browser or device. Our Hosted Payment Fields silently collect your shopper’s sensitive payment data on BlueSnap servers without interrupting the checkout flow.
Sell and settle in multiple currencies
A simple way to help your shoppers complete their purchase is to offer your products in the currency of your shoppers. The BlueSnap Payment Gateway allows your shoppers to checkout in 100 different currencies and, as an added benefit, using the BlueSnap Payment Gateway gets you access to our connections to 30 global banks. When your shopper completes their purchase, BlueSnap paves the most efficient path to payment success by routing the transaction to the most appropriate local bank for your shopper, minimizing decline rates and maximizing revenue gains.
Once the sale is complete and you need to get paid, BlueSnap works with you by offering the option to get money into your account in one of our 17 like-for-like payout currencies.
Fraud Protection and 3D Secure
The BlueSnap Payment Gateway offers Kount Fraud protection right from the plugin to best optimize the checkout flow. We also provide the option to select advanced fraud options if you want to customize your level of fraud screening.
In addition, as you sell to shoppers around the world, you will likely run into a location where you are required to support a 3D Secure checkout experience. The BlueSnap Payment Gateway has built-in support for 3DS so you aren’t out of compliance in the regions where this is mandatory.
Full support for Subscriptions and Pre-Orders
The BlueSnap Payment Gateway provides support for WooCommerce Subscriptions, offering support for all of subscription features, including payment date changes, subscription date changes, and more. The gateway also fully supports WooCommerce Pre-Orders, so you can take customer’s payment information upfront and then automatically charge their payment method once the pre-order is released.
We recommend that you use the following versions when using the BlueSnap plugin for WooCommerce. The plugin may work when using older versions of PHP and MySQL as well; however, the following versions have been tested to ensure compatibility.
* PHP: 7.4 or later
* MySQL: 5.6 or later
* WordPress: 5.2.4 or later
* WooCommerce: 3.7 or later
* WooCommerce Pre-Orders: 1.5.16 or later
* WooCommerce Subscriptions: 3.0 or later
This guide assumes that you have:
* A working WordPress platform
WooCommerce is a WordPress plugin that is installed on top of the WordPress platform. If you do not 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.
WooCommerce software installed and uploaded to your server.
If you need the plugin, go to: https://wordpress.org/plugins/woocommerce/ or to http://www.woothemes.com/woocommerce/ to download the WooCommerce plugin.
If you want to use the Pre-Orders or Subscription functionalities, make sure that the respective plugins are also installed in your WordPress website:
A PCI compliance of SAQ-A is required.
Setup Steps
Before you install the BlueSnap extension, complete these steps in your BlueSnap account:
1. Set up your BlueSnap API Credentials(https://developers.bluesnap.com/v8976-Basics/docs/api-credentials). Make note of your API username and password; you need them in later steps.
Define the authorized IP address for your server.
Configure your payout settings (https://support.bluesnap.com/docs/payout-method).
Install the BlueSnap Payment Gateway plugin, as follows:
1. In WordPress, 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 for WooCommerce plugin and install it.
Click Plugins > Installed Plugins in the left menu.
In the installed plugin screen, activate the following plugins, in this order:
Important
If these are not activated in the specified order, the installation will not complete properly.
Configure the default currency settings for WooCommerce by completing the following steps:
1. Go to WooCommerce > Settings > General.
Scroll down to Currency Options and set the values as necessary.
Click Save Changes.
Configure the BlueSnap plugin using the following steps:
1. Click the Settings link below the BlueSnap plugin. The BlueSnap page opens.
Note: You can find your BlueSnap information (API credentials, Merchant ID, and more) for the following settings in your BlueSnap Merchant Console in Settings > API Settings.
Ensure that you are using secure checkout by completing the following steps.
1. Go to WordPress > Settings > General.
https://
: Instant Payment Notifications (IPNs) are webhooks that trigger an HTTP POST message to your WooCommerce account when an important event occurs. Follow the steps below to set up IPNs.
Log in to your BlueSnap account and go to Settings > IPN Settings.
Select the Receive Instant Payment Notifications check box.
Update the IPN URL(s) field. The format of the URL should follow this pattern:
https://www.yourdomain.com/?wc-api=bluesnap
To enable specific IPNs, click Select IPNs. In the section that opens, toggle the button next to the IPN to select it. We recommend enabling the following IPN types:
If you plan to offer ACH as a payment method for subscriptions, make sure to select the Send Subscription Charge Failure IPN.
Click Submit.
For more information on IPNs, refer to our IPN documentation.
We recommend 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, and handles pre-orders.
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, reach out to your IT team or hosting provider for more details.
You should add the following line to your crontab file:
*/15 * * * * {wget path} -q -O – {Web domain of your WooCommerce Store}/ wp-cron.php?doing_wp_cron
For example: */15 * * * * /usr/bin/wget -q -O - http://shoppingcarts.bluesnap.com/wordpress/wp-cron.php?doing_wp_cron
If you have multiple WooCommerce Stores running on the same server, you should add this line for each one of them.
Note: */15
makes the crontab run every 15 minutes. You can use this to change the cron frequency.
For additional help, contact BlueSnap Merchant Support (https://bluesnap.zendesk.com/hc/en-us/requests/new?ticket_form_id=360000127087).
Styling your payment form
BlueSnap supports the ability to customize the card elements (such as text color or font size) of the payment form. To do this, edit the BlueSnap plugin’s JavaScript by creating a bluesnapStyleOverrides object that contains your styling. See Supported selectors and Supported CSS properties for details https://developers.bluesnap.com/v8976-Tools/docs/hosted-payment-fields#section-supported-css-properties. Use the code below as a starting point.
const bluesnapStyleOverrides = { '.invalid': { //style all invalid elements color: 'red' }, '.valid': { //style all valid elements color: 'green' }, ':focus': { //style all elements on the focus event color: 'orange' }, '#ccn': { //style only the card number element color: 'blue' }, '#cvv': { //style only the CVV element 'font-size': '30px' } };
Customizing error messages
BlueSnap allows you to customize the messages of any errors that occur, giving you full control over the error descriptions that display in the UI or in error logs. To use this feature, you will need to add custom code to your WooCommerce account. We recommend using a plugin such as Code Snippets to accomplish this.
Use the code sample below as a starting point. You can change error descriptions and add/remove errors from the code below.
add_filter( 'wc_gateway_bluesnap_api_errors', function ( $errors ) { $errors = array( '10000|INVALID_API_VERSION' => __( 'API version is not correct...', 'woocommerce-bluesnap-gateway' ), '10001|VALIDATION_GENERAL_FAILURE' => __( 'This is a val.gen. failure error.', 'woocommerce-bluesnap-gateway' ), '14002' => __( 'This is the new error message for 14002', 'woocommerce-bluesnap-gateway' ), '14002|SYSTEM_TECHNICAL_ERROR' => __( 'This is the new error message for 14002|SYSTEM_TECHNICAL_ERROR', 'woocommerce-bluesnap-gateway' ), '14016' => __( 'This is the new error message for 14016', 'woocommerce-bluesnap-gateway' ), ); return $errors; } );
Managing orders
If card charges are not automatically captured, they will result in authorizations that need to be captured later. For example, if you sell physical goods, you will need to capture the authorization when the items are ready to be shipped out. Orders can be conveniently managed from your WooCommerce account by following these steps:
1. Go to WooCommerce > Orders and click the order that you want to manage. The order’s status will be On hold.
Note: ACH charges will also have a status of On hold. You don’t need to capture these charges.
2. In the Status dropdown, select one of the following:
If you want to capture the authorization, select Processing or Completed.
If you want to cancel the authorization, select Cancelled.
For the most recent version of these instructions, refer to https://support.bluesnap.com/docs/woocommerce
Requirements