Setting up Worldline (Previously Bambora) as your Checkfront payment provider

Learn more about Worldline (formerly Bambora), including checking service status, setting up Worldline in Checkfront, configuring settings in the add-on modal, using the test environment, requiring security codes, and enabling Worldline and Stripe together within your account.

We recently upgraded how Checkfront handles payments through Worldline. Your credit card data is now processed using secure tokenization, which means card details never touch our servers directly. It's a significant security improvement. To keep your payments running smoothly, you need to update your Worldline API Key. Here's what to do: Log in to your Checkfront account Go to Manage > Ecommerce Setup Re-enter your Worldline API Key That's it. Takes about two minutes.

Accessing the features mentioned in this article

Where can I find this feature using the top menu?

• Manage > Ecommerce Setup > Payment
   

What more do I need to use this feature?

• Admin permissions are required to manage Payment Providers.
• A Worldline account (more info below).

Worldline is a global payment processor and technology provider that enables businesses and financial institutions to accept, process, and manage electronic payments across in-store, online, and omnichannel environments. It provides merchant acquiring, payment processing, and digital transaction services, operating across the full payments value chain.

Checkfront integrates with Worldline (formerly Bambora) using a secure, tokenized payment approach via Worldline's Custom Checkout solution, providing a seamless checkout for your Customers and fully integrating with the Checkfront back-office app. 

Check the service status Check the status of Worldline services at any time here: https://status.worldline.ca/en/

Setting up Worldline in Checkfront

Back to top

Bambora is now Worldline, which is a Shift4 payment solution in North America Bambora is now Worldline, a Shift4 payment solution in North America. We appreciate your patience while we transition our application to the new branding. You can understand any references to Bambora as referring to Worldline.

 

1. Accessing Bambora within Ecommerce Setup

Back to top

 

From the Ecommerce Setup page (Manage > Ecommerce Setup > Payment), browse or search for Bambora (Worldline). We list the Payment Provider under those available to your region.

Click the Bambora (Worldline) tile to open the Add-on Setup modal.

Enter your Bambora (Worldline) merchant account details in the fields provided in the Add-on Setup modal.

Merchant ID

In the Merchant ID field, enter your Worldline Merchant ID as found in your Worldline account.

Bambora Username

In the Username field, enter the username you set up for use in Worldline (formerly Bambora).

Bambora Password

In the Password field, enter the password you have set up for use in Worldline (formerly Bambora).

Hash Key

In the Hashkey field, enter the Hashkey found within your Worldline account.

Enable Interac Online

Choose the Enable Interac Online option if you want to accept INTERAC® Online through Checkfront, facilitated by the Worldline service.

Interac Merchant ID

In the Interac Merchant ID field, enter your ID as it appears in your Worldline account.
 

API Access Passcode

You can find your API Access Passcode in your Bambora Portal:

1. Go to Order Settings (Administration > Account Settings > Order Settings).
2. Select Security/Authentication.
3. Note your API Access Passcode.
4. Enter your passcode in the API Access Passcode field in Checkfront (Ecommerce Setup > Payment > Bambora).

Worldline offers two merchant accounts: a Production account and a Test account. We recommend testing your checkout end-to-end with a Test account before switching to your Production account and going live. 

You can create a Worldline test account here: Create a Test Account

You can find a full list of supported credit card numbers within this Worldline help article: How do I test credit cards?

Canada (and Worldline) has made Card Security Codes (CVV, CVV2, CVD, CVC...) mandatory for all card-not-present transactions, so the related setting Require CVC's for staff payments (Manage > Ecommerce Setup > Settings) has been disabled. You now require Credit Security Codes for all Staff-side payments.

Primary and secondary provider If you turn on Worldline with Stripe, Stripe is considered the Primary provider, and Worldline is a Secondary provider, used for debit transactions only. You must also configure Worldline with the Enable Interac Online option enabled (with a valid Interac Merchant ID) to fully turn on the secondary provider.