Docs

Log in to read the version of docs relevant to your site, or use the dropdown versions

Bambora (formerly Beanstream)

Bambora is now deprecated. Existing users can continue using the integration without interruption. However, new onboarding is no longer available.

Bambora is a leading online payment provider in Canada and the United States. Chargebee allows you to easily connect with Bambora to process your payments.

Here are a few things you need to know before you choose Bambora:

Countries supported: Bambora is available for companies based in the USA and Canada. Click here to see if Bambora is supported in your location.

Payment methods: Chargebee currently supports only card payments made via Bambora.

Integration options

Chargebee provides two options to integrate with Bambora:

Chargebee Checkout and Bambora Payment Gateway

The customer's card information is collected by Chargebee's Checkout and passed on to Bambora. This option relieves you from PCI compliance requirements. All you need to do is fill out and submit this Self Assessment Questionnaire to stay compliant.

Chargebee API and Bambora Payment Gateway

The customer's card information must be collected at your end and passed on to Chargebee. Chargebee will then route the card information to Bambora. PCI compliance requirements must be handled by you.

Prerequisites

  1. Chargebee uses Spreedly, a third-party card vault, to store the customer's card information. If you are using Bambora's service, you must migrate your customer's card information to Spreedly to start using Bambora with Chargebee. Contact support for more information about the migration process.
  2. To configure Bambora in Chargebee, you must have an account with Bambora. If you don't, please create one.
  3. Set up the Username/Password validation for Bambora API. To set up this, log in to the Bambora online member area and go to Administration > Account Settings > Order Settings. Click the 'Use username/password validation against transaction' option and enter Username and Password.
  4. Currently, we do not support collecting phone number details from customers. So you must make 'billing address' optional in Bambora. To do this, log in to the Bambora online member area and go to Administration > Account Settings > Order Settings and enable the 'Billing address optional' property.

Configuring Bambora

Log in to your Chargebee live site. You can configure Bambora only in your live site.

Step 1: Click Settings > Configure Chargebee > Payment Gateway > Add a Gateway > Bambora.

Step 2: Enter your Merchant ID, User Name, Password, and API Key. Click Connect.

Step 3: You have now configured Bambora. However, for the integration to work, you need to complete the prerequisites in Bambora. To configure the cards setting, click the Manage link.

Step 4: The Cards setting will open as shown below. Select the necessary settings.

  • Card verification: Chargebee allows you to verify the customer's card before adding it. In this process, a small amount will be debited from the customer's card and refunded instantly. If this authorization fails, the customer cannot add their card. If you wish to activate this authorization, enable card verification.
  • Always retain card information in Bambora when customer updates it: Enable this option if you are using multiple payment gateways and want the customer's latest card information to be updated in Bambora.

Step 5: Click Save.

  • Card Verification: Chargebee allows you to verify the customer's card before adding them. In this process a small amount will be debited from the customer's card and will be refunded instantly. In case this authorization fails, the customer cannot add their card. If you wish to activate this authorization, enable card verification.
  • Always retain card information in Bambora when customer updates it: Enable this option if you are using multiple payment gateways and you want the customer's latest card information to be updated in Bambora.

Step 5: Click Save.

Was this article helpful?