Back to Top

Magento 2 Mercadopago Payment Gateway

Updated 4 January 2024

Magento 2 Mercadopago Payment Gateway module allows the admin to provide Mercadopago online payment method to customers for receiving payments for their purchases. Mercadopago is the leading online payment solution in Latin America and now it’s integrated with the Magento 2. This enables the customers to select Mercadopago payment method on the checkout page and make a payment.

The customers will be able to make use of their Credit Card and EMI(Easy Installments) option for making the online payments. This module lets your customers to conveniently shop without any hassle. It also boosts your sales providing an ultimate payment method to your customers.

Features

  • The admin can configure his Mercadopago application from the module backend.
  • The admin can enable/disable the payment method from the admin panel.
  • Set the payment method title which will be displayed at the front-end.
  • Define the Minimum and Maximum order total for enabling the Mercadopago payment method.
  • Credit Cards & EMI(Easy Installments) payment option for making the purchases.
  • The admin can make an easy refund to the customer.
  • The source code is 100% open for customization.
  • Supports multiple language translations.

Installation

Customers will get a zip folder and they have to extract the contents of this zip folder on their system. The extracted folder has an src folder, inside the src folder you have the app folder. You need to transfer this app folder into the Magento2 root directory on the server as shown below.
Installation-Magento2-Marketplace-Mercadopogo-Connect-extension

After the successful installation, you have to run these commands in the Magento2 root directory.

First command- php bin/magento setup:upgrade

Searching for an experienced
Magento 2 Company ?
Find out More

cmd

Second Command – php bin/magento setup:di:compile

cmd

Third Command – php bin/magento setup:static-content:deploy

cmd

Lastly, run the below command for getting the Mercadopago.

Fourth Command – composer require mercadopago/sdk:0.5.2

cmd

After running the commands, you have to flush the cache from Magento admin panel by navigating through->System->Cache management as shown below.

Installation-Magento2-Marketplace-Mercadopogo-Connect-extension

Configuration For Multi-Lingual Support

For the multilingual support, the admin will navigate through Store->Configuration->General ->Locale Options and select the locale as German (the language into which admin want to translate his store content).
Multi-Lingual-Support

Language Translation

If you need to do the module translation, please navigate the following path in your system. app/code/Webkul/Mercadopago/i18n. Open the file named en_US.CSV for editing as shown in below screenshot.

language-Translation-Magento2-Canada-Post-Shipping

Once you have opened the file for editing. Replace the words after the comma(,) on the right with your translated words.

language-Translation-Magento2-Canada-Post-Shipping

After editing the CSV file, save it and then upload it to the same folder. Now your module translation is complete.

language-Translation-Magento2-Canada-Post-Shipping

How To Create Your Application

Step 1:

Go to this link and login to your account – MercadoPago Connect to create your first application and then click the “Create your application” link.
**Note: The admin should have an account at Mercadopago.

Click-Create-Application-Mercadopago

Step2:

Now, select the country in which you are going to manage your application.

image

Step3:

After selecting the country, tap the enter button.

image

Step4:

Now, enter your email address/username for your Mercadopago account and click continue after that. If you don’t have an account with the MercadoPago you can click here to create one.
Enter-Credentials

After clicking the Continue button, you have to enter the password for the entered email address/username and then click the – Sign In button.
Enter-Password

Step5:

After login, you will now be able to create your application by clicking on the “Create New Application“.
My-Applications

Step6:

Clicking the “Create New Application” brings up a new page to create the application. Here, enter all the required information for creating the application and click “Create Application” to create one for you.

image

After you have created an application you can find it under the “My Applications“.

My-Apps

**Note: To get the App Id and the Secret Key click on the “Details” button visible in front of your created application as shown in the image above.

image

** Note:

  1. To get the Public Key and the Access token click here.

If you are using the application in the Sandbox(testing) mode use the SandboxPublic key and the Access token. Else if it’s in the production mode use Production modePublic key and access token.
Credentials

Module Configuration

After the installation, the admin will configure the module settings. For this, the admin will navigate to Stores -> Configuration -> Sales -> Payment Methods -> Mercadopago Connect Payment Method as per the below image.

configuration

Here, the admin will –

  • Set the payment method as Enabled or disabled.
  • Choose your country in which you are going to manage your application.
  • Enter the Admin’s Email address that will be used to validate the transactions and to receive the transaction communications.
  • Choose the Payment method mode as Sandbox mode by selecting “Yes” else the Production mode by selecting No”.
  • Set the Title for the payment method which is visible to the customers at the checkout time.
  • Enter the App Id/Client Id, and the Secret Key/Client Key.
  • Enter the Public key and the Access Token.
  • Set the Minimum and Maximum order total for enabling the Mercadopago payment method.

Front-End

**Note: While using our Demo you can make use of the Test Cards specified by Mercadopago that can be used for making the purchases.

After adding products to the cart, the customer will go to the checkout page. On the checkout page, the customer can see the Mercadopago payment method under the payment methods. Selecting the Mercadopago Connect Payment(payment method name set in the admin backend) you will have 2 options to make the payment via –

1. Credit Card:

image

Here, without navigating to the Mercadopago gateway window the customer can fill all the payment details and proceed further by clicking on the Place Order button. The customer will get the success message as per the image.

image

Once the order is placed successfully, the customer will navigate to My Orders to view the order details as per the below image.

image

Here in the order details, the customer can view the payment method using which the order was placed.

2.  EMI(Easy Installments):
Using this option the customers can pay using EMI(Easy Installments) for their purchase. This option will allow the customers to pay in easy monthly installments.

image

The customer simply selects the EMI installment plan from the drop-down list “Installments” as per the choice. And without navigating to the Mercadopago gateway window the customer can fill all the payment details and proceed further by clicking on the Place Order button. The customer will get the success message as per the image.

image

Once the order is placed successfully, the customer will navigate to My Orders to view the order details as per the below image.

image

Order Management

The admin can easily view and manage the orders placed through Mercadopago payment method. For this, the admin will navigate to Orders as per the below image.

image

Here, the admin can view the complete list of orders. And can select the order to view and manage the orders.

Refund

After clicking the View link, the order information page will open up as per the below image.

image

Once the invoice has been generated, the admin can easily make the refund. For this, the admin will simply click on the Credit memo button to make a refund.

image

This will brings up a section where the admin can make a refund to the customer as per the below image.

image

Here, the admin will select the items to be refunded, enter the comments for the credit memo and then lastly, click the Refund button to make a refund.

Transaction

The admin can also view the transaction details of Mercadopago Payment method of all the orders by navigating to Sales -> Transaction as per the image.

image

That’s all for the Magento 2 Mercadopago Payment Gateway module. If you still have any issue, feel free to add a ticket at https://webkul.uvdesk.com/.

Current Product Version - 2.1.0

Supported Framework Version - Magento 2.0.x, 2.1.x, 2.2.x,2.3.x, 2.4.x

Blog Version - Magento 2.0.x, 2.1.x, 2.2.x,2.3.x, 2.4.x
  • Version 2.0.x, 2.1.x, 2.2.x & 2.3.x
  • Version 2.0.x, 2.1.x & 2.2.x
. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

Table of Content