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. Because the payment form is embedded in your checkout form, shoppers enjoy a frictionless checkout experience.
Auth/Capture and Separate Auth and Capture
Built-in Fraud Prevention and Risk Management
Enhanced fraud using Device Data Collector
Hosted Payment Fields
Level 2/3 Data compliant
Multiple Currencies and Multiple Languages
Partner Sandbox Testing
Payment Analytics and Reporting
Payment Methods: ACH/ECP and Credit/Debit Cards
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.
This guide assumes that you already have Drupal set up on your server. For instructions, refer to Drupal Support.
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.
BlueSnap supports the currencies listed here.
PCI compliance of SAQ-A is required.
Step 1: Download the BlueSnap Module
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.
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.
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.
Go to Commerce > Configuration > Payment > Payment gateways.
Click Edit in the OPERATIONS column for BlueSnap Card Processing.
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.
Enter your API Username and Password.
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.
Scroll to the bottom of the screen and select Enabled in the Status section.
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.
Go to Commerce > Configuration > Store > Stores.
Click Edit in the OPERATIONS column for Online Store.
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.
(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.
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 with the URL where you want to have your IPNs sent.
To enable specific IPNs, click Select IPNs. In the section that opens, toggle the button next to the IPN to select it.
Updated over 1 year ago