Please wait ...


Loading...

Configuration in Magento

1. Information on the payment in Magento

Go to Sales -> Order in the Magento administration to find your orders. By clicking on an order you will find information on the payment in the field “Payment Information”. See example below.

Here you will find the following information: transaction number, currency code, payment date, MD5 information, Fraud Fighter notifications, amount, payment card type, and transaction fee.

Also, there is a link to your Bambora administration where you can find and handle this payment. The order and transaction numbers in the Bambora administration are in agreement with the numbers stated in Magento.


2. Settings

The settings for Bambora's payment module in Magento are found in System -> Configuration. Choose Payment Methods from the menu on the left (found at the bottom of the group Sales).

Enabled

This setting activates Bambora as a payment method in the system.

Title

Write the name of the payment method here. This is what your customers see when they are placing an order on your website. E.g. “Pay with credit card”.

Order status (Before the payment is made)

Choose the status an order should have before it is paid. This is used to distinguish between paid and non-paid orders. We recommend the setting Pending. See the next box: New order status (when the payment is made).

New order status (When the payment is made)

Choose the status an order should have after t is paid. This is used to distinguish between paid and non-paid orders. We recommend the setting Processing. Please note that this concerns completed payments, and NOT captured payments. Se the box above: Order status (before the payment is made).

Use Auto-Cancel

Before payment is completed Magento creates the order in the system with the status defined in "Order status (Before the payment is made)". If the payment is not completed within one hour, and this setting is activated, the order is cancelled automatically. You might have to contact your web hosting service to set up cron jobs in your Magento installation for this to work.

Sort order

This determines the order in which your payment methods are displayed. Put the value at 1 if Bambora should be displayed first.

Payment from applicable countries

Define which countries are allowed to pay using Bambora.

Payment from specific countries

If paying with Bambora is only allowed from certain countries, you can define the countries here.

Merchant number

Your merchant number which you receive from Bambora. You’ll find it in the menu Settings -> Payment system in the Bambora administration.

Instant Capture

This defines whether or not a payment should be captured instantly. You can only uset his if you customers receive their products immediately as well.

Instant invoice

Put this setting at Yes to generate an invoice when the payment is completed. We recommend that you ONLY use “Instant invoice” if “Instant capture” is enabled.

Instant invoice mail

Put this at Yes to send an invoice via email to the customer when the invoice is created. You must ensure that ”Instant invoice” is at Yes.

Group

With Bambora you can divide your payments into different groups. Moreover, you can limit the access of Bambora users to specific groups. A group is simply a name/string. Please leave the field empty (default) if you do not want to use groups.

MD5 Key

If you’ve activated MD5 in Bambora, enter your secret key here (your key is the password you’ve entered in the Bambora administration). It’s important that the keys are identical in the two systems. More information in section 9: Use of MD5.

Auth Mail

Enter an email address here to receive an email every time a payment is completed. You can separate addresses with a semicolon (;) if you have multiple recipients. Leave the field empty if you don’t want to use this service.

Window State

”Window state” defines how the payment window is displayed. Choose between overlay (a window which opens on top of your website) or full screen. We recommend overlay so the customer can see your website’s layout behind the payment window.

Add payment fee to the "shipping and handling amount"

In Magento it is not possible to add an extra field showing the transaction fee. However, with this setting you can add the transaction fee using the “shipping and handling amount” when the customers have paid their invoices. If you want to use transaction fee in connection with the API/web service, this setting must be enabled. Otherwise, you cannot capture the full amount from the customer’s invoice in Magento.

Send Email Order Confirmation

We recommend that you enable this setting. If not, an order confirmation is not sent to the customer. Instead you’ll have to send it manually from the Magento administration.

Process payments from within the order administration of Magento

By activating this setting you can process payments from Magento. When you’ve created an invoice for an order, you can capture the payment – without having to log in to your Bambora administration.

Remote password

Enter your password here if you’ve entered a password in the Bambora administration under API/Web service -> Access.

Capture invoice mail

Enable this setting to email invoices to the customer when capturing by mass processing is used.

Enable invoice data

Put at Yes if you want to offer invoice payments, e.g. Klarna or SveaWebPay.


The above functions are integrated in the Magento module, but you can manually apply all the functions we offer. To do so, define the relevant parameters in your module files. See all available parameters here.

3. Configuration of language

The default language in Magento is English (en_US), but if you want it in Danish (da_DK), simply install this extension key: http://www.magentocommerce.com/magento-connect/magento-community-modules-danish-denmark-language-pack.html

When installed, Magento and Bambora's payment window are both in Danish.

To use a third language, you have to configure it yourself. You need access to your web server, for instance from a FTP client. You can download the renowned FTP client FileZilla here. If you need help configuring your FTP, you need to contact your web hosting service. 

The following contains instructions on how to configure a third language; in this case German.

Go to the folder app\locale. All language files for Magento are located here. 

If no such folder exists, create the folder de_DE.

A complete list of language names is found in the file app\etc\config.xml.

Find the file Mage_Epay.csv which is located in the folder app\locale\da_DK

Copy the file app\locale\da_DK\Mage_Epay.csv to the folder app\locale\de_DE.

Open the file app\locale\de_DE\Mage_Epay.csv 

This is where you’ll find the labels that define the language in Bambora's module. Please see the image below. 

When changing the language, it’s only the column on the right (the highlighted text) you can edit. If you edit labels in the left column, the translation will fail.

4. Change layout of payment window

You can change the layout of the payment window, but keep in mind that this requires some technical skill and understanding.

The layout of the payment window is governed by the file: 
 app\design\frontend\default\default\layout\epay.xml

Please note that it is rather difficult to tailor the layout to suit your needs. It might be a good idea to ask for help on MagentoCommerce’s forum.

5. Process payments from Magento

You can process payments from the order administration of Magento. This means you don’t have to log in to your Bambora administration to process payments.

To enable this function, the setting ”Process payments from within the order administration of Magento” should be set at Yes.

In Bambora's administration, the setting is called API/Web service

When this is enabled in Magento, the IP address which features the Magento system must be configured in the Bambora administration. This is done from the menu API/Web service -> Access

Looking up the order in Magento, the system retrieves information on the transaction from Bambora. 

Following information is retrieved:

  • Transaction status
  • Order number
  • Acquirer
  • Currency code
  • Split payment status
  • 3D Secure status
  • Description (if any)
  • Cardholder’s name (if any)
  • Authorised amount and time stamp
  • Captured amount and time stamp
  • Credited amount and time stamp
  • Transaction fee (if any)

To capture a payment from Magento, you need to create an invoice. Find an order through the menu Sales -> Order, and press the button ‘Invoice’ at the top.

You can edit the invoice if you want to. At the bottom of the invoice you can capture the payment. Choose “Capture online” from the dropdown menu, and press the button ‘Submit Invoice’.  Magento communicates with Bambora, and the payment is captured.

If you want to cancel an order and delete the payment, press the button ‘Cancel’ at the top. Magento now deletes the transaction.

The updated transaction information is available from the order page (overview of orders). It will say on the order that the amount has been captured.

Refund
You must use the invoice you’ve created to credit a payment. At the top of the invoice find and press the button ‘Credit Memo’. This will create a credit note for this invoice.

On the new page you can edit the amount to be credited. To credit the payment, simply press ‘Refund’.  

The updated transaction information is now available in the order view.

6. API/Web service for Magento

You can extract Bambora information on orders through Magento’s built-in API. 

This option is available when Bambora's payment module is installed.

Below is a PHP example in which 100000011 is the order number:
<?php
$proxy = new SoapClient('http://yoururl/index.php/api/soap/?wsdl');
$sessionId = $proxy->login('username', 'password');
print_r($proxy->call($sessionId, 'epay.GetPaymentInfo', '100000011'));
?>

7. Using unoriginal templates

Note that this only applies for versions of the Bambora module older than 2.6
If you use a special template, installed without using Magento Connect, an error might occur when reaching checkout. 

The reason being that your template will search for Bambora files normally placed in the default template folder. But since your template is not installed in the default folder, Magento cannot locate the files.

This is solved by copying 2 folders from the default template and default skin folders to your new template folder. 

The 2 folders you need to copy are:
skin\frontend\default\default\images\epay
and
app\design\frontend\default\default\template\epay

Follow the instructions from Magento to get the paths right.

8. Currencies

To use various currencies in your Magento shop, you have to create a "website" for each currency.

Follow these instructions:


  1. Go to System -> Manage Stores, and create a new website for each currency. You need to create a Website, a Store and a Store View for each of your currencies. See example in image 10.

  2. Go to System -> Configuration, and make sure "Current Configuration Scope" in the top left corner is on Default Config. See example in image 11.

  3. Click on Catalog in the left menu, and make sure "Catalog Price Scope" under Price is on Website. See image 11.

  4. Save your settings by pressing 'Save Config' in the top right corner.

  5. Choose Currency Setup in the left menu. You can now set a currency for each website: Choose the website from the dropdown menu under "Current Configuration Scope", and change the currency to be used at "Base Currency", "Default Display Currency", and "Allowed Currencies" – see image 12. Note that you have to uncheck "Use Default" to change currencies.


When you've set the currency for each of your websites, you're done.

This is necessary as Magento chooses your base currency when a transaction is captured online. If your customer changed the currency to a different one, the captured amount will be incorrect.


Please notice: You cannot test with other currencies than DKK if you're using a Dankort.

9. Use of MD5

You have to disable the setting ”Use SID on Frontend” to use MD5. 

Go to System -> Configuration -> Web. Find Session Validation Settings, and put ”Use SID on Frontend” at No.

In rare cases the above solution will not work properly as Magento overwrites your settings. If so, ensure that SID is disabled by manually editing the file app/code/core/Mage/Core/Model/App.php

Change the value $_useSessionInUrl from true to false.

Please note that this change is reset if Magento is updated. When you’ve updated Magento, put the value back to false.

10. Add parameters

You can add more parameters to the payment window in Magento to activate different functions, e.g. split payment.

Add and edit parameters in the file (version 2.6+):
\app\design\frontend\base\default\template\epay\standard
\redirect_standardwindow.phtml


For versions older than 2.6, the path is:
\app\design\frontend\default\default\template\epay\standard
\redirect_standardwindow.phtml


Note that the path might be different if you’re using another template.

Click here for a list of all parameters.
Please note:
If you're using MD5, you have to add new parameters under calcMd5Key in the file: \app\code\local\Mage\Epay\Model\Standard.php
- if you don't, the MD5 check will fail, and your payments will be rejected!
Fork me on GitHub