Drupal Setup

Learn how to connect your BlueSnap and Drupal accounts

Drupal is web publishing software you can use to create your own 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 own website using just your web browser. By connecting your store to BlueSnap, you can securely accept card payments. And 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
Vaulted Shoppers

Requirements

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

A 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

A PCI compliance of SAQ-A is required.

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 BlueSnap Console for production or sandbox.

  1. Set up your BlueSnap API Credentials and define the IP address of your server. Make note of your API username 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 Username and Password.

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

  6. Click Save.

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

❗️

Important

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.

(Optional) Set up IPNs

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 > General Settings.

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

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

  4. Click Submit.

Updated 3 months ago

Drupal Setup


Learn how to connect your BlueSnap and Drupal accounts

Suggested Edits are limited on API Reference Pages

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