WooCommerce MercadoPago


Mercado Pago leads the technological transformation of finance in Latin America and develops tools to take its collections to another level. Integrate a payment avenue in your website with our official WooCommerce plugin. With out checkout options you can offer the payment methods that everyone prefers, with the best possible financing: purchases in up to 24 installments, credit and debit cards, in-person payments and money in the Mercado Pago account.

Porque elegir Mercado Pago

We operate in Argentina, Brazil, Mexico, Peru, Chile, Uruguay and Colombia with businesses of all sizes. They choose us, from entrepreneurs who are just beginning to consolidated big brands in the market.

We process more than 6 million transactions with Visa and Mastercard cards every year and we do so protecting your money, always. Accept payments with the most used cards and offer installments with the best possible financing. With our ready-to-use solutions, going further is in your hands.

You can trust us as you trust a strategic partner. Use the money from your sales once it is available in your Mercado Pago account, with our prepaid card, or withdraw it to your bank at no additional cost. View our fees and have the money from your sales instantly.

Main Functionalities of Mercado Pago

  • Processing via IPN / Webhook online and in real time;
  • Altas tasas de aprobación con un robusto análisis de fraude;
  • Potential clients: more than 120 million users in Latin America trust us;
  • Sandbox test environment;
  • Log and debug options;
  • Certificación PCI nivel 1;
  • Accept the payment methods everyone prefers;
  • Installment payments;
  • Payments in advance from 2 to 14 business days, according to our Terms and Conditions;
  • One-click payments with the basic and personalized Mercado Pago checkouts;
  • Payments via tickets (Boletos);
  • Suscripciones;
  • Programa de protección al vendedor.


  • WooCommerce 3.0 o mayor.


  • Pay with the payment method you prefer
  • Pay with the payment method you prefer
  • Pay with debit and credit cards
  • Pay with debit and credit cards
  • Pay with money and cash
  • Pay with ticket and Loterica


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
1. Access «Plugins» from the navigation side menu of your WordPress administrator.
2. Once inside Plugins, click on ‘Add New’ and search for ‘Mercado Pago WooCommerce’ in the WordPress Plugin list
3. Click on «Install.»

Done! It will be in the «Installed Plugins» section and from there you can activate it.

Manual Installation
1. Download the zip now or from the o WordPress Module Directory
2. Unzip the folder and rename it to ”woocommerce-mercadopago”
3. Copy the «woocommerce-mercadopago» file into your WordPress directory, inside the «Plugins» folder.


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

  1. Create a Mercado Pago seller account if you don’t have one yet. It’s free and takes only seconds!
  2. Get your credentials, they are the keys that uniquely identify you within the platform.
  3. Set checkout payment preferences and make other advanced settings to change default options.
  4. Approve your account to go to Production and receive real payments.


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:

  1. Add your credentials to test the store and charge with your Mercado Pago account according to the country where you are registered.
  2. Approve your account in order to charge.
  3. Fill in the basic information of your business in the plugin configuration.
  4. Set up payment preferences for your customers.
  5. 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.

Preguntas frecuentes

How do we protect the sellers

We take care of the money with maximum security
We help you in case of problems
We protect your sales against chargebacks

Where can I find the documentation?

Check out our official documentation for installing and configuring the Mercado Pago plugin in your store.

Where and how can I contribute?

Suggest documentation improvement on our website for integrators and developers,
Subscribe to the development log by RSS,
Review the code and visit the SVN repository,
Help us translate WordPress: Translate the plugin for your country.


14 de noviembre de 2019
usando con la ultima version de wordpress es una lastima. Fatal error: Class 'WC_Payment_Gateway' not found in /home/guiacar/public_html/wp-content/plugins/woocommerce-mercadopago/includes/module/preference/WC_WooMercadoPago_PreferenceAbstract.php on line 10 Ha habido un error crítico en tu sitio. Revisá el correo electrónico del administrador para instrucciones. Aprende más sobre la depuración en WordPress.
14 de noviembre de 2019
¿No piensan solucionar el tema de conversion de moneda? Ya lleva semanas o meses. Es vergonzoso que si uno vende algo en 10 dolares, Mercado Pago lo "venda" por 10 pesos argentinos. Obviamente la unica solucion es desactivar la forma de pago Mediante Mercado Pago y dejar sólo otros medios serios.
9 de noviembre de 2019
PLEASE BE AWARE This pluggin is its current version (4.0.8)is not conversing the currency you set in woocomerce. So if your store has it prices in dollars, they will pay you in pesos!
4 de noviembre de 2019
Está a quase 1 mês com esse erro: Seu pagamento foi rejeitado. Você pode tentar novamente. Seu pagamento foi rejeitado. Escolha outro método de pagamento. Recomenda-se dinheiro. log: 2019-11-04T22:54:01+00:00 INFO IPN - Notification checked, order: 1373 checked and updated to rejected (wc-failed). Reason: Your payment was rejected. Please use another credit card aguardo ansioso a solução.
21 de octubre de 2019
quando o pagamento com o cartão de crédito tem falha, aparece o seguinte botão: "Clique para tentar novamente" após clicar nesse botão, aparece uma nova página pra colocar os dados do cartão. porém essa página é diferente da página padrão para cartão de crédito, e essa página não funciona, eu coloco o número do cartão de crédito e não atualiza as parcelas. apenas aparece vários erros.
16 de octubre de 2019
En la última versión ya no tiene la opción de conversión de moneda. Mi sitio está en dólares y en el momento de la compra se hacía la conversión a la cotización del día. Ahora no solo no lo hace, sino que además me han comprando productos en dólares y Mercado Pago se los ha cobrado en Pesos uruguayos pero sin convertir... o sea he perdido mucho dinero. Por ejemplo USD 190 los ha cobrado como 190 pesos... cuando deberían ser casi 7000 pesos. Lo mas triste es que el soporte es inexistente, no hay donde consultar, ni reportar. Estoy deseando el día que aparezcan otras opciones de pasarela de pagos.
Leer todas las 94 reseñas

Colaboradores y desarrolladores

«WooCommerce MercadoPago» es un software de código abierto. Las siguientes personas han colaborado con este plugin.


«WooCommerce MercadoPago» ha sido traducido a 8 idiomas locales. Gracias a los traductores por sus contribuciones.

Traduce «WooCommerce MercadoPago» a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.

Registro de cambios

v4.0.8 (13/09/2019)

  • Bug fixes
    • Fixed mercado envios
    • Fexed show fee in checkout
    • Fixed translation file
    • Fixed constant file

v4.0.7 (12/09/2019)

  • Bug fixes
    • Fixed layout incompatibility
    • Fixed process to validate card at custom checkout
    • Fixed payment due at ticket
    • Fixed spanish translation

v4.0.6 (09/09/2019)

  • Bug fixes
    • Problem with all translations fixed

v4.0.5 (04/09/2019)

  • Bug fixes
    • Problem with translations in Portuguese fixed

v4.0.4 (03/09/2019)

  • Bug fixes
    • Conflict between php5.6 and php7 solved

v4.0.3 (03/09/2019)

  • Bug fixes
    • Fixed basic checkout layout when theme uses bootstrap
    • Fixed all Custom checkout layout when theme uses bootstrap
    • Fixed input blank in basic checkout config

v4.0.2 (02/09/2019)

  • Feature All
    • Performance improvement
    • UX and UI improvements
    • Code refactoring
    • Design standards: SOLID, Abstract Factory and Singleton
    • SDK Refactor: Avoid repeated external requests.
    • New Credential Validation Logic
    • Plugin Content Review
    • Adjustment in translations
    • Unification of general plugin settings with payment method setup, simplifying setup steps
    • Logs to assist support and integration
  • Bug fixes
    • Added product_id
    • Fixed payment account_money
    • Fixed translation Spanish Neutral and Argentino

v4.0.2-Beta (13/08/2019)

  • Bug fixes
    • Fixed bug when update plugin from version 3.0.17
    • Fixed bug thats change production mode of basic, custom and ticket checkout when update version.
    • Added statement_descriptor in basic checkout
    • Fixed title space checkout custom

v4.0.1-Beta (09/08/2019)

  • Bug fixes
    • Fixed notification IPN and Webhook
    • Fixed payment processing
    • Fixed Argentina ticket checkout
    • Fixed rule for custom checkout to generate token
    • Fixed layout checkouts

v4.0.0-Beta (02/08/2019)

  • Feature All
    • Performance improvement
    • UX and UI improvements
    • Code refactoring
    • Design standards: SOLID, Abstract Factory and Singleton
    • SDK Refactor: Avoid repeated external requests.
    • New Credential Validation Logic
    • Plugin Content Review
    • Adjustment in translations
    • Unification of general plugin settings with payment method setup, simplifying setup steps
    • Logs to assist support and integration

v3.1.1 (03/05/2019)

  • Feature All
    • Added alert message on all ADMIN pages for setting access_token and public_key credentials, as client_id and client_secret credentials will no longer be used. Basic Checkout will continue to work by setting these new credentials.
    • We have added minor translation enhancements.
    • We add error message when any API error occurs while validating credentials.

v3.1.0 (17/04/2019)

  • Feature All
    • We are no longer using client_id and client_secret credentials. This will affect the functioning of the basic checkout. You will need to configure access_token and public_key, in the plugin settings have. You can access the link to get the credentials inside of configurations of plugin.
  • Improvements
    • Performance enhancements have been made, removing unnecessary requests and adding scope limitation for some functionality.

v3.0.17 (07/08/2018)

  • Feature All
    • Adding X Product ID
    • Migration from v0 (collections) to v1

v3.0.16 (20/07/2018)

  • Feature MCO
    • Adding PSE gateway for Colombia
  • Improvements
    • Some code improvements

v3.0.15 (15/03/2018)

  • Mejoras
    • Permitindo customización por parte de los comerciantes, en los campos de ticket (créditos para https://github.com/fernandoacosta)
    • Se corrigió un erro en el procesamiento de Mercado Envios.

v3.0.14 (13/03/2018)

  • Mejoras
    • Los descuentos y tarifas por medio de pago aceptan dos números después del punto decimal;
    • Los compradores pueden escoger no guardar las tarjetas de credito;
    • Es posible ahgora customizar el banner de checkout.

v3.0.13 (01/03/2018)

  • Bug fixes
    • Se corrigió un erro en la pantalla modal de Checkout Básico.

v3.0.12 (28/02/2018)

  • Mejoras
    • Añadido fecha máxima para pago con ticket;
    • Añadida opción para tarifa extra por medio de pago;
    • Mayor estabilidad.

v3.0.11 (19/02/2018)

  • Mejoras
    • Mensajes de retroalimentación mejorados cuando falla una orden;
    • Mejora de la validación de credenciales para el pago personalizado con tarjetas de crédito.

v3.0.10 (29/01/2018)

  • Improvements
    • Mejorado el layout en los formularios de Tarjeta de Credito y Tickets;
    • Mejorado el soporto para temas de WordPress.

v3.0.9 (16/01/2018)

  • Bug fixes
    • Se corrigió un bug en la URL de imagene de producto;
    • Se corrigió un erro de contagen en sdk (creditos a xchwarze).

v3.0.8 (05/01/2018)

  • Improvements
    • Soporto mejorado para versiones antiguas de PHP;
    • IPN/Webhook ahgora es customizable.

v3.0.7 (21/12/2017)

  • Improvements
    • Verificación de versiones antiguas de PHP para prevenir inconsistencias.

v3.0.6 (13/12/2017)

  • Improvements
    • Validación adicional para las dimensiones de los productos;
    • Se agregó un código de país para analytics.
  • Bug fixes
    • Se corrigió un problema relacionado con el título del método de pago, que estaba en blanco al configurar el módulo por primera vez.

v3.0.5 (22/11/2017)

  • Bug fixes
    • Solucionado un bug en la URL de la fuente de Javascript para la opción modal.

v3.0.4 (13/11/2017)

  • Mejoras
    • Mejoras en webhook de tickets impresos a uno menos genérico.
  • Bug fixes
    • Solucionado un bug relacionado a los estados de los pagos vía ticket.

v3.0.3 (25/10/2017)

  • Funcionalidades
    • Desarrollo para Uruguay de checkout personalizado y Tickets.
  • Bug fixes
    • No muestra el formulario de tickets cuando no es necesario.

v3.0.2 (19/10/2017)

  • Bug fixes
    • Solucionado la ausencia del campo [zip_code] en tickets registrados para Brasil.

v3.0.1 (04/10/2017)

  • Bug fixes
    • Arreglamos un problema de Javascript que ocurría cuando los pagos eran reintentados en checkout personalizado y tickets;
    • Resuelto el tamaño del icono de MercadoPago en el formulario del checkout.
  • Mejoras
    • Permite ausencia de SSL si el modo debut se encuentra activado;
    • Optimizaciones en el layout del formulario en el checkout personalizado y tickets;
    • Validación de la consistencia de la moneda antes de intentar la conversión;
    • Referencias a la nueva documentación.

v3.0.0 (25/09/2017)

  • Funcionalidades
    • Todas las funcionalidades presentes en Woo-Mercado-Pago-Module 2.x;
    • Personalización del mateo de los estados entre la orden y los pagos.
  • Mejoras
    • Adición del documento CNPJ para tickets de Brasil;
    • Optimización en pedidos HTTP y algoritmos;
    • Quite de ciertas redundancias;
    • Separación de HTML y Javascript;
    • Mejoras en el checklist de los estados del sistema;
    • Menúes más intuitivos y navegaciones de admin.

2.0.9 (2017/03/21)

  • Mejoras
    • Sponsor_id incluido para indicar la plataforma a MercadoPago.

2.0.8 (2016/10/24)

  • Features
    • Abrir el modal de MercadoPago cuando carga la página;
  • Bug fixes
    • Cambio de la notification_url para evitar problemas con la notificación de pagos.

2.0.7 (2016/10/21)

  • Bug fixes
    • Mejora en modal MercadoPago z-index para evitar problemas con cualquier tema.

2.0.6 (2016/07/29)

  • Bug fixes
    • Solucionado fatal error en manejo de IPN handler cuando el los está deshabilitado.

2.0.5 (2016/07/04)

  • Mejoras
    • Mejora en el manejo de las notificaciones de pago;
    • Agregado soporte completo para las configuraciones de Chile.

2.0.4 (2016/06/22)

  • Bug fixes
    • Parámetro solucionado back_urls.

2.0.3 (2016/06/21)

  • Mejoras
    • Mayor soporte para notification_url.

2.0.2 (2016/06/21)

  • Mejoras
    • Arreglo de soporte para WooCommerce 2.6.

2.0.1 (2015/03/12)

  • Mejorass
    • Remover la verificación SSL para los nuevos estándares de Mercadopago.

2.0.0 (2014/08/16)

  • Funcionalidades
    • Añadido soporte para la moneda COP, recordando que depende de la configuración de su Mercado Pago para que esto funcione;
    • Agregado soporte para traducciones de Transifex.
  • Bug fixes
    • Corregido el nombre del archivo principal;
    • Corregida los strings de la traducción;
    • Corregido en un link de cancelamiento.