Loading
In this article, you will learn how to integrate your Mercado Pago account with systeme.io.
You will need:
- A systeme.io account
- A Mercado Pago account (click here to create a Mercado Pago account)
To connect your systeme.io account to your Mercado Pago account, click on your profile picture and then Settings (1). Next, in the menu on the left side of your page, click Payment gateways (2).
In the payment gateways section, click Connect (3) for the Mercado Pago option.
In the popup that appears, you will be asked to fill in the API public key, Access token, and Country fields:
To generate your production credentials, log into your account and follow these steps:
1. How to obtain and activate your Mercado Pago credentials
You must create an application in Mercado Pago to obtain your credentials and then activate them for production. Follow these steps:
1.1 Generate your Mercado Pago credentials
Log in to the Mercado Pago dashboard, click on your name (1) in the upper-right corner, go to the Business tab (Negocio) (2), and select Your integrations (3).
Click + Create application (4).
Enter your application's name in the box (5) and click Continue (6).
Under the Online payments option, select Through a platform in the “How did you set up your store?” section.
If you prefer, you can enter the link to your payment page in the store's URL field. Finally, click Continue (7).
In the Other platform field, enter: systeme.io (8) and click Continue.
Next, review the information you entered, check the box to authorize the use of your personal information, and complete the reCAPTCHA (9).
Finally, click Confirm (10) to create your application.
1.2 Activate your Mercado Pago credentials
You will then be directed to your app dashboard. From the drop-down menu, select the app you just created (11); if this is your first app, it will already be selected by default. Then click Activate credentials (12).
Select the industry (13) your business belongs to and, if you have one, enter your website's URL.
Next, accept the terms by checking the authorization box, complete the reCAPTCHA (14), and click Activate production credentials (15).
All done! Your Mercado Pago app is now active.
Locate your Public key and click the Copy icon.
Locate your Access token, click the eye icon to reveal the text, and then click Copy.
Save these keys temporarily so you can enter them in the next step in your systeme.io account.
Important: Your Access Token and Client Secret are confidential credentials. Never share them publicly.
Note: You will have a set of credentials for each app you use.
1.3. Link your credentials in systeme.io
Go back to your systeme.io account, paste your public API key and the access token, select your country, and click Save.
When you save, systeme.io will connect your Mercado Pago account.
2. IPN setup in Mercado Pago
Once your credentials are saved, systeme.io automatically generates a webhook URL. In order for systeme.io to receive real-time payment notifications, you must register that URL in your Mercado Pago developer dashboard.
Click the copy button (1) to get the webhook URL you’ll use in the next step.
Log in to your Mercado Pago account and access the developer dashboard via this link: https://www.mercadopago.com.co/developers/es.
In the upper-right corner, click the Integrations menu.
Note: The link to the developer dashboard varies by country. Be sure to access the domain that corresponds to your account by changing the link's extension (for example: .com.co for Colombia, .com.mx for Mexico, .com.ar for Argentina, etc.).
In the Your apps list, find the app you just created and click on its name (2).
Go to the menu on the left, scroll down to the Notifications section, and select the Webhooks option (3).
In the Webhooks section, click the Configure notifications (4).
Go to the Production mode tab (5) and complete the following settings:
- Production URL (6): Paste the webhook URL you copied earlier from systeme.io.
- Recommended events (7): Check the “Payments (legacy)” box.
- Other events (8): Check the “Plans and subscriptions” box.
To finish, click Save Settings (9).
In the pop-up window, click Save (10) to confirm the action.
To learn more about webhook configuration, we recommend you read this article.
Notes:
- For a payment to be successfully processed by Mercado Pago, the payment pages must include the following fields: email address, first name, last name, country, and VAT number.
- You can select only one country to link a Mercado Pago account (Brazil, Colombia, Mexico, Chile, or Argentina).
- Linking a Mercado Pago account allows you to set prices in that account's local currency (e.g., Brazilian reais, Colombian pesos, etc.).
- Due to limitations on Mercado Pago, it is not possible to process refunds from systeme.io.
- Additional resource: For more details on how the webhook works and how to configure it, you can refer to the official documentation from Mercado Pago.
3. Supported currencies and restrictions
Before receiving payments, ensure your funnels and products are set up using one of the supported currencies for this gateway.
Mercado Pago supports payments via credit cards, as well as local payment methods like PIX and Boleto for users in Brazil.
- Supported buyers: Argentina, Brazil, Chile, Colombia, and Mexico.
- Recurring payments (subscriptions): Yes.
- Supported currencies: ARS, BRL, CLP, COP, and MXN.
- Merchant restrictions: Your Mercado Pago merchant account must be registered in the same country as the currency you are charging in your funnels (e.g., you must use an Argentine account to charge in ARS or a Brazilian account to charge in BRL). Note that you can only select one country to integrate per systeme.io account.
What happens when a Mercado Pago payment fails?
- 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.
- Boleto, Pix: There will be three attempts, spaced 7 days apart.