Plugin documentation

You can find our plugins for several e-commerce systems and their documentation:

Drupal Commerce
Magento
OpenCart
Prestashop
Virtuemart
Woocommerce

Payment page languages and currencies

After completing an order in a webshop, the customer is forwarded to the payment page where they pay the given amount by card. If the transaction is successful, the customer returns to the webshop from the payment page.

The payment page is available in the following languages: Icelandic (IS), English (EN), German (DE), French (FR), Russian (RU), Spanish (ES) Italian (IT), Portuguese (PT), Slovenian (SI), Hungarian (HU), Swedish (SE), Dutch (NL), Polish (PL), Norwegian (NO), Czech (CZ), Slovak (SK), Croatian (HR), Serbian (SR), Romanian (RO), Danish (DK), Finnish (FI) and Faroese (FO).

The responsive payment page is user friendly and gives you the same user experience on mobile, tablet and desktop too. It uses HTML5 and CSS3.

You can customize your logo on the payment page. Borgun settlements are in your local currency, but you can accept several other currencies and also you can get paid in your chosen currency (GBP, USD, EUR, DKK, NOK, SEK, CHF, CAD, HUF, BHD, AUD, RUB, PLN, RON, HRK, CZK, ISK) We can transfer you money to any bank account you own in your country.

Testing

After setting up the payment module, it is recommended to test the payment to be sure it works properly. We provide you a test card for successful payments. Transactions made in test environment are not real and will be deleted. Please do not use the test cards outside the test environment!

Successful payment

Start a new order in your webshop and select Borgun as payment method. On the payment page use the test card to simulate a successful transaction and press Pay button. After the payment is done, you will be redirected to your webshop.

Card number: 4741 5200 0000 0003
CVC: 000
Expiration date: anything
Name: anything

2018

-2018

Canceled payment

Start a new order in your webshop and select Borgun as payment method. You do not need to fill any data on the payment page, press Cancel button and you will be redirected to your webshop.

2018

-2018

Failed payment

Start a new order in your webshop and select Borgun as payment method. On the payment page use a mistyped cersion of the test card (for example change the last two digit or CVC) to simulate a failed transaction and press Pay button. The payment page will show you an error message about the problem.

Card number: 4155 5200 0000 0002
CVC: 121
Expiration date: anything
Name: anything

2018

-2018

Check your webshop version

Find out if our plugins are compatible with your webshop or not.

Drupal

Log in to your Drupal admin and go to 'Reports' and select 'Status report'. In the first two lines you will see the version of Drupal and the version of your Commerce profile.

drupal-commerce-version-check

Magento

Log in to your Magento admin and check the version at the bottom of the page.

magento-version-check

OpenCart

Log in to your Opencart admin and check the version at the bottom of the page.

opencart-version-check

PrestaShop

Go to your PrestaShop admin login page and check the version at the top of the page.

prestashop-version-check

VirtueMart

Log in to your Joomla admin and go to Components > VirtueMart.

In VirtueMart 1, the version is at the bottom of the page.

virtuemart-version-check

In VirtueMart 2 and VirtueMart 3, the version is on the left, at the bottom of the menu.

virtuemart-version-check

virtuemart-version-check

WooCommerce

Log in to your Wordpress admin and go to 'Plugins'. Find Woocommerce in the list and you can check its version.

woocommerce-version-check

Drupal Commerce

I agree and accept the terms and conditions.

Before installation

It is recommended to make a backup of your files and database before installation.

Installation

Use Drupal's module installer, you can find it at 'Modules / List'. Select 'Install new module' at the top of the list and choose the installation file from your computer and hit Install button.

After installation, turn on the module and hit Save configuration button at the bottom of the page.

Module setup

Find the module in the list and select 'Configure' at the end of the line.

You will se the available payment methods. Find Borgun and select 'Enable'.

After you enabled the module, select 'Edit'.

In the 'Actions' panel find Borgun and select 'Edit'

Here you can set payment options.

Merchant e-mail

If not empty, you will get emails about payments.

Webshop logo on payment page

Image that will be displayed in top left position on the payment page above Merchant details.

Forward customer's name

If set no, your customer will have to write down his name in the payment form. Otherwise it will be filled in, but cannot be changed.

Collect customer details

Your customer has to enter its email address, cell number and address if Collect customer details is set to Yes. In this case, if Mechant e-mail is not empty, you will get the customer's details to that e-mail address.

Skip receipt Page

If set to yes, the customer will be returned directly after payment to the webshop.

Show additional brands

You show additional brands if you choose Yes. If you choose No, only Mastercard and Visa brands will be shown on the payment page. It is recommended to turn it off, so your customers will only see the accepted cards.

Successful payment status

Set default status for Successful payment.

Unsuccessful payment status

Set default status for Unsuccessful payment.

Canceled payment status

Set default status for Canceled payment.

Merchant setup

You need to set the three keys you got from Borgun to be able to process payments. If you would like to accept several currencies, you need separate keys for each currency. You can use TEST mode at the beginning to test the payment process. In TEST mode, there are no real transactions!

TEST environment

You will be sending TEST transactions if you choose Yes. In test mode there are no real transactions. Be careful and don't make it available to your customers. If you choose No, you need to use your live credentials, provided by Borgun.

Merchant ID

Merchant ID provided by Borgun.

Secret key

Secret key provided by Borgun.

Payment gateway ID

Payment gateway ID provided by Borgun.

Please note, that in TEST environment, you need to use test credentials.
Merchant ID: 9275444
Secret key: 99887766
Payment gateway ID: 16

Magento

I agree and accept the terms and conditions.

Before installation

It is recommended to make a backup of your files and database before installation.

Installation

Use Magento Connect to install the module. Select 'System > Magento Connect > Magento Connect Manager' and log in to the app.

Select the file with Choose file button and Upload the file.

Is the installation is successful, you will see a message in the black screen at the bottom of the window. After installation, the module will appear as the last item in the table.

Now go back to the admin, click „Return to Admin” in the top right corner of the page.

Module setup

In Magento Admin select 'System > Configuration' in the menu.

On the left, select 'Payment Methods'

Merchant e-mail

If not empty, you will get emails about payments.

Webshop logo on payment page

Image that will be displayed in top left position on the payment page above Merchant details.

Forward customer's name

If set no, your customer will have to write down his name in the payment form. Otherwise it will be filled in, but cannot be changed.

Collect customer details

Your customer has to enter its email address, cell number and address if Collect customer details is set to Yes. In this case, if Mechant e-mail is not empty, you will get the customer's details to that e-mail address.

Skip receipt Page

If set to yes, the customer will be returned directly after payment to the webshop.

Show additional brands

You show additional brands if you choose Yes. If you choose No, only Mastercard and Visa brands will be shown on the payment page. It is recommended to turn it off, so your customers will only see the accepted cards.

Successful payment status

Set default status for Successful payment.

Unsuccessful payment status

Set default status for Unsuccessful payment.

Canceled payment status

Set default status for Canceled payment.

Merchant setup

You need to set the three keys you got from Borgun to be able to process payments. If you would like to accept several currencies, you need separate keys for each currency. You can use TEST mode at the beginning to test the payment process. In TEST mode, there are no real transactions!

TEST environment

You will be sending TEST transactions if you choose Yes. In test mode there are no real transactions. Be careful and don't make it available to your customers. If you choose No, you need to use your live credentials, provided by Borgun.

Merchant ID

Merchant ID provided by Borgun.

Secret key

Secret key provided by Borgun.

Payment gateway ID

Payment gateway ID provided by Borgun.

Please note, that in TEST environment, you need to use test credentials.
Merchant ID: 9275444
Secret key: 99887766
Payment gateway ID: 16

Opencart

I agree and accept the terms and conditions.

Before installation

It is recommended to make a backup of your files and database before installation. You will need an FTP client (FileZilla for example) to upload the modules files. Extract the archive somewhere on your computer and upload the files directly to you Opencart's installation folder.

Installation

After successfully uploading the files via FTP, the plugin will appear in the Payment Methods list. Go to 'Extensions > Payment methods', find Borgun in the list and click 'Install' at the end of the line.

Module setup

You can set up the module with the 'Edit' button at the end of the line. When you are finished, do not forget to save your settings.

Merchant e-mail

If not empty, you will get emails about payments.

Webshop logo on payment page

Image that will be displayed in top left position on the payment page above Merchant details.

Forward customer's name

If set no, your customer will have to write down his name in the payment form. Otherwise it will be filled in, but cannot be changed.

Collect customer details

Your customer has to enter its email address, cell number and address if Collect customer details is set to Yes. In this case, if Mechant e-mail is not empty, you will get the customer's details to that e-mail address.

Skip receipt Page

If set to yes, the customer will be returned directly after payment to the webshop.

Show additional brands

You show additional brands if you choose Yes. If you choose No, only Mastercard and Visa brands will be shown on the payment page. It is recommended to turn it off, so your customers will only see the accepted cards.

Successful payment status

Set default status for Successful payment.

Unsuccessful payment status

Set default status for Unsuccessful payment.

Canceled payment status

Set default status for Canceled payment.

Merchant setup

You need to set the three keys you got from Borgun to be able to process payments. If you would like to accept several currencies, you need separate keys for each currency. You can use TEST mode at the beginning to test the payment process. In TEST mode, there are no real transactions!

TEST environment

You will be sending TEST transactions if you choose Yes. In test mode there are no real transactions. Be careful and don't make it available to your customers. If you choose No, you need to use your live credentials, provided by Borgun.

Merchant ID

Merchant ID provided by Borgun.

Secret key

Secret key provided by Borgun.

Payment gateway ID

Payment gateway ID provided by Borgun.

Please note, that in TEST environment, you need to use test credentials.
Merchant ID: 9275444
Secret key: 99887766
Payment gateway ID: 16

Prestashop

I agree and accept the terms and conditions.

Before installation

It is recommended to make a backup of your files and database before installation.

Installation

Go to Prestashop's 'Modules and Services' menu and use 'Upload a new module' button in the top right corner, then choose the file from your computer and upload it.

After you uploaded it, search for 'Borgun' in the module search and when it finds Borgun module, select 'Install' at the end of the line.

When you install, Prestashop will ask if you would like to proceed with the installation, press 'Proceed with the installation' button.

Module setup

After installation you can setup the parameters of the module.

Merchant e-mail

If not empty, you will get emails about payments.

Webshop logo on payment page

Image that will be displayed in top left position on the payment page above Merchant details.

Forward customer's name

If set no, your customer will have to write down his name in the payment form. Otherwise it will be filled in, but cannot be changed.

Collect customer details

Your customer has to enter its email address, cell number and address if Collect customer details is set to Yes. In this case, if Mechant e-mail is not empty, you will get the customer's details to that e-mail address.

Skip receipt Page

If set to yes, the customer will be returned directly after payment to the webshop.

Show additional brands

You show additional brands if you choose Yes. If you choose No, only Mastercard and Visa brands will be shown on the payment page. It is recommended to turn it off, so your customers will only see the accepted cards.

Successful payment status

Set default status for Successful payment.

Unsuccessful payment status

Set default status for Unsuccessful payment.

Canceled payment status

Set default status for Canceled payment.

Merchant setup

You need to set the three keys you got from Borgun to be able to process payments. If you would like to accept several currencies, you need separate keys for each currency. You can use TEST mode at the beginning to test the payment process. In TEST mode, there are no real transactions!

TEST environment

You will be sending TEST transactions if you choose Yes. In test mode there are no real transactions. Be careful and don't make it available to your customers. If you choose No, you need to use your live credentials, provided by Borgun.

Merchant ID

Merchant ID provided by Borgun.

Secret key

Secret key provided by Borgun.

Payment gateway ID

Payment gateway ID provided by Borgun.

Please note, that in TEST environment, you need to use test credentials.
Merchant ID: 9275444
Secret key: 99887766
Payment gateway ID: 16

Virtuemart

I agree and accept the terms and conditions.

Before installation

It is recommended to make a backup of your files and database before installation.

Installation

Go to 'Extensions > Manage' in your Joomla admin and select 'Upload package file', choose the plugin file from your computer and upload it.

After you successfully installed the plugin, go to 'Extensions > Plugins', search for 'Borgun' and publish the plugin. (It is published if there is a green tick before the plugin's name).

Module setup

Now you need to set up the payment in Virtuemart. Go to Virtuemart, select 'Shop', then 'Payment methods'.

Add a new payment method. On the first tab you need to fill the payment method's name, publish it and select Borgun from the dropdown list.

On the second tab, you can set up the plugin.

Merchant e-mail

If not empty, you will get emails about payments.

Webshop logo on payment page

Image that will be displayed in top left position on the payment page above Merchant details.

Forward customer's name

If set no, your customer will have to write down his name in the payment form. Otherwise it will be filled in, but cannot be changed.

Collect customer details

Your customer has to enter its email address, cell number and address if Collect customer details is set to Yes. In this case, if Mechant e-mail is not empty, you will get the customer's details to that e-mail address.

Skip receipt Page

If set to yes, the customer will be returned directly after payment to the webshop.

Show additional brands

You show additional brands if you choose Yes. If you choose No, only Mastercard and Visa brands will be shown on the payment page. It is recommended to turn it off, so your customers will only see the accepted cards.

Successful payment status

Set default status for Successful payment.

Unsuccessful payment status

Set default status for Unsuccessful payment.

Canceled payment status

Set default status for Canceled payment.

Merchant setup

You need to set the three keys you got from Borgun to be able to process payments. If you would like to accept several currencies, you need separate keys for each currency. You can use TEST mode at the beginning to test the payment process. In TEST mode, there are no real transactions!

TEST environment

You will be sending TEST transactions if you choose Yes. In test mode there are no real transactions. Be careful and don't make it available to your customers. If you choose No, you need to use your live credentials, provided by Borgun.

Merchant ID

Merchant ID provided by Borgun.

Secret key

Secret key provided by Borgun.

Payment gateway ID

Payment gateway ID provided by Borgun.

Please note, that in TEST environment, you need to use test credentials.
Merchant ID: 9275444
Secret key: 99887766
Payment gateway ID: 16

Woocommerce

I agree and accept the terms and conditions.

Before installation

It is recommended to make a backup of your files and database before installation.

Installation

Use Wordpress' plugin installer, you can find it at 'Plugins / Add new'. Select 'Upload Plugin' at the top and choose the installation file from your computer and hit 'Install Now' button. The installation process ends with a 'Plugin installed successfully.' message.

After successful installation the next step is to activate plugin. Hit 'Activate plugin' button.

Plugin setup

Choose 'Settings' under the plugin's name and set up the plugin according to your preferences.

Merchant e-mail

If not empty, you will get emails about payments.

Webshop logo on payment page

Image that will be displayed in top left position on the payment page above Merchant details.

Forward customer's name

If set no, your customer will have to write down his name in the payment form. Otherwise it will be filled in, but cannot be changed.

Collect customer details

Your customer has to enter its email address, cell number and address if Collect customer details is set to Yes. In this case, if Mechant e-mail is not empty, you will get the customer's details to that e-mail address.

Skip receipt Page

If set to yes, the customer will be returned directly after payment to the webshop.

Show additional brands

You show additional brands if you choose Yes. If you choose No, only Mastercard and Visa brands will be shown on the payment page. It is recommended to turn it off, so your customers will only see the accepted cards.

Successful payment status

Set default status for Successful payment.

Unsuccessful payment status

Set default status for Unsuccessful payment.

Canceled payment status

Set default status for Canceled payment.

Merchant setup

You need to set the three keys you got from Borgun to be able to process payments. If you would like to accept several currencies, you need separate keys for each currency. You can use TEST mode at the beginning to test the payment process. In TEST mode, there are no real transactions!

TEST environment

You will be sending TEST transactions if you choose Yes. In test mode there are no real transactions. Be careful and don't make it available to your customers. If you choose No, you need to use your live credentials, provided by Borgun.

Merchant ID

Merchant ID provided by Borgun.

Secret key

Secret key provided by Borgun.

Payment gateway ID

Payment gateway ID provided by Borgun.

Please note, that in TEST environment, you need to use test credentials.
Merchant ID: 9275444
Secret key: 99887766
Payment gateway ID: 16