Connect Bambora to Advanced Billing to process credit card payments through Bambora's payment platform. Bambora was formerly known as Beanstream until May 2017.
Important: Bambora isn't available in the standard gateway picker by default. Contact Maxio to request access for your site.
Merchant ID, user, password, and Payment Profile API Pass Code
- Merchant ID: Located in the upper right corner of the Member Login screen after you sign in to your Bambora account.
- User and Password: Configure under Administration > Account Settings > Order Settings > Use username/password validation against transaction. Check the box, then create a username and password.
- Payment Profile API Pass Code: Found under Configuration > Payment Profile configuration. You need Payment Profiles enabled in your Bambora account to use this API key.
- Payment Pre-Authorizations Disabled: An optional toggle on the connection form. Leave this off unless you specifically need to disable pre-authorizations for this gateway.
It's a good idea to separate your administrator account from the access Advanced Billing uses.
To separate administrator access from the access Advanced Billing uses
- After you log in to Bambora, go to Administration > User Manager.
- Click Add user, then enter the appropriate information, using a username like
acme.
- Record the username and password you'll use for this user somewhere safe. You need to copy it into your Advanced Billing settings. When done, click Add User in the dialog.
- Change the permissions for the new user by selecting the user in the left list, and set:
- Recurring Billing = No Access
- Payment Form = No Access
- Web Terminal = No Access
- Account Settings = No Access
- Security = No Access
- Language = English
- Disabled = No
- Secure Webspace = No Access
- Payment Profile = Full Access
- Company Info = Read Only
- Credit Card Viewing = Masked Card
- Reporting = Full Access
- Administrator = No
- Click Update to save this configuration.
Requirements
- You need Bambora's card number storage service or option to store credit card numbers.
- Configure your Bambora account to allow duplicate payment profile information: log in to Bambora, go to Configuration > Payment Profiles, uncheck Do not allow profile to be created with card data duplicated from an existing profile and Do not allow profile to be created with billing information duplicated from an existing profile, then click Update to save.
- Every API request to Bambora must include the customer's name, address, state/province, zip/postal code, and country.
- Bambora only allows specific state/province and country codes. Review pages 64-67 of
Process_Transaction_API_Guide.pdf, available in the Bambora administration console under Documentation > Processing > Process Transaction API Guide.
- Bambora requires full address information for every transaction, including billing phone number. Set Advanced Billing to require the full billing address (name, phone, street address, city, state/province, postal/zip, and country) on the hosted payment pages.
- Tell Bambora whether you intend to process transactions in US dollars or Canadian dollars. The currency setting in Advanced Billing must match the currency set up by Bambora. Advanced Billing can't detect a mismatch in this setting.
- To use Public Signup Pages with the Bambora gateway, enable billing address collection in the Public Signup Page settings.
Currencies and merchant location
Bambora supports merchant accounts in Canada, and processes payments in CAD and USD.
For complete currency and merchant location support information, see the payment gateway overview page.
Data portability policy
Contact Bambora for more details.
American Express
American Express prevents Canadian merchants from accepting USD American Express transactions unless you have an entity located within the United States.
Bambora troubleshooting
Transaction declined: restricted transaction type
If you receive the error "Transaction Declined. Restricted transaction type," check your Bambora order settings. Set Restrict Internet Transaction Processing Types to allow both purchase and pre-authorization transactions.
Find this setting under Administration > Account Settings > Order Settings, then select the radio button for both types and click Update.
Reuse a Bambora test card
You can only use each Bambora test card once per customer. To reuse it, clear the stored information under Processing > Payment Profile in Bambora.
Still need help?
Reach out and our support team will take it from here.
Contact support