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.8.0 (22/06/2026)
Added
- Add fast payment v2.1 experience: saved cards and Account Money displayed in two grouped blocks, country-specific iconography, buyer email header, and improved accessibility
- Add dynamic fast payment bundle selection via CDN config file, enabling A/B testing, split control, and kill switch without plugin deploy
- Add server-side checkout validation before fast payment tokenization, catching form errors independently of theme or DOM structure
Changed
- Replace fixed polling with event-driven Super Token init and fallback, adding
super_token_init_source metric
- Dispatch
mp_checkout_opened and mp_amount_changed Melidata events on checkout load and amount updates, with mp_checkout_amount_tracking_dropped metric fallback
- Emit
mp_custom_checkout_mobile_update_error metric when a mobile card form re-init fails, replacing the previously silent error swallow in the iOS observer
Fixed
- Fix missing script dependencies on the Blocks checkout that could prevent discounts, fees and coupons from being applied in stores using asset optimisation plugins
- Fix fast payment error metric to report structured SDK error code instead of raw error message
- Fix permanent loading spinner in Custom Checkout on iOS devices when using multi-step checkout plugins (e.g. Checkout for WooCommerce): the card form now initialises via a fallback event that is not cancelled when the iOS tab loses focus
- Fix invalid fiscal document (CPF) bypassing front-end validation and reaching the payment API in custom checkout (Classic and Blocks)
- Fixed Ticket Gateway incorrectly displaying "Linha de Crédito" (consumer_credits) alongside offline payment methods such as Boleto
- Fix copy errors and grammatical inconsistencies in admin panel translations across gateway settings, including gender agreement for the currency conversion status text (English, Spanish, and Portuguese)
- Fix payment sync cron returning HTTP 405 when order has no associated payment_id
- Fix _mp_flow_id not being registered in sessionStorage on Safari/iOS (including Blocks checkout), now renewed on each page load
- Fix oversized card network logos in the Super Token fast payment, now contained within the thumbnail frame on iOS
- Fix card holder name placeholder color in Custom Checkout to match the other card fields
See changelog for all versions.