Bambora North America

Bambora North America is a payment gateway that you can connect to your Ecwid online store to accept credit card payments online. It is available to the merchants in the United States and Canada.

You can easily connect your Ecwid store to the Bambora North America Hosted Payment Form gateway by following these steps:

In your Bambora account

First, get the connection data from your Bambora North America account:

  1. Sign in to your Bambora North America merchant admin area.
  2. Go to the administration → account settings → order settings page.
  3. Scroll down until you find Hash Validation and select Hash Algorithm: MD5.
  4. Copy the entire Hash Key out of the box and save it somewhere.
  5. Click Update at the bottom of the page to save the changes.
  6. Go to the administration → company info page, copy your Merchant ID and also save it somewhere.

In your Ecwid account

Now, add the connection data in your Ecwid admin:

  1. From your Ecwid admin, go to Payments.
  2. Scroll down to Other ways to get paid and choose the Bambora North America Hosted Payment Form payment method.
  3. Click the Bambora North America Hosted Payment Form — Settings link.
  4. Enter your Merchant ID and Hash key in the respective fields (you’ve copied their values earlier from your Bambora account):

Bambora North America Hosted Payment Form Settings

  1. Select the Transaction Type:
    • Purchase — it is immediate charge of a credit card.
    • Pre-Authorization — it is a temporary hold put on a credit card, you can capture the funds later.
    In most cases the Purchase type of transactions is used.
  2. Enter the name for this payment method — customers will see it at checkout. You can simply keep the suggested name.
  3. Make sure this payment method is enabled in your store:

Enable payment method

  1. Provide your customers with the instruction on how they can pay you with this payment method.
  2. Save the changes.


New merchants receive login information and merchant ID numbers for accounts that are in “test” mode. Transactions processed through the test environment are free of charge. You should contact Bambora North America to switch your account to the "live" mode.

You can use the following test card numbers to emulate the full transaction process in the test environment. These card numbers are not valid for live accounts. Use an expiry date that is equal to or later than the current month and year.

Visa — Use "123" as a CVD/CVV code 

  • Approved - 4030000010001234
  • Approved $100 Limit - 4504481742333
  • Approved VBV - 4123450131003312 with VBV passcode 12345
  • Declined - 4003050500040005

MasterCard — Use"123" as a CVD/CVV code

  • Approved - 5100000010001004
  • Approved - 5194930004875020
  • Approved - 5123450000002889
  • Approved 3D Secure - 5123450000000000 passcode 12345
  • Declined - 5100000020002000

American Express — Use "1234" as a CVD/CVV code

  • Approved - 371100001000131
  • Declined - 342400001000180

Discover — Use "123" as a CVD/CVV code

  • Approved - 6011500080009080
  • Declined - 6011000900901111
Was this article helpful?

Awesome! Thanks for your feedback!

Thanks for your feedback!

Sorry about that! What went wrong?
2 out of 6 found this helpful
We use cookies and similar technologies to remember your preferences, measure effectiveness of our campaigns, and analyze depersonalized data to improve performance of our site. By choosing «Accept», you consent to the use of cookies.
Accept cookies Decline