Chargebee Setup

Chargebee enables SaaS businesses to automate their recurring billing, renewals, collections, and reconciliation. Their flexible platform offers 480+ recurring billing scenarios, robust subscription management, and streamlined revenue operations to meet any business need. By connecting your Chargebee account to BlueSnap, you'll get the advantage of secure, global payment processing in a variety of currencies and payment methods.

Supported Features

3D Secure
Account Updater
Chargeback Management
Fraud Prevention: Built-in Fraud Prevention and Risk Management
Enhanced fraud using Device Data Collector
Hosted Payment Fields
Merchant-Managed Subscriptions
Multi-currency processing
Partner Sandbox Testing
Payment Analytics and Reporting
Payment Methods: ACH/ECP, Credit/Debit Cards, and SEPA
Payment Optimization
Vaulted Shoppers

*Brazil is not supported at this time


Chargebee and BlueSnap Accounts

You must have accounts at both Chargebee and BlueSnap to proceed.

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

Supported Currencies

BlueSnap supports the currencies listed here. We recommend configuring your integration to only accept currencies supported by BlueSnap.

Supported Countries

BlueSnap supports the countries listed here. If a shopper is located in one of these supported countries, they will be able to purchase with the BlueSnap payment module.

PCI Compliance

A PCI compliance level of SAQ-A required.

Chargebee Setup

Step 1: Configure your BlueSnap account settings

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

  1. Get your BlueSnap API credentials. Click here for instructions. You'll need these values in Step 2.

  2. Set up your statement descriptor. The statement descriptor is the description that appears on the shopper's credit card statement or bank statement for each transaction and helps the shopper identify the transaction.

  • Go to Settings > General Settings.
  • In the Branding Settings section, enter a Default Statement (Soft) Descriptor and Support Phone Number (both appear on the shopper's statement).
  • Click Submit.
  1. To get paid, you need to configure your payout settings. Refer to Payout for more information.

Step 2: Configure your Chargebee account settings

Follow the steps below to configure BlueSnap as the payment gateway in your Chargebee account.

  1. Work with Chargebee to get BlueSnap enabled for your live site.

  2. Once enabled, go to Settings > Configure Chargebee > Payment Gateways and click Add a Gateway.

  3. Select BlueSnap from the list.

  4. Provide your BlueSnap API user key and password from Step 1.

  5. Enable Card Verification and Card Storage based on your business needs.

Best Practices & Tips

Considering shopper impact of currency conversions

While transactions are placed in your store’s base currency, you might have your store configured to display product prices in multiple currencies. To account for any differences between the currency conversion rates used to display prices on your website and the rates used by the shopper’s issuing bank, we recommend including a note on your checkout page that informs shoppers of potential price variations. For example: “The price listed is approximate and may vary slightly”.

Payout Reconciliation

To reconcile BlueSnap payouts with Chargebee transactions, check out the Payout Detail report. Use the Invoice ID parameter and cross-reference it with the ID at Gateway value in the Chargebee Transactions report (this can be found through Chargebee Backoffice by navigating to Logs and then the Transactions menu).


Use BlueSnap's reporting capabilities to gain a comprehensive understanding of your business through detailed transaction and payout reports, payment conversion reports, and much more. Reports can be viewed right in your Merchant Portal or pulled via the Reporting API to be parsed or pushed to your third-party reporting tools.

Back to Top