How to Configure MercadoPago in WooCommerce for Latin America

Introduction

MercadoPago is the most widely used payment gateway in Latin America. If your store sells in Argentina, Mexico, Brazil, Chile, Colombia, Peru, Uruguay or other countries in the region, offering MercadoPago is almost essential: millions of customers already have an account and trust this payment method.

In this article you’ll see how to install and configure MercadoPago in your WooCommerce store, from creating the account to your first test sale.

Why offer MercadoPago

MercadoPago has several advantages for stores in Latin America:

• It’s the best-known payment brand in the region. The customer trusts it.
• It allows payment by card, transfer and funds in the MercadoPago account.
• It offers installments, a widely used payment method in Latin America.
• It includes Checkout Pro, where the customer chooses the method within MercadoPago.

What you need before you start

Before configuring MercadoPago, make sure you have:

1. A working WooCommerce store.
2. An active SSL certificate. MercadoPago requires HTTPS.
3. A MercadoPago seller account. A regular buyer account works, but needs to be activated as a seller.

[Imagen sugerida: screenshot of the MercadoPago sellers sign-up page]

The SSL certificate is mandatory for any payment gateway. At miHosting all plans include free SSL with Let’s Encrypt.

Step 1: Create a MercadoPago seller account

1. Go to the MercadoPago website and register with your email.
2. Verify your identity with an ID document and phone number.
3. Complete your business details: name, category and activity.
4. Link your bank account to receive payments.
5. Activate the account as a seller from Your business → Settings.

Once activated, access the API credentials.

Step 2: Get your MercadoPago credentials

Credentials connect your store to your MercadoPago account.

1. Log in to the MercadoPago dashboard.
2. Go to Your business → Settings → Credentials.
3. You’ll see two types of credentials:
   • Test credentials (to simulate sales).
   • Production credentials (for real sales).

[Imagen sugerida: screenshot of the credentials section in the MercadoPago dashboard]

Each set includes:

• Public Key (public key).
• Access Token (private access key).

Always start with the test credentials. When everything works, replace them with production ones.

Step 3: Install the MercadoPago plugin in WooCommerce

1. Log in to the WordPress admin panel (yourdomain.com/wp-admin).
2. Go to Plugins → Add New.
3. Search for Mercado Pago payments for WooCommerce (official plugin).
4. Click Install Now and then Activate.

Always use the official MercadoPago plugin. Avoid unverified third-party plugins.

Step 4: Configure the MercadoPago plugin

1. Go to WooCommerce → Settings → Payments.
2. Find Mercado Pago in the payment methods list.
3. Click Manage or the title.
4. Paste your test credentials:
   • Test Public Key.
   • Test Access Token.
5. Enable test mode (sandbox) while configuring.

[Imagen sugerida: screenshot of the MercadoPago plugin configuration screen in WooCommerce]

Checkout types available

MercadoPago offers two main modes:

• Checkout Pro: the customer chooses the payment method within MercadoPago. It’s the simplest and recommended to start.
• Custom Checkout (Checkout API): the customer pays by card without leaving your site. Requires more advanced setup and certification.

6. Select the checkout type you prefer. To start, choose Checkout Pro.
7. Configure the options:
   • Excluded payment methods: you can limit which methods you accept.
   • Installments: shows installment payment if available in your country.
   • Redirect after payment: defines whether the customer returns to your site after paying.
8. Click Save changes.

Step 5: Test a purchase in sandbox mode

Before activating MercadoPago in production, run a test purchase:

1. Make sure test mode is active.

2. MercadoPago provides test cards depending on the country, for example for Argentina:

   Test Visa: 4509 9535 6623 3704
   Test Mastercard: 5031 7557 3453 0604

3. Enter your store as a customer.

4. Add a product to the cart and select MercadoPago at checkout.

5. Complete the payment with the test card.

6. Verify that:

   • The order appears under WooCommerce → Orders.
   • The payment appears as “approved” in the MercadoPago dashboard.

[Imagen sugerida: screenshot of the MercadoPago dashboard showing a test payment]

Step 6: Activate MercadoPago in production

When the test works, move to production:

1. Go back to WooCommerce → Settings → Payments → Mercado Pago.
2. Replace the test credentials with production credentials.
3. Disable test mode.
4. Save the changes.
5. Run a real purchase with a minimal amount to confirm.

MercadoPago settles payments in your MercadoPago account. From there you can transfer the balance to your bank account. The settlement time depends on your country.

Useful tips

• Offer installment payment if your country allows it. It increases the average order value.
• Combine MercadoPago with direct cards. In Latin America it’s worth having MercadoPago plus a direct card gateway.
• Review the commissions. Each payment method within MercadoPago may have a different commission.
• Keep the plugin updated. Official plugin updates fix bugs and improve security.
• Back up before updating. An update can affect the payment gateway.

Common problems

MercadoPago doesn’t appear at checkout

Check that the plugin is active and that the method is enabled under WooCommerce → Settings → Payments.

Payment fails with an SSL error

MercadoPago requires HTTPS. Verify that your SSL is installed and the site loads without mixed content.

”Invalid credentials” error appears

Make sure you use the correct credentials for each environment. Don’t mix test credentials with production ones.

The customer pays but the order isn’t registered in WooCommerce

This can happen if MercadoPago’s notification (IPN or webhook) doesn’t reach your store. Verify that your hosting isn’t blocking incoming MercadoPago connections.

Installments don’t appear at checkout

Check that your MercadoPago account has installment payment enabled and that your country supports it. Some installment methods require additional activation.

Frequently asked questions

Does MercadoPago charge a fee?

Yes. MercadoPago charges a commission on each transaction. The percentage varies by country and the chosen payment method. Check rates on your country’s MercadoPago website.

In which countries does MercadoPago work?

MercadoPago is available in most Latin American countries, such as Argentina, Brazil, Mexico, Chile, Colombia, Peru, Uruguay and others. Payment method availability may vary by country.

Can I issue refunds from WooCommerce?

It depends on the checkout type and configuration. In many cases you can refund from the MercadoPago dashboard. Always refund from the same channel to avoid inconsistencies.

Do I need a business account to use MercadoPago?

It’s not strictly necessary to start, but it’s highly recommended. For medium or high sales volumes, MercadoPago may ask you to validate your activity as a business.

Can I use MercadoPago alongside Stripe or PayPal?

Yes. In WooCommerce you can have multiple payment methods active at once. The customer will choose their preferred one at checkout.

Start selling in Latin America with MercadoPago

Configuring MercadoPago in WooCommerce opens the doors of the Latin American market, where it’s the best-known payment gateway. Follow the steps in order: create the account, get the credentials, install the official plugin, test in sandbox mode, and when everything works, activate production.

If you need help with SSL, PHP version, or any hosting setting, open a support ticket from your client panel. And if you don’t yet have hosting for your WooCommerce store, at miHosting you have optimized plans with free SSL, LiteSpeed cache and support from real technicians who speak your language.