With the Bambora integration(formerly known as Beanstream), your end users can seamlessly process their credit card transactions right on your Form. The payment is processed by Bambora and once the form is submitted successfully, the funds will be collected in your Bambora account.
Step 1: Add the Bambora integration to your Form.
To integrate your Form with Bambora, go into the Form and click on Settings > Integration > Payments and click "Add" next to the Bambora integration. Additionally, you can use the Search Bar to easily find the integration. A Bambora tab will appear below the Integration tab where you can continue to setup the integration.
Step 2: Enter your Merchant ID
Your Merchant ID is a 9-digit number that is sent in an email to you from Bambora when you first sign up for an account. Once you enter your Merchant ID, the rest of the fields will populate for you to map.
Bambora is requiring an API Passcode as of July 23, 2018. The field in the integration settings in Formstack won't be required but transactions will fail if a passcode is not provided on or after this date. Below are the steps to finding and enabling your API Passcode within Bambora.
1. Login to your Bambora account.
2. On the menu, click administration> account settings> order settings.
3. Scroll down, and in the Payment Gateway section, under Security/Authentication, find the ‘API Passcode’ option, and click 'Generate New Code' option.
4. At the bottom of the page select 'Update' and a confirmation page will pop up. Click 'Ok' and the process is complete.
Note: All settings are on auto-save meaning your entries will automatically save to the integration as you add them.
Step 3: Map your Form Fields to Bambora
First, you will start with the Transaction Information. If you have multiple items on your Form then you can map these to the integration by clicking on the Multiple Items option. If you choose that option, each item will need to be in it's own field with a value associated. You may instead choose to calculate a single total on the form and pass that value to Bambora as the Price field, leaving the Quantity field blank. For this, you would choose the Single item option. Either method for multiple items will work.
When mapping the Payment and Card Information, it is important to note that your Form must have a credit card number field in addition to at least one price field. These can be mapped to the Bambora integration by selecting "Credit Card" the various drop down menus. The currency is set in the Bambora admin panel.
You must also map all the required fields in the Customer Information section. This information will send to Bambora along with the payment transaction.
Error Handling
This step is optional. You can check to allow submissions into your database even if the integration fails - which would trigger submit actions and emails. If you don't check this option, submissions will only be added to the database if the integration runs successfully. Also, you can enter an email address to receive an email from Bambora if the integration fails - this will include details as to why it failed.
After you have all your settings are set the way you want, turn on the integration via clicking "ON" in the Run mode section.
Submit Action
A Submit Action Action will automatically be created to "Submit to Bambora" when a user submits their Form. You may choose to add Routing Logic which acts like a filter and will only send certain users to PayPal based on their selections. For example, if your Form offer options to pay via Credit Card OR Check then you would want to add Routing Logic so that only submissions paying via credit card are processed through Bambora.
To access this setting, go into the Form > Settings > Emails & Redirects > After the Form is Submitted and click to edit the Bambora Submit action to add your Routing Logic
Additional Steps to take within Bambora
In addition to setting up the integration on your Formstack account, you will need to enable Hash Key Validation within your Bambora account. The Hash Key does not need to be entered into the Formstack integration but will need to be set within your Bambora account. Below you will find steps on how to set this up:
1. Login to your Bambora Account
2. On the menu, click administration> account settings> order settings.
3. Scroll down, and in the Payment Gateway section, under Security/Authentication, select the checkbox Require hash validation on all Payment Gateway transaction requests.
4. Enter a Hash Key. It must be at least 8 characters, it doesn't matter what those characters are.
5. Select (and make a note of) the type of Hash algorithm you are using (MD5 or SHA-1).
6. At the bottom of the page, click 'Update'. A confirmation box opens at the top of the browser window. Click 'OK'.
* For all of our integrations, we just pass on the error message sent to us from the product we are integrating with. These error messages are not generated by Formstack, so we may not even know what many of them mean. However, you can click here for commonly occurring errors with Bambora and how to fix them.