Articles on: Payments

How to integrate your Mercado Pago account with systeme.io

In this article, you will learn how to integrate your Mercado Pago account with systeme.io.


You will need:


To connect to a Mercado Pago account, go to your profile picture in your systeme.io account and click on "Settings" (number 1 in the image), then click on "Payment Gateways" from the menu on the left of the page. (number 2 in the image)


In the payment gateways section, click "Connect" for the Mercado Pago option.

n the popup that appears, you will be asked to fill in the "API Public Key", "Access Token", and "Country" fields :

o generate and get the production credentials for your Mercado Pago account, log in to your account and follow these steps:


1) Generate the Mercado Pago credentials


1.1 On the main panel of your Mercado Pago account, click on "Your Business" (number 3 in the image), and then on "Settings". (number 4 in the image)


1.2 Click the "Integrations" option. (number 5 in the image)


1.3 Next, click the "Credentials" option. (number 6 in the image)


1.4 On the "Credentials" section, you will need to create an "Application" to generate this set of credentials by clicking the button "Create application". (number 7 in the image)


A new screen will be displayed, where you must:

  • Assign a name to your application
  • Select the "Online Payments" option
  • Answer "Yes" to the question "Are you using an e-commerce platform?"
  • For the "Select the platform you will use to integrate" field, select "Other platforms"
  • For the "Which product are you integrating" field, select "Transparent Checkout"


You must also:

  • Authorize the use of your personal data
  • Select the reCAPTCHA


Finally, click on the "Create Application" button. (number 8 in the image)


A message will be displayed to confirm that the application has been created.


1.5 In the "Credentials" section, click on "Activate credentials". (number 9 in the image)


1.6 To activate production credentials:

  • Select an industry (sector) that best applies to your business
  • Add your business website (optional)
  • Authorize the use of your personal data
  • Select the reCAPTCHA


Finally, click the blue "Enable production credentials" button. (number 10 in the image)


1.7 Mercado Pago should now have generated the following production credentials:

  • Public Key
  • Access Token


These are the credentials you need to enter in your systeme.io account to connect your Mercado Pago account as a payment method:


Note: you will have one set of credentials for each tool you use.


1.8 After generating your application and credentials, proceed to enter them into your systeme.io account and click the "Save" button. (number 11 in the image)


2) IPN configuration in Mercado Pago


Once the integration is done, you will receive a webhook URL that must be entered into your Mercado Pago account dashboard to allow systeme.io to process payment events.


2.1 Copy the webhook URL systeme.io provided when you integrated your Mercado Pago account. (number 12 in the image)


2.2 Log in to your Mercado Pago account and go to the developer panel (https://www.mercadopago.com.br/developers/en), then click on the application you created in the previous step. (number 13 in the image)


2.3 In the panel on the left-hand side of the screen, go to "Notifications" section and click on "Webhooks". (number 14 in the image)


2.4 Next, click the "Configure notifications" button. (number 15 in the image)


2.5 Select the "Production Mode" tab to enter the URL of the webhook generated by systeme.io in the "Production URL" field. (number 16 in the image)


In the "Recommended events for integrations with CheckoutTransparente" field, select the event "Payments" and in the "Other events" field, select the option "Plans and subscriptions". (number 17 in the image)


Finally, click the "Save settings" button. (number 18 in the image)

A pop-up window will be displayed to save the webhook notification settings; click on the "Save" button to confirm the action. (number 19 in the image)


To learn more about webhook configuration, we recommend you read this article.


Notes:

  • The fields "Email", "Last name", "First name", and "Tax number" are mandatory on your payment pages for a payment to be successfully processed by Mercado Pago.
  • Only one country can be selected to integrate a Mercado Pago account (Brazil, Colombia, Mexico, or Argentina).
  • Linking a Mercado Pago account will allow you to create prices in the currency of the country related to the Mercado Pago account (i.e. create prices and receive payments in Brazilian Reais, Colombian Pesos, Mexican Pesos, or Argentine Pesos, respectively).
  • Due to Mercado Pago limitations, it is not possible to process refunds through our system.


What happens when a Mercado Pago payment fails ?


  1. Cards: Three attempts will be made. The delay between each attempt cannot be modified. To find out the delay between each attempt, please contact Mercado Pago support.
  2. Boleto, Pix: There will be three attempts, each 7 days apart. The delay between each attempt cannot be modified.

Updated on: 27/06/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!