The official Mercado Pago plugin allows you to process payments for your online store, allowing users to finalize their purchase with their preferred payment method.
To install it,
you don't need to have technical knowledge: you can follow the
step by step of how to integrate it. from our developer website and start selling today.
Warning about v6.0.0: when updating, if you have made custom layout changes to your checkout, it is possible that some of those customizations become misconfigured. If you have a separate store environment just for testing, please update there first in order to visualize and test the changes.
What to do with the Mercado Pago Plugin?
- Activate Checkout Pro to offer logged-in payments with money in Mercado Pago account, saved cards and off means.
- Offer payments without the need of having a Mercado Pago account, through the Custom Checkout for cards and off means, such as cash, bank transfer and PIX (only in Brazil).
- Automatically convert the currency of your products: from Mexican pesos to U.S. dollars and vice versa.
- Sell in installments and offer the current promotions in Checkout Pro or apply your own discount coupon in Custom Checkout.
- Test your store before going into production with our Sandbox environment.
- Receive the money from your sales on the same day.
- IMPORTANT: At the moment the Mercado Envios service is deactivated.
- Mercado Pago customers can use already stored cards For your customers who use Mercado Pago to buy without having to fill in card details at the store's checkout.
Adapted to your business
Prepared for any type of store and category: electronics, clothing, kitchen, bazaar, whatever you want!
Just focus on selling and
we'll take care of the security: keep your store's payments protected with our fraud prevention and analysis tool.
Boost your sales with Mercado Pago payments for WooCommerce!
Sell more with the paid market
Leave your details to talk to our team of experts and understand how to sell more (for now only available for Brazil).
Minimum Technical Requirements
- WordPress version
- Compatibility and dependency of WooCommerce VXX
- LAMP Environment (Linux, Apache, MySQL, PHP)
- SSL Certificate
- Additional configuration: safe_mode off, memory_limit higher than 256MB
Install the module in two different ways: automatically, from the “Plugins” section of WordPress, or manually, downloading and copying the plugin files into your directory.
Automatic Installation by WordPress admin
- Access "Plugins" from the navigation side menu of your WordPress administrator.
- Once inside Plugins, click on 'Add New' and search for 'Mercado Pago payments for WooCommerce' in the WordPress Plugin list
- Click on "Install."
Done! It will be in the "Installed Plugins" section and from there you can activate it.
Manual Installation
- Download the [zip] (https://github.com/mercadopago/cart-woocommerce/archive/master.zip) now or from the o WordPress Module [Directory] (https://br.wordpress.org/plugins/woocommerce-mercadopago/)
- Unzip the folder and rename it to ”woocommerce-mercadopago”
- Copy the "woocommerce-mercadopago" file into your WordPress directory, inside the "Plugins" folder.
Done!
Installing this plugin does not affect the speed of your store!
If you installed it correctly, you will see it in your list of "Installed Plugins" on the WordPress work area. Please enable it and proceed to your Mercado Pago account integration and setup.
Mercado Pago Integration
- Create a Mercado Pago seller account if you don't have one yet. It's free and takes only seconds!
- Get your credentials, they are the keys that uniquely identify you within the platform.
- Set checkout payment preferences and make other advanced settings to change default options.
- Approve your account to go to Production and receive real payments.
Configuration
Set up both the plugin and the checkouts you want to activate on your payment avenue. Follow these five steps instructions and get everything ready to receive payments:
- Add your credentials to test the store and charge with your Mercado Pago account according to the country where you are registered.
- Approve your account in order to charge.
- Fill in the basic information of your business in the plugin configuration.
- Set up payment preferences for your customers.
- Access advanced plugin and checkout settings only when you want to change the default settings.
Check out our
official documentation for more information on the specific fields to configure.
v8.9.1 (03/08/2026)
Security
- Restrict Pix payment-status polling to the order owner by validating the order key alongside the nonce, preventing unauthenticated access to other buyers' payment status
- Restrict the admin log-download endpoint to known Mercado Pago log files and require a valid nonce, closing path-traversal and CSRF risks
Added
- Block payment submission in Custom Checkout when the card number is invalid (unrecognized BIN, incomplete, or empty), and show a specific error message instead of a generic one
Fixed
- Fix card checkout (Custom) running a redundant server-side validation before tokenization that could incorrectly block payments on multi-step or customized stores
- Fix the card form keeping stale data (brand, installments) and not showing an error for an unrecognized BIN; also fix the invalid-card indicator disappearing when the buyer edits the number without changing the BIN
- Fix card tokenization starting in Blocks checkout when no installment is selected
- Fix the document field label and the cardholder name helper text not updating correctly on validation errors at the card checkout
- Fix the Custom Checkout card form staying stuck on the loading spinner on mobile when the payment method selection trigger does not fire
- Fix a fatal error at checkout on stores using the Divi theme 5.9.0 on PHP 8.x
- Fix a 403 error preventing Shop Manager users (and any role with the manage_woocommerce capability) from accessing the Mercado Pago settings page
See changelog for all versions.