MakeCommerce module for Magento 2

This extension allows you to accept online payments in Magento 2 using the MakeCommerce/Maksekeskus Payment Gateway.

The module has been released on Adobe Marketplace. To install the latest version of the module, please follow the guide here.

Table of contents

Module functionality
Installation guide
Configuring payment methods
Refunds
Configuring shipping methods
Shipping+

Module functionality

1. Payment methods:
• bank-links of all major banks in Estonia, Latvia, Lithuania, Finland
• credit-card payments (Visa, Mastercard) through MakeCommerce PCI DSS
compliant card dialog (removes compliancy requirement from merchant)
• customizable payment methods presentation
• payment country selector independent from billing/shipping address
• make full or partial refunds from Magento admin interface

2. Shipping methods:
• Omniva, DPD, LP Express, and Itella SmartPost Parcel Machine
• Omniva, DPD, and Itella Courier
• Setting up shipping methods according to country
• Printing of package labels

In order to use the services you need to sign up at https://makecommerce.net/
After sign-up your shop is given credentials for API integration that are needed for the module to work (you can also test out the module without signup, using test-shop credentials). It is necessary to conclude contracts with used suppliers for the use of shipping methods.

Install Magento 2 extension by following the regular procedure, for example by following this tutorial link: installing-extensions

Installation guide

Prerequisites
Before you begin, make sure you have the following:

• A working installation of Magento 2.
• Access to the Adobe Marketplace.
• The extension package file or the extension key.

Step 1: Access the Adobe Marketplace

• Visit the Adobe Marketplace website at https://marketplace.magento.com/.
• Sign in with your Adobe ID or create a new account if you don’t have one.

Step 2: Find and Choose the Extension

• Search for MakeCommerce Payment Gateway extension using the search bar or browse through the available categories.
• Once you find the MakeCommerce Payment Gateway, click on it to access the extension’s page.

Step 3: Get the Extension Key

• On the extension’s page, extension requires a purchase (price is 0.00), make sure to complete the purchase process before proceeding.

Step 4: Install the Extension

There are two methods to install the extension: using Composer or manually.

• Open a terminal or command prompt and navigate to your Magento 2 installation directory.
• Run the following command to install the extension using Composer:
  composer require makecommerce/module-ecommerce

Wait for the Composer to download and install the extension. Once completed, proceed to the next step.

Note: Ensure that you have the correct Composer auth keys in your auth.json file before installing the extension. This is necessary to authenticate and download extensions from the Adobe Marketplace via Composer.

• Download the extension package file from the Adobe Marketplace.
• Extract the package file.
• Upload the extracted extension files to the app/code/Makecommerce/Ecommerce directory of your Magento 2 installation.
• Open a terminal or command prompt and navigate to your Magento 2 installation directory.
• Run the following command to install the extension dependency using Composer: composer require guzzlehttp/guzzle:”>=6.5.0″

Next Step:

• Open a terminal or command prompt and navigate to your Magento 2 installation directory.
• Run the following command to enable the extension:
  php bin/magento module:enable Makecommerce_Ecommerce
• Run the following command to update the database and clear the cache:
  php bin/magento setup:upgrade
• Wait for the process to complete.

Step 5: Verify the Installation

• After the installation process is complete, run the following command to verify the extension installation:
• Copy code
  php bin/magento module:status
• You should see the installed extension listed with its status set as “Enabled”.

Congratulations! You have successfully installed a MakeCommerce Payment Gateway extension from the Adobe Marketplace. You can now configure and use the MakeCommerce Payment Gateway to enhance the functionality of your Magento 2 store.

Update

How to update a MakeCommerce Payment Gateway makecommerce/module-ecommerce:
makecommerce/module-ecommerce:

composer update makecommerce/module-ecommerce
Composer will check for the latest version of the package available in the repositories specified in your composer.json file and install the updated version if it exists.

It’s worth noting that Composer will update the package to the latest version allowed by the version constraints defined in your composer.json file. If you want to update to the latest version regardless of the version constraints, you can use the
composer update makecommerce/module-ecommerce –with-dependencies command.

Configuring payment methods

The module installation adds a payment method “MakeCommerce” that you can enable and configure.

API keys

First you need to add Maksekeskus API credentials for your Shop. Go to Stores > Configuration > Sales > MakeCommerce API.
The API credentials are made available for you in Maksekeskus Merchant Portal (Settings > API).
Note that we have also a separate Test Environment, and you may ask us to create also an account for you in the Test Environment.
You can put into the Module configuration API keys of both Live and Test environments and switch between them.

 

Storefront UI settings

Once you have put in the API credentials, got to Stores > Configuration > Sales > Payment Methods. You can then further fine-tune the UI settings in the module configuration to find the best combination for your shop layout.

 

Widget vs List

There are two presentation modes for the payment options:

• Widget – all methods are presented in compact multi-row block. This is the default way.
• List – each method provided by our module is presented on a separate row equally to other payment methods. Use this option if you want to use only few specific methods provided by us and want them to be listed equally aside the other payment methods you may have in the shop.

Size of Logos

The widget of payment methods is responsive and changing the size of logos dynamically regarding the size of the place available.
However you can slightly influence the size by selecting between S, M and L size setting.

Credit cards in separate widget

You may choose to place the credit cards a bit separately from the bank-links.
This is how it looks then (also, display widget as default selection = No):

 

Custom order of channels

The default order of payment channels in the widget or list is defined by Maksekeskus, we try to put most popular to the most prominent place. However you can define your own order by entering comma separated list of channel-names. i.e. “lhv, coop, seb”
If your list does not include all the channels, the rest will be then listed after yours.

 

Credit Card payments

Our credit card payment dialog is built this way that the sensitive card data input goes in iFrame directly to our backend systems. The card data does not pass your systems and thus your systems are not subject to PCI DSS compliancy.

Refunds

You can also do refunds to payments made through our Payment Gateway right from Magento store admin interface.
You will find the “Refund” button in Credit Memo dialog of an Order’s Invoice.
See more information about Refunds.

Configuring shipping methods

The module installation adds a shipping method “Makecommerce” that you can enable and configure. To integrate the shipping module you need to sign a contract with the shipping provider (Omniva, Itella, DPD, LP Express).

API keys

Similarly to configurating payment methods, first you need to put in API credentials that you received from shipping provider. Go to Stores > Configuration > Sales > Makecommerce API to integrate Makecommerce shipping modules. Enter username and password and fill out the return address. NB! Return address for Omniva must contain a valid mobile number with country code (e.g +372)!

Shipping settings

After inserting API credentials, you can activate Makecommerce shipping methods from Stores > Configuration > Sales > Shipping Methods.

After this a list of parcel machines is added to the store’s checkout page. You can update the list from Stores > Configuration > Sales > Makecommerce API > Update Shipping Locations.

It’s also possible to mark some of your products as “not suitable for Parcel Machine shipment”. Or mark that the product is entitled to free shipping in parcel terminal (if it is the only product in cart).

 

Integration with SmartPost, Omniva, DPD, and LP Express

The module can automatically create shipments into delivery operators´ systems when the order has been paid.

Once this automation is activated you can print out the package labels right form the shop administration panel (orders view).

You can select all orders in processing state and with one click print out Omniva, Smartpost, DPD, and LP Express shipment labels mixed. Choose “MC Print Labels”.

For this to work you have to sign up and create user accounts for your business at delivery companies and then configure the plugin with username and password of those accounts.

Omniva.ee

For sign-up go to https://www.omniva.ee/business

You will be assigned an account manager, you will find contacts in Omniva e-service.

Send your account manager an email pointing that you want to apply for WebServices account.

Once you get your WebServices account username and password, use them in the plugin’s shipment method configurations settings for the integration.

Shipments

If configured, the plugin will automatically create a new shipment in Omniva.ee system. The shipments going to parcel machine are created as “Parcel machine service” with “Parcel arrival SMS” and “Parcel arrival e-mail” (code PA+ST+SF).

For the Ominiva Courier service you have 2 options – hand the packages over in Omniva Post Office (QP) or take the packages to a parcel machine (PK).

The service type is B2C – no manual work or confirming is needed (or even possible) in Omniva business customer e-service. You will see the shipments listed in omniva.ee e-service (under the list of shipments) only after they have physically handed over to Omniva.

You (and your customer) can track the shipment anytime on omniva.ee webpage.

SmartPost.ee

For sign-up go to smartpost.ee sign-up form.

Once you get the username and password use them in the plugin shipment method configurations settings for the integration.

If configured, the plugin will automatically create a new shipment in smartpost.ee system when the order gets paid. You will see the SmartPost shipment number in order details. You can see the shipments created also in smartpost.ee self service interface.

DPD Interconnect

First you need to sign agreement with DPD. Once you have the agreement you need to ask DPD for Interconnect account (contact your account manager or sales@dpd.ee). Enter Interconnect user name and password into extension settings.

After that the plugin is able to automatically register shipments to DPD system after the order has been paid through Maksekeskus MakeCommerce.

Parcel labels can be printed from orders view. Call DPD for courier once you are ready to hand over the parcels.

LP Express

LP Express parcel machine delivery is available in Lithuania. The overall functionality is similar to other parcel machine carriers with the only difference being a parcel machine size that has to be chosen by the merchant.

In the WooCommerce module admin settings, the merchant can choose a default size for all the orders that are registered. Each order can be manually registered again with a different size, but a default setting is required for the initial registration. This template size determines the box which is used in the parcel machine.

Shipping+

In Estonia and Latvia we offer a solution that allows Omniva and DPD parcel machine delivery without having to sign a business client contract with the carriers. Shipping costs are automatically calculated from your store’s MakeCommerce account. The service price is available in price list and the same price is also valid for returns. When using delivery via MakeCommerce the price is not dependant on the size of the package.

Service activation
The merchant must have a valid service contract with Maksekeskus/Makecommerce and use Magento delivery module in their e-store.

In the MakeCommerce self-service portal click Settings -> Services to find out whether the Shipping+ terms have been accepted. If they have not, then read the terms and click “Enable service”.

The last step is to configure for DPD and/or Omniva “I use the contract through MakeCommerce” (MC Transportation Service) in the admin panel of your e-shop. Go to Stores -> Configuration -> Sales -> MakeCommerce API.