Mercado Pago integration

July 23, 2024

Mercado Pago is a digital payment platform that offers various financial services like instant money transfers and credit options. It allows you to open a free and easy-to-use digital account. You can sell products and instantly receive your money through widely-used payment methods.

Note: MercadoPago is available in Brazil, Argentina, Mexico, Colombia, Chile, Peru and Uruguay. It is currently available in Spanish, Portuguese, and English.

This article is a detailed guide on how to install, configure, and utilize Mercado Pago integration within Kommo. From adding products to creating invoices manually or through automated processes, this guide covers various use cases to optimize your experience with Mercado Pago.

In this article, you will learn:

Mercado Pago integration and its benefits

The Mercado Pago integration is a tool that allows businesses to seamlessly integrate Mercado Pago's digital payment platform with Kommo. Its benefits include:

  • Creating invoices is faster and easier, whether done manually or automatically.
  • Instant money transfers and various popular payment methods for quick and easy transactions.
  • The integration helps you manage digital payments and invoicing, keeping all financial activities organized and efficient.
  • Add and manage invoice items, tailored to your business needs.

How to install the Mercado Pago integration

To install the Mercado Pago integration:

  1. Access Settings > Integrations in Kommo. Search for Mercado Pago and click Install.

  1. Complete the installation by accepting the privacy policy and clicking +Install.

  1. Copy the link from Step 1 (see image below). Then click Mercado Pago set-up.

  1. Once you log into your Mercado Pago account, you will be taken to the Developers panel. There, you have to create an application in order to use the integration. Click Crear aplicación.

  1. Fill out the following form. In the Qué producto estás integrando? field choose either CheckoutAPI or CheckoutPro, depending on what you usually use within Mercado Pago. Click on Crear aplicación.

Note: Mercado Pago offers two different ways for users to complete checkouts: Checkout API and Checkout Pro:

  • Checkout Pro: This is a ready-made solution with a standardized frontend, meaning the user interface and experience are fully designed and set up for you. It's easy to implement since everything is already built.
  • Checkout API: This option offers more customization. You can design and build your own checkout process, tailoring the user interface and experience to fit your specific needs.
  1. Wait for a redirect to the application page. Then click Editar datos.

  1. Scroll down, paste the redirect link you copied from the Kommo integration into the widget, and save the changes.

  1. After saving the changes, you will be automatically redirected to the application page. Here, click on credenciales de producción to access the application data page.

  1. We get to the application data page.Copy Client ID and Client Secret (which is a unique password for connecting to Kommo).

  1. Go back to Kommo and click Next in the integration setup. In the window, paste the Client ID and Client Secret you copied before. Make sure the email address corresponds to the account where the application was created. Otherwise, an error may occur. Click Next.

  1. You will be redirected to the Mercado Pago website. First, provide the necessary permissions.

  1. Next, you need to confirm the connection of the application by entering your email address. The email confirmation code is the last 6 digits of your account ID, which you can find in the popup.

For example, if your Argentine account ID is 1412913923, the confirmation code would be 913923. After you will receive a notification that you have successfully connected the application.

Note: Make sure you have chosen the correct country in your Mercado Pago account. Otherwise, you might encounter errors.

You will be automatically redirected back to Kommo, where you will see that the integration has been successfully installed.

Adding items

To add Mercado Pago items:

  1. In Kommo, create a lead with a contact and save it. If you haven't done it before, check out our How to get started guide. You may also open an already existing lead. Click Setup in the Lead card tabs.

  1. Then click the + button. A list will appear. Select Mercado Pago Items and add items.

An items list has just been created in Kommo. You can view and edit the list by going to Lists > Mercado Pago Items.

How to create an invoice

Mercado Pago invoice is a formal document from a seller to a buyer detailing the goods or services provided, their quantities, and prices. It specifies the amount owed, documents the sale for accounting and tax purposes, includes payment terms and conditions, and serves as a legal record of the transaction for dispute resolution.

There are several ways to create an invoice via Mercado Pago:

Creating an invoice manually

To add an invoice manually, test out the integration, and see how it works, follow these steps:

  1. In Kommo, create a lead with a contact and save it. You may also open an already existing lead.
  2. You’ll see Mercado Pago has been added to the tabs at the top. Click on it.

  1. Click Create Invoice. Next, specify items, fill out the invoice with all the necessary data.

Once you save the invoice, it will be created and appear in the list in the Mercado Pago tab.

Creating an invoice through the Digital Pipeline

Note: Before you create an invoice through the Digital Pipeline, make sure you have created a lead with a contact in Kommo and there is a Mercado Pago items tab in the lead card with items added to it.

  1. Go to the Leads > Automate. In the Discussions stage, click on Add Trigger to open a list of available triggers that can be added to this stage.

  1. Enter Mercado Pago in the Search and filter. You will see the Mercado Pago trigger pop up. Click the + Add button.

  1. Click + Add → The Mercado Pago trigger is added to the Discussions stage, the trigger settings window will open.

  1. Uncheck the Change Status option, then click Done → The trigger configuration window is minimized. Next, click Save in the upper right corner to save the pipeline settings.

  1. Change the status of the lead you are working with from Initial Contact to Discussions. This can be done simply by dragging the lead card to the discussions stage in the pipeline.

It can also be done by changing the lead's status in the lead card.

Creating an invoice via Salesbot

Note: Before you create an invoice through the Salesbot, make sure you have created a lead with a contact in Kommo and there is a Mercado Pago items tab in the lead card with items added to it.

To add an invoice via a Salesbot, follow these steps:

  1. Create a new Salesbot. To learn how to do that, check out our How to create a Salesbot article.
  2. Create a widget step in the Salesbot. A list of widgets that can be added to Salesbot will open. Add a Mercado Pago widget.

  1. Add success and error steps to the bot. For example, in case the invoice is successfully created, the bot will send a note to the Lead card with the text “I created an invoice :)”. If the invoice was not created, the bot will send a note to the Lead card with the text “I didn't create an invoice :(”.
  2. After setting up, click Save & Continue in the right upper corner of the window. The bot will be saved. A triggers window will pop-up, allowing you to customize the trigger for the bot. In the When this happens field, add When lead moved to a pipeline stage. Add Decision making in the For all leads with field.

To learn more about setting up Salesbot triggers, read our configuring trigger settings article.

  1. Click Done.
  2. Change the status of the lead you are working with from Initial Contact to Discussions, then click Save. This can be done simply by dragging the lead card to the discussions stage in the pipeline.

Running the Salesbot in the chat with a lead

Before creating an invoice through a lead chat, ensure the following:

  1. A lead with a contact is created in Kommo.
  2. A Salesbot is configured the same way as described in the previous step.
  3. Items were added to the Mercado Pago items tab in the lead card.

To create an invoice via a Salesbot in the chat with a lead, follow these steps:

  1. Open a chat with a previously created Lead with a Contact. Clicking on the lightning icon. Select the Salesbot with the Mercado Pago widget, then click Run.

  1. Once the bot runs, it will send the invoice to the lead.

To learn more about other Kommo integrations, check out the integrations section of our Knowledge Base.

Integrating Mercado Pago with Kommo offers a seamless and efficient way to manage digital payments and invoicing within your business operations. By following this guide, you can optimize your use of Mercado Pago within Kommo, making financial transactions smoother and more effective.

Need more help setting up or troubleshooting? Contact us by sending an email to support@kommo.com or write to us via WhatsApp. You can also hire a Kommo partner to do all the hard work for you.

Not a user yet? Sign up for our free 14-day trial or book a free live demo to see it in action!

Try Kommo free

Discover how Kommo can transform your client management now