Overview
↑ Back to top Note: WooCommerce Bambora does not currently support the following features:
- Interac debit via Bambora
- 3D Secure
Requirements
↑ Back to top- An active Bambora account
- An SSL certificate
- PHP 7.0+ (you can find this under WooCommerce > Status)
- WooCommerce 3.5+
- WordPress 5.2+
Installation
↑ Back to top- Ensure your store meets the plugin requirements.
- Download the extension from your WooCommerce dashboard.
- Go to Plugins > Add New > Upload and select the ZIP file you just downloaded.
- Click Install Now and then Activate.
- Click Configure and read the below section to learn how to set up the plugin.
Switching from Beanstream legacy payment mode
↑ Back to top
Getting Started
↑ Back to top- Login to your Bambora account.
- Copy your Merchant ID at the top of the screen.
- Go to Administration > Account Settings > Order Settings.
- Under the Security/Authentication section, find the API Access Passcode and click Generate New Code to create a new code, if needed.
- Copy the API Access Passcode.
- Click Update.
- Go to Configuration > Payment Profile Configuration.
- Under the Security Settings section, select the API Access Passcode and paste the copied API access passcode from step 4 in that field.
- Click Update.
- In WooCommerce, go to the plugin settings and paste the Merchant ID and API Passcode in their respective fields.


Extension Settings
↑ Back to top- Enable / Disable: Allow customers to use this gateway to checkout.
- Title: The name shown for the payment during checkout and on the Order Received page.
- Description: The text shown under the gateway’s title during checkout. Limited HTML is allowed.
- Transaction Type: Controls how transactions are submitted to Bambora. Select “Charge” to automatically capture payments. If you select “Authorization”, you must manually capture and settle payments in your Bambora control panel or on the WooCommerce orders screen after the transaction has been submitted. Click here to read more about capturing transactions.
- Charge Virtual-Only Orders: If Transaction Type is set to “Authorization”, enable this to automatically capture charges for orders with only virtual products. For downloadable products, this will grant downloads access right away.
- Enable Partial Capture: If Transaction Type is set to “Authorization”, enable this setting to allow orders to be partially captured multiple times. Click here to read more about partial captures.
- Capture Paid Orders: If Transaction Type is set to “Authorization”, enable this to automatically capture charges when orders move to a paid status.
- Accepted Card Logos: Determines which card logos are displayed during checkout. This has no impact on which cards are accepted by your merchant account.
- Tokenization: Let customers save their payment methods for future use at checkout. This is required for Subscriptions or Pre-Orders. Click here to read more about saving payment methods.
- Detailed Decline Messages: Display detailed messages to customers to provide reasoning for declines instead of a generic error message when possible. Click here to read more about detailed decline messages.
- Debug Mode: Enable when you’re having issues processing transactions. You can choose to log API requests directly on the checkout page, save them to the WooCommerce > Status > Logs page, or both. As a best practice, please do not enable this setting unless you’re having issues with the plugin.
- Environment: Switch between “Test” and “Production” credentials. Set to “Test” to send transactions to a Bambora test account for setup / troubleshooting. Click here to sign up for a test account.
- Merchant ID: Follow the steps above to retrieve your Merchant ID.
- API Passcode: Follow the steps above to retrieve your API Passcode.
Managing Orders
↑ Back to topCapture Charges
↑ Back to topNote: If your Transaction Type setting is set to “Charge”, you can’t use the Capture button.
Bambora also allows partial payment captures when enabled in the plugin settings. This lets you perform multiple captures on an authorized order from within WooCommerce. Click here to read more about partial captures.
Automatic Refunds
↑ Back to topVoid Transactions
↑ Back to top- If your Transaction Type setting is set to “Authorization”, you can void when the transaction has been authorized but not yet captured.
- If your Transaction Type setting is set to “Charge”, you can void when the transaction has not yet been settled (e.g. funds haven’t been transferred from the customer’s account to your Bambora account).
Gateway Features
↑ Back to topSaving payment methods
↑ Back to topNote: When using WooCommerce Subscriptions, customers cannot delete payment methods that are associated with active subscriptions. Click here to read more about saving payment methods with Subscriptions.
Enhanced Checkout Form
↑ Back to topFrequently Asked Questions
↑ Back to topQ: Why are my customers getting a ‘CALL HELP DESK ERROR’ when they try to submit payment? A: If the “Validate Referring Host” setting is enabled in your Bambora dashboard, Account settings> Order settings> Security/Authentication, orders will fail, listing 401 errors in the log and the ‘Call Help Desk’ error on the frontend. This setting should be “unchecked”.
Q: Why is my WooCommerce currency ignored by Bambora? A: The base currency for Bambora is set by the Merchant ID and visible in the Bambora dashboard, and will not be pulled in from WooCommerce. In order to change base currency for your site, you need to request a new Merchant ID with the target base currency, then update your WooCommerce Bambora Payment Gateway settings to use the new Merchant ID.
Q: Can I turn off the Card Verification Value (CVV) / Card Security Code (CSC) at checkout? A: Afraid not, sorry about this! CVV / CSC is a required field for the Bambora integration, so there is no option to turn off this field.
Q: Can I use a different merchant account based on the currency of the cart? A: Yes! While we do not have a setting within the plugin to switch between accounts based on the currency, we do have a code snippet for this feature. Note: Customization is not covered under our support policy, so we will not be able to further modify or implement this code directly. Click here to view and copy the code snippet.
Q: Does the plugin use Bambora’s email notifications? A: No, the plugin does not interact with Bambora’s email notifications, but instead relies upon WooCommerce email notifications.
Troubleshooting
↑ Back to topPartial Void / Refund Error
↑ Back to topOops, you cannot partially void this order. Please use the full order amount.This means that you’re trying to perform a partial refund, but the charge has not been settled (typically when you try to refund within a day of the purchase). The plugin tries to void this order since the funds have not been transferred (to cancel the order instead of refunding it), but Bambora does not permit partial voids. Please wait until the charge has settled (about one day after the charge was made) to refund this transaction.
Known error responses
↑ Back to top- Duplicate match on payment information: This indicates that the “Do not allow profile to be created with card data duplicated from an existing profile” setting is enabled in your Bambora account under Configuration > Payment Profile Configuration, and that a customer is attempting to use a card that is saved to another customer profile (e.g. perhaps they are checking out without logging into their account on your site). Disable this setting to allow duplicate profiles.
- Maximum number of credit cards is reached: Bambora has a setting to limit the number of saved profiles per customer. You can change this in your Bambora account under Configuration > Payment Profile Configuration by adjusting the “Maximum number of cards shown” setting to a higher number.
Other troubleshooting
↑ Back to top- Please ensure that your site meets the plugin requirements.
- Check the FAQs to see if they address your question.
- Confirm that your Merchant ID and API Passcode are correct.
- Enable debug mode and review the errors messages provided by Bambora. Click here to review the error codes in the Bambora Response Code Reference. In some cases, such as a transaction being held for review or declined, the plugin cannot change the issue and it must be resolved in your Bambora account.