Skip to main content

Bambora Checkout

To properly configure your Bambora/Wordline payment type in OPS-COM you will require two separate "Authorization Headers". These headers will be referenced below as:

Payment
 Authorization Header

Profile Authorization Header

The process to generate the two different encoded headers is similar in that both require your Bambora Merchant ID + API access passcode, and both are encoded at the same link, however the API access passcode is different for each and shown on different pages in Bambora (order settings vs payment profile configuration).

Bambora Configuration:

Order Settings:

2024-10-28_13-30-48.png Login to your Bambora account, then on the left navigation select AdministrationAccount SettingsOrder Settings.

API access passcode (Payment Authorization Header):

On the Order settings page scroll down to "API access passcode". If there is nothing in the API access passcode field click the "Generate New Code" button. After generating your API access passcode make sure to scroll down to the bottom of the page and click "Update" to save your changes.

Merchant ID (MID):

2024-10-28_13-44-08.png Your Merchant ID can be found in the top right of your Bambora account.

Encode API Passcode (Payment Authorization Header):

2024-10-28_13-50-39.png

Now that you know your API access passcode and Merchant ID go here. Copy and paste your Merchant ID (1) and API access passcode (2) into the appropriate fields, then click "Encode"(3).

 

Copy/record the Authorization Passcode returned. This will be needed later when you setup the Bambora Checkout payment type in OPS-COM. It will be referenced further down this page as the "Payment Authorization Header". You should temporarily paste this into a program such as Notepad for easy access later since you will need it later during the OPS-COM configuration.

 

You will want to make sure to copy only the following section returned (excluding quotation marks):

"Passcode ______"

For example, select/copy as shown in the highlighted example below, starting at the P on Passcode.  We want to exclude/not copy "Authorization:"

image.png



Payment Profile Configuration:

Similar to the above process for encoding your Payment authorizationAuthorization headerHeader, we will be going through a similar process for encoding your Profile authorizationAuthorization headerHeader.

2024-10-29_14-52-45.png

Login to your Bambora account, then on the left navigation select Configuration → Payment Profile Configuration.

API access passcode (Profile Authorization Header):

Under Security Settings make sure "API access passcode:" is selected. If there is nothing in the API access passcode field click the "Generate New Code" button. After generating your API access passcode make sure to scroll down to the bottom of the page and click "Update" to save your changes.

Merchant ID (MID):


2024-10-28_13-44-08.png

Your Merchant ID can be found in the top right of your Bambora account.

Encode API Passcode (Profile Authorization Header):

2024-10-28_13-50-39.png

Now that you know your API access passcode and Merchant ID go here. Copy and paste your Merchant ID (1) and API access passcode (2) into the appropriate fields, then click "Encode"(3).

 

Copy/record the Authorization Passcode returned. This will be needed later when you setup the Bambora Checkout payment type in OPS-COM. It will be referenced further down this page as the "Profile Authorization Header". You should temporarily paste this into a program such as Notepad for easy access later since you will need it later during the OPS-COM configuration.

 

You will want to make sure to copy only the following section returned (excluding quotation marks):

"Passcode ______"

For example, select/copy as shown in the highlighted example below, starting at the P on Passcode.  We want to exclude/not copy "Authorization:"

image.png


OPS-COM Configuration:

Create new Payment Type in OPS-COM:

2024-10-28_15-47-13.png

Login to your OPS-COM system with an administrator account that has permission to edit payment types.

 

In the OPS-COM menu select System ConfigurationPaymentsSetup Payment TypesAdd Type.

 

Select "Bambora - Checkout" from the Provider list, then click "Next Step".

Edit Payment Type - Enabled for User Types:

AsXimage.png

Type Name: The Type Name can be whatever you want it to be, though please note this will also be the name displayed to users during payment checkout when they are prompted to select a payment method.

 

You can reference the specific hosted payment provider or something more generic such as "Online Credit Card Payment", "Online payment", "Credit Card", etc. Really it's up to you and what you think makes most sense to your site users when making a payment.

 

Enabled for User Types: Select the User Types you wish this new Payment Type to be visible to so they can select it during payment checkout. You can change these user types at any time.

 

Once done make sure to click the "Update Payment Type" button at the bottom of this page.

Edit Payment Type - Settings:

2024-10-28_16-35-53.png

Enable for Text2ParkMe: if you aren't using this module leave the button unchecked.

 

Enable for Permit Renewal Payments: if you aren't using this feature leave the button unchecked.

 

Enable for Guest Payments: if you aren't using this feature leave the button unchecked.

 

Prompt Information: Only "Email Address" is supported with OpenEdge Hosted Payments at this time.