MakeCommerce module for Magento 2

With the MakeCommerce extension, you can add payment and delivery options to your Magento 2 store.

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

• Setting up the MakeCommerce module
• Adding payment methods
• Adding shipping methods
• Processing refunds

1. 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).
2. Downloading the extension is free of charge, as are all version updates. When using the module, a monthly fee according to the price list will apply.
3. Install Magento 2 extension by following the regular procedure, for example by following this tutorial link: installing-extensions.

Setting up the MakeCommerce module

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”.

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.

Updating

1. How to update a MakeCommerce Payment Gateway makecommerce/module-ecommerce:
2. 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.
3. 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.

Adding payment methods

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

1. First you need to add MakeCommerce API credentials for your Shop. Go to Stores > Configuration > Sales > MakeCommerce API. The API credentials are made available for you in MakeCommerce merchant self-service portal (Settings > API).
2. If you want to test payments first, you need to enter the TEST API keys and set the environment to TEST. You can use either the public TEST API keys or a personal test account. To add a personal test account, please contact support@maksekeskus.ee.
3. When you are ready to start accepting real payments, set the environment to LIVE and enter the LIVE API keys.
   
4. Once the API keys have been entered, go to Stores > Configuration > Sales > Payment Methods, where you can further configure the display of payment methods at checkout.
5. There are 2 different ways for displaying the payment methods:
   • Widget – all payment methods are displayed in a compact multi-line block (this is the default option).
   • List – each payment method is displayed on a separate line. We recommend using this option if you are only using a few of the payment methods provided by MakeCommerce and want them to appear equally alongside other payment methods available in your store.
   • When using the widget display, the logo sizes adjust dynamically based on the available space. You can also manually influence the logo size by selecting S, M, or L.

6. You can also configure the settings so that credit cards are displayed separately from bank links. In this case, the checkout will appear as follows (display widget as default selection = no):

7. For card payments you could use either our redirect approach or iframe js to collect card payments data on your webshop environment. Iframe use is a more advanced type of integration and not mandatory for card payments.
   You can find both Regular Payment Flow guide for redirect method or Iframe js for Card Payments in our developer portal.

Adding shipping methods

The module installation adds a shipping method MakeCommerce that you can enable and configure. For Omniva and DPD parcel machine deliveries, we offer a solution where it is not necessary to sign a contract with the shipping companies – see the Shipping+ service.

For integrating other delivery methods (SmartPosti and LP Express, Omniva and DPD courier services), it is necessary to sign a business customer agreement with the respective delivery provider. To conclude a business customer agreement, please first contact the relevant shipping company.

1. To set up deliveries, you need to add the API credentials or the username and password you received from the shipping company or from the respective provider’s self-service portal after concluding the agreement. To add the credentials, navigate to the menu: Stores > Configuration > Sales > MakeCommerce API.
2. Open the view for the desired shipping company, enter the required information, and make sure to fill in the return address (sender’s address) as well. Note: The return address must include a valid mobile phone number with the country code (e.g., +372) and without any spaces.
   
3. After completing the integration, you can activate and further configure the shipping methods from the menu: Stores > Configuration > Sales > Shipping Methods.
   
4. After that, the list of parcel machines will be displayed in your online store.
   If necessary, you can update the list from the menu: Stores > Configuration > Sales > MakeCommerce API > Update Shipping Locations.
   
5. You can also specify that certain products are not suitable for delivery to parcel machines. In such cases, parcel machine options will not be displayed at checkout for those products. Additionally, it is possible to mark certain products as eligible for free shipping. If such a product is the only item in the shopping cart, the shipping cost will be displayed as €0.
   
6. Our module is capable of registering shipments in the Omniva, SmartPosti, LP Express, and DPD systems, and it does so automatically as soon as the order is paid (when it reaches the “Processing” status).
7. At that point, it is also possible to print shipment labels directly from the store’s order view. For example, you can select all orders that are in the Processing status and apply the mass action MC Print Labels (Omniva, SmartPost, LP Express, and DPD shipments can be mixed together).
   

Shipping+

In Estonia and Latvia, we offer the Shipping+ service, allowing you to ship goods to Omniva and DPD parcel machines via MakeCommerce without the need to sign separate contracts with the shipping companies. In this case, all shipping-related service fees are automatically deducted from the merchant’s MakeCommerce account.

This is also convenient because there is no need to process and pay Omniva or DPD invoices separately in accounting. See the Shipping+ pricing.

1. To activate the service, navigate to the menu: Stores > Configuration > Sales > MakeCommerce API.
2. When configuring the Omniva and DPD parcel machine delivery methods, select Yes from the Shipping+ dropdown menu and fill in the return address fields.
3. After that, the list of parcel machines will be displayed in your online store. If necessary, you can update the list from the menu: Stores > Configuration > Sales > MakeCommerce API > Update Shipping Locations.

If you joined Maksekeskus before 2022, please also check whether the Shipping+ service is active for your store in the Maksekeskus self-service portal (Settings → Services).

Processing refunds

All payments made through MakeCommerce can be conveniently refunded directly from the online store’s admin panel. You can find the Refund button next to the Order Invoice, within the Credit Memo dialog.