Product Updates
Payment Methods
Payment Gateways and Configuration
- Payment Gateways Overview
- Chargebee Test Gateway
- Global Payments
- QuickBooks Payments
- Bank of America
- Solidgate
- Pay.com
- EBANX
- BluePay
- Sage Pay
- Paymill
- Bambora (formerly Beanstream)
- E-xact Direct Integration
- Orbital (Chase Paymentech)
- Pin Payments
- Moneris
- Elavon
- Network Merchants Incorporated (NMI)
- eWay Rapid
- Ecentric
- Windcave
- Metrics Global
- Nuvei
- Paystack
- Articles and FAQ
Level 2/3 Data Support
Advanced Routing
Dunning
Offline Checkout
Transaction Sync & Invoice Mapping
Fraud Management
Error Handling
Payment Lifecycle Logs
Others
- Reach (Merchant of Record)
- Payment Verification
- Bulk Deletion of Payment Methods
- Custom Payment Methods
- Payment Initiator Parameter
- PSD2 and Strong Customer Authentication
- RBI e-Mandate
- RBI Tokenization Regulations
- Transaction Descriptors
- Payment Preferences
- Visa Trial Rules
- Mastercard Trial Rules
- Co-badged Card Compliance
- Articles and FAQ
BlueSnap Direct Integration
We have upgraded to the latest BlueSnap SDK version (v5.0) to ensure compliance, enhanced security, and improved performance.
BlueSnap is an online payment solution for e-commerce, B2B, and SaaS companies, specializing in global payment processing and payment gateway solutions. Chargebee seamlessly integrates with BlueSnap and allows you to start accepting card payments immediately. Check out the Supported Currencies section to learn about the currencies supported by BlueSnap. Click here to find out the countries supported by BlueSnap.
If you are currently using BlueSnap via Spreedly, you must enable BlueSnap Direct Integration for your Chargebee site prior to migration.
Due to recent world events, you may experience failures for payments originating from Russian financial institutions. We recommend reviewing guidelines issued by respective payment gateways for additional information.
Supported payment methods
Click the links below to learn more about configuring the desired payment method:
Types of accounts
BlueSnap has two types of accounts: Sandbox and Live. You can integrate the Sandbox account of BlueSnap with the test site of Chargebee and the Live account of BlueSnap with the live site of Chargebee.
Integration options
Listed below are the integration options available between Chargebee and BlueSnap
| # | Methodology | Description | PCI Requirements | 3DS supported? |
|---|---|---|---|---|
| 1 | Chargebee API + BlueSnap Gateway | In this method, collecting card information should be handled at your end and passed on to Chargebee via the API. Chargebee will route this card information directly to BlueSnap. | High(card information will be collected by you directly, you will have to take care of PCI Compliance requirements) | YesFor more info, contact support |
| 2 | Chargebee Checkout + BlueSnap Gateway | In this method, the card information of the customers are collected by Chargebee's checkout and directly passed on to BlueSnap. | Low(Your PCI compliance requirements are greatly reduced because of Chargebee's checkout. As a merchant using Chargebee's checkout, all you have to do is submit a Self Assessment Questionnaire to stay compliant.) | Yes |
| 3 | Bluesnap JS + Chargebee API + Bluesnap gateway | In this method, the card details are captured and tokenized on your side by BlueSnap's javascript library and the token is sent to Chargebee. | Low(card details are tokenized by BlueSnap) | Yes |
| 4 | Chargebee JS + Chargebee API | In this method, collecting card information has to be handled at your end and finally passed on to Chargebee. | Low | Yes |
Prerequisites
In order to configure BlueSnap you will need the username, password, client side encryption key and data protection key.
To configure the data protection key, follow the below steps:
-
Login to BlueSnap.
-
Click Payment Methods from the left navigation bar.
-
Enter a data protection key.
-
Click Submit. (Click the GIF for a full-screen view.)
To get your username, password and client side encryption key, follow the below steps:
- Login to BlueSnap.
- Click Settings > API Settings.
- Request for API Credentials by setting a new password and click Request for API Credentials.
- You will now be able to view the username, password, and client side encryption key. (Click the GIF for a full-screen view.)
Configuring BlueSnap
To configure BlueSnap in Chargebee, follow the below steps:
-
Click Settings > Configure Chargebee > Payment Gateway > Add payment Gateway.
-
Click BlueSnap.
-
Enter the username, password, client side encryption key and data protection key.
-
Click Connect.
Configuring Card Settings
To change the Cards Setting, click the Manage link. The Cards Settings page is displayed.
- Allow Prepaid cards: Enabling this option allows your customers to use a prepaid card for their transactions.
- Always retain card information in BlueSnap when customer updates it: Enabling this option stores the updated card information in BlueSnap rather than the default gateway.
- Enable 3D Secure: Enable this option to authenticate payments made via card (Debit or Credit) using 3D Secure.
Once you have enabled the necessary settings, click Save.
Configuring Webhooks
Webhooks are indispensable when it comes to integrating Chargebee with BlueSnap as they pass crucial payment information such as payment status, based on which users can take action. Webhooks in this integration should be configured manually. Learn more about webhooks.
To configure webhook in your BlueSnap account, follow the below steps:
-
Login to your BlueSnap account.
-
Click Settings > IPN Settings.
-
Select the Receive Instant Payment Notifications checkbox.
-
Copy the Notification URL from Chargebee and paste it in IPN URL(s) section.
-
Click Select IPNs.
-
Select the Send Account Updater checkbox.
-
Click Submit.
Currencies Supported
BlueSnap and Chargebee support 100+ different currencies for charging customers across different geographical locations. If you intend to use BlueSnap+Chargebee for your business, ensure that your transactional currencies are supported by both. Find the complete list of currencies supported by:
Our direct integration does not need you to allowlist any IP addresses. Make sure you enable Disable IP Checking in your BlueSnap account under Settings > API Settings.
Additional Fields for Fraud Screening
Bluesnap, a trusted payment gateway provider, understands the critical need for robust fraud screening and efficient payment approval processes. Bluesnap recommends sending specific information or fields about payers to enhance these measures. By collecting this valuable data, you can bolster your defences against fraudulent transactions and streamline the payment approval process, ensuring a safer and smoother experience for businesses and customers.
The fields include:
- firstName
- lastName
- phone
- addressLine1
- addressLine2
- addressLine3
- city
- state
- stateCode
- countryCode
- zip
Lets us see how you can enable and send these fields when using Chargebee's Hosted Pages, Chargebee JS, or BlueSnap JS:
Using Chargebee Hosted Pages
Follow the steps below to enable these fields when using Chargebee's Hosted Pages:
-
Go to Settings > Configure Chargebee > Checkout and Self-Serve Portal.
-
Switch to the Fields tab and select Payments.
-
You must enable the above-listed fields. Click Publish. Address fields will appear only if None is selected from the In checkout, prefill address information from drop-down menu.
-
Choose to prefill address-related information from Billing or Shipping details by selecting the relevant option under the In checkout, prefill address information from drop-down menu.
Using Chargebee JS
Chargebee JS provides a comprehensive set of tools and functionalities that allow you to harness the capabilities of BlueSnap within your billing and subscription management workflows.
If you are utilizing Chargebee JS, it is recommended to pass these fields as parameters via appropriate handler methods based on your chosen payment method. The following payment method handlers are supported via Chargebee JS:
Was this article helpful?