Drupal Setup

Learn how to connect your BlueSnap and Drupal accounts

Drupal is web publishing software you can use to create your website or blog and has become one of the most popular web publishing platforms, powering 30% of the entire web. It’s a highly flexible content management system (CMS) that enables you to build and manage your website using just your web browser. By connecting your store to BlueSnap, you can securely accept card payments. Because the payment form is embedded in your checkout form, shoppers enjoy a frictionless checkout experience.

Supported Features

Auth/Capture and Separate Auth and Capture
Chargeback Management
Fraud Prevention
Built-in Fraud Prevention and Risk Management
Enhanced fraud using Device Data Collector
Hosted Payment Fields
Level 2/3 Data compliant
Merchant-Managed Subscriptions
Multiple Currencies and Multiple Languages
Partner Sandbox Testing
Payment Analytics and Reporting
Payment Methods: ACH/ECP and Credit/Debit Cards
Payment Optimization
Statement Descriptor
Vaulted Shopper


The BlueSnap module is supported for Drupal version 8.0 and later.

BlueSnap Account

If you need a BlueSnap account, go to the BlueSnap website to get started.

Drupal Software

This guide assumes that you already have Drupal set up on your server. For instructions, refer to Drupal Support.

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 Drupal. For more information, refer to Drupal Support.

Supported Currencies

BlueSnap supports the currencies listed here.

PCI Compliance

PCI compliance of SAQ-A is required.

Drupal Setup

Step 1: Download the BlueSnap Module

  1. Go to https://www.drupal.org/project/commerce_bluesnap

  2. Download the module and install it in your Drupal Commerce Store.

Step 2: Configure your BlueSnap account settings

Complete these steps in your Merchant Portal for production or sandbox.

  1. Set up your BlueSnap API Credentials and define the IP address of your server. Make note of your API user key and password; you need them to configure your Drupal account.

    Note: If you are unable to provide static IPs for your servers, contact BlueSnap Merchant Support so we can disable IP checking on your account.

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

Step 3: Configure the BlueSnap gateways in Drupal

Complete these steps in your Drupal account. Note: You need your gateway credentials from BlueSnap for this.

  1. Go to Commerce > Configuration > Payment > Payment gateways.

  2. Click Edit in the OPERATIONS column for BlueSnap Card Processing.

  3. Choose Test or Live in the Mode section based on your need. If you choose Test, you must change it to Live to begin processing transactions.

  4. Enter your API user key and password.

  5. If you want to define your Statement Descriptor inside of Drupal, click on Statement Descriptor and enter your description. If you leave this section empty, the statement descriptor set inside of the Merchant Portal will be used.

    Note: There is a 20 character limit for the statement descriptor.

  6. Scroll to the bottom of the screen and select Enabled in the Status section.

  7. Click Save.

  8. Repeat the process for the BlueSnap ACH/ECP gateway.



You must enable both the BlueSnap Card Processing and the BlueSnap ACH/ECP gateway.

Step 4: Configure the BlueSnap gateways in Drupal

Complete these steps in your Drupal account.

  1. Go to Commerce > Configuration > Store > Stores.

  2. Click Edit in the OPERATIONS column for Online Store.

  3. In the BlueSnap Configuration section, complete the following fields as applicable to your system:

    • Enable enhanced data level processing — If you enable this option, you must select either Level 2 or Level 3 processing.

    • Kount Merchant ID — If you are using Kount Complete-level (Enterprise), enter your ID.

  4. Click Save.

Set up IPNs (Optional)

Instant Payment Notifications (IPNs), also known as webhooks, are HTTP POST messages that are sent to your backend when an important event occurs, such as the completion of a sale. An overview of IPN functionality can be found here. If you would like to leverage the IPN functionality, you will need to code the IPN receiver on your backend and follow the steps below to set up IPNs.

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

  2. Select the Receive Instant Payment Notifications check box.

  3. Update the IPN URL(s) field with the URL where you want to have your IPNs sent.

  4. To enable specific IPNs, click Select IPNs. In the section that opens, toggle the button next to the IPN to select it.

  5. Click Submit.