Reading list Switch to dark mode

    Magento 2 Multi Vendor Mercadopago Connect Payment

    Updated 17 October 2023

    Magento 2(Adobe Commerce) Marketplace Mercadopago Connect Payment extension allows you to provide Mercadopago online payment method for receiving payments within the marketplace. Mercadopago is the leading online payment solution in Latin America and now it’s integrated with our marketplace extension. This extension will be able to provide split payment for the sellers of the marketplace. The customers will be able to make use of their Credit Card and EMI(Easy Installments) option for making online payments.

    **Note: This extension is an add-on to Webkul’s Marketplace. To make use of this add-on you must have first installed the Webkul’s Magento 2 Multi Vendor Module.


    • Provide split payment to sellers for your Marketplace store.
    • Credit Cards & EMI(Easy Installments) payment option for making the purchases.
    • Full Refund from the Admin and seller’s end.
    • Seller Authentication for receiving payments.
    • Enable/disable payment method from the admin panel.
    • The admin can set the payment method title visible at checkout.
    • The admin can configure his Mercadopago application from the module backend.
    • Seller has to allow his Mercadopago account for receiving payments within the marketplace.
    • The source code is 100% open for customization.
    • Supports multiple language translations.


    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 Magento 2 root directory on the server as shown below.

    After the successful installation, you have to run these commands in the Magento 2 (Adobe Commerce)root directory.

    First command- php bin/magento setup:upgrade

    Searching for an experienced
    Magento 2 Company ?
    Find out More


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

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

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


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

    Language Translation

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


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


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


    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.


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


    After selecting the country, tap the enter button.


    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.

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


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


    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.

    ** Note: The re-direct URL should be – your website URL/mercadopago/seller/auth/

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


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

    ** Note:

    1. To get the Public Key and the Access token click here.
    2. Re-direct URL should be like – your website URL/mercadopago/seller/auth/

    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.

    Admin Configuration

    After the successful installation of the extension, the admin will navigate to Stores->Configuration-> Sales->Payment Methods->Other Payment Methods>Marketplace Mercadopago Connect payment Method to configure the extension.

    To configure the extension, the admin will –

    • Enable the payment method by selecting it as “Yes” else select “No” to disable the extension.
    • 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 mode as – Sandbox by selecting “Yes” or Production 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 Seller Permission button label text.
    • Set the Minimum and Maximum order total for the payment method.

    Seller – Configuration

    After login, the Vendors will have a new menu option under their marketplace block with the name Mercadopago Configuration. Now, when a vendor has logged in to his account panel and is on the “Mercadopago Configuration” page, the vendor will see a button to authorize. This will allow the seller to start receiving the payments as shown below.

    allow for payment

    After clicking the “Allow For Mercadopago Payment” button, you will see a screen for the login to Mercadopago. If you have an account at Mercadopago, then just enter the Email or the username to continue else tap the “Create account” link to create one and then proceed further. Login-Section-Mercadopago

    After login, you need to tap the “Allow” button to start receiving the payments.

    Login Authentication Mercadopago

    After authorization, the vendor will see a success message for the same and can now start receiving the payments easily.

    authorized account

    Also, whenever the authentication token gets expired the vendors will see a message for the same under Mercadopago configuration. The vendor then again needs to authenticate by clicking the button “Allow For Mercadopago Payment” to start receiving the payments again.allow for auth

    Workflow – Buyer’s 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 from multiple sellers into the cart and going to the checkout, the buyer can see the Mercadopago payment method under the payment methods. Selecting the Marketplace Mercadopago Connect Payment(payment method name set in the admin backend) you will have 2 options to make the payment via –

    1. Credit CardCheckout-Page
      The customer can see the details of the order having the selected payment method. Clicking the invoice tab will show the invoice of this order and the customer can print the invoice for the order.Customer-Order-Details
    2. EMI(Easy Installments) –
      Here, the customers can select to pay using EMI(Easy Installments) option. The customers will select the installments from the drop-down.
      The customer can see the details of the order having the selected payment method. Clicking the invoice tab will show the invoice of this order and the customer can print the invoice for the order.

    Admin Management

    The admin can find all the seller’s Mercadopago account details by navigating to Marketplace Management->Mercadopago Detail.

    Under the Mercadopago Detail section, the admin will be able to see all the seller account details like – Seller email Id, Mercadopago User Id, Token type, Scope, Create at, and Expired on. The admin can also delete the Mercadopago seller account details by selecting account details that are to be deleted and then selecting the delete option from the action drop-down.


    Refund Process – Seller’s & Admin End

    Refund at Seller’s End:

    To make a refund, the seller will navigate to the My Order History Section under the Marketplace block. Here, the seller will click the View Order button for the order which is to be refunded.
    Customer Order Invoice Details

    Now, the seller will click the Credit Memo button to make a refund to the customer as shown below in the snapshot.

    Seller Make Refund

    This brings up a section where the seller can make a refund to the customer. The seller will select the items to refund, enter the comments for the credit memo and then lastly, click the Refund button to make a refund.

    Seller Makes Refund

    Refund at Admin’s End:

    Similarly the admin will also be able to make a refund for his orders by navigating to the Orders section and then clicking on the View link for the respective order.

    Admin Makes Refund

    After clicking the View link, the order information page will open up. Here, the admin will generate the invoice for the order first by going to the Invoices section. After that, the admin will click on the Credit memo button to make a refund.

    Admin Makes Refund

    This brings up a section where the admin can make a refund to the customer. The admin will select the items to refund, enter the comments for the credit memo and then lastly, click the Refund button to make a refund as shown below in the snapshot.

    Admin Makes Refund

    That’s all for this Magento 2(Adobe Commerce Cloud) Marketplace MercadoPago Connect extension. If you have any queries or suggestions regarding the extension please get back to us at

    Current Product Version - 5.0.0

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

    . . .

    Leave a Comment

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


  • fernando pen
    • Jyotsna Gautam (Moderator)
  • 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