mercadopago / adb-payment

mercadopago/adb-payment

MercadoPago - Payment for Adobe Commerce

  • Mercado Pago
magento2-module Compatibility: 2.4.7-2.4.8 Code Quality: Fail Tests: Fail Security: Pass OSL-3.0, AFL-3.0
logo.svg

Mercado Pago para Adobe Commerce

Oferece pagamentos com cartões de crédito, débito e também meios offline - além de vantagens exclusivas para quem paga logado na conta Mercado Pago, como créditos, descontos e outras condições especiais.

Instalação e Configuração

Visite nossa Wiki e veja como configurar e instalar nosso módulo:

License

Open Source License

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[1.15.4] - 2026-05-12

Added

  • Added user-friendly error message for Credits MLC minimum amount validation

Changed

  • Migrated payment methods endpoint from legacy to Core API

Fixed

  • Fixed total calculation in Checkout Pro when coupon is applied

[1.15.3] - 2026-04-24

Changed

  • Replaced HTTP call to /item_categories endpoint with a static hardcoded array, removing dependency on the deprecated checkout-off-api-v1 application

[1.15.2] - 2026-03-31

Fixed

  • Fixed error handling and validation in 3DS challenge flow and modal initialization
  • Fixed error handling in vault payment flow with error metrics support
  • Fixed safer response handling in credit card and vault order placement
  • Updated error messages for payment processing issues in multiple languages

[1.15.1] - 2026-03-20

Changed

  • Forces the sending of the refund amount with Orders API

[1.15.0] - 2026-02-20

Added

  • System now automatically supports both Order API and legacy Payment API transactions, with intelligent detection based on ID patterns and compatibility with existing flows

Fixed

  • Fixed metrics reporting for unmapped statuses to avoid false positives
  • Fixed null pointer exception in notificationId extraction with proper validation
  • Fixed display of disabled payment methods at multi-address checkout

[1.14.0] - 2026-01-05

Added

  • Added Order API integration for PIX payments

Changed

  • Updated logo SVG with new design elements and color styling

[1.13.2] - 2025-12-03

Fixed

  • Fixed order total due when Chopro coupon is applied

[1.13.0] - 2025-11-19

Added

  • Added trackings to checkout buyer

[1.12.1] - 2025-10-30

Fixed

  • Fixed external reference for payments with 3DS validation

[1.12.0] - 2025-09-10

Changed

  • Change maximum pix expiration date

[1.11.0] - 2025-07-21

Added

  • Add option in the admin to change the order of address lines
  • Add end-to-end testing

Changed

  • Change the display of taxes for installment in Argentina

[1.10.1] - 2025-06-18

Fixed

  • Correction of discount calculation in CHOPRO processing
  • Fixed import image on README file

Changed

  • Add compatibility with PHP 8.4 in composer.json
  • Refactored methods to ensure compatibility with PHP 8.4
  • Updated SDK version to 3.3.2

[1.10.0] - 2025-05-19

Changed

  • Updated the Mercado Pago branding across all checkouts, admin panel, and success pages.
  • Updated plugin code to be compatible with the latest PHP SDK version.

Fixed

  • Resolved issue preventing the use of saved cards (Vault) with other payment methods in the Mercado Pago plugin.

[1.9.3] - 2025-04-10

Fixed

  • Adjustments to the Pix QR code sent by email
  • Adjustments to the address fields for Boleto
  • Adjustments to the total amount in payments with ChoPro

[1.9.2] - 2025-03-26

Changed

  • Adjustments on payments without postcode

[1.9.1] - 2025-02-06

Changed

  • Translation for user invalid email message on checkout
  • Adjustments on CSS for Yape

Fixed

  • Adjustment on Vault for pending payment
  • Fixed binary mode options

[1.9.0] - 2024-12-18

Changed

  • Changed magento order cancellation flow in MP rejected status
  • Updated support admin link

Fixed

  • Off payment methods disabled in MLC
  • Adjustment on installments info in vault
  • Translate customer invalid email message
  • Adjustment on cancel orders cron

Added

  • Added new Yape payment method for Peru

[1.8.5] - 2024-10-30

Changed

  • Adjustments on maximum order amount when payment has financial cost
  • Adjustments on partial refund
  • Update binary mode default value
  • Fixed financial cost amount exhibition on order view and success page with cards payment
  • Improved logs on cancel orders with expirated preferences cron
  • Updated text for congrats page on MLB "Lotérica" payment

[1.8.4] - 2024-09-23

Changed

  • Rebranding of Mercado Credits
  • Ajustments in Checkout Pro's layout

Added

  • Added online refund option for payment with Cho Pro

[1.8.3] - 2024-09-05

Changed

  • Adjusting the rule used to obtain expired orders and cancel them via Cron
  • Separate device fingerprint from SDK + add nonce to load script

Added

  • Added logs to errors with MPClient or SDK requests

[1.8.2] - 2024-05-27

Fixed

  • Fixed intermittent error when saving payment details

[1.8.1] - 2024-04-25

Fixed

  • Fix added existing value validation for the financial_institution field
  • Update anotations references
  • Add php version 8.3.0 in compose.json

[1.8.0] - 2024-04-09

Fixed

  • Adjust 3ds modal sizing to be compliant with documentation
  • Fix area code not set on setup:upgrade
  • Fix/quote mp payment int in 3DS flow
  • Fix sending payer.id in any payment flow

[1.7.0] - 2024-03-27

Added

  • Added trackings in selected paths for melidata

Fixed

  • Validation for expired credentials
  • Correction for area code error in old platform versions

[1.6.3] - 2024-03-07

Changed

  • Adjusting Iframe creation with 3Ds.
  • PSJ/PCJ adequacy in online payment.
  • Adding the checkout_type of type two_cards to the metadata

Fixed

  • Adding a translation fix in FetchPaymentHandler

[1.6.2] - 2024-01-29

Changed

  • Get document types from payment methods to PSE.

Fixed

  • Translate fix.

[1.6.1] - 2024-01-15

Fixed

  • Regular expression adjustment to accept alphanumeric in RUT type document.

[1.6.0] - 2024-01-03

Added

  • Added plugin version + site id information on admin

Fix

  • Refactor of refund flow to improve performance and fix minor bugs
  • Translate fix for checkout credits and finance cost
  • Fix store scope information when saving site id
  • Fix date expiration information on front

[1.5.0] - 2023-10-09

Added

  • Feature 3DS
  • State Machine
  • Remedies
  • PSE Avanza

Fixed

  • Fixed notification update CRON
  • Fixed PIX PDF

[1.4.2] - 2023-09-11

Fixed

  • Adjust installments and finance cost calculation when applying the coupon
  • Fixed two card flow

[1.4.1] - 2023-07-18

Added

  • Added support for PHP 8.2 in composer

Changed

  • Changed wiki link in README.md

[1.4.0] - 2023-07-07

Added

  • SDK implementation
  • Inclusion of the Mercado Credits payment methods
  • Compatibility with Magento version 2.4.6
  • Inclusion of PF data

Fixed

  • Changed expiration date fields Checkout Pro
  • Fixed decimal places on front end of two cards
  • Remove policy prefetch-src
  • Fixed credit card flags
  • Remove sponsor id from test user flow
  • Fixed on credentials links
  • Fixed default success page

[1.3.0] - 2023-06-13

Fixed

  • Fixed manual capture flow
  • Fixed refund flow
  • Fixed the refund process and update information in notifications
  • Fixed validation of color save in Checkout Pro options in admin
  • Fix installments flickr

[1.2.1] - 2023-05-26

Update version management

[1.2.0] - 2023-05-25

Stable version

[1.1.0] - 2023-05-22

Added

  • Improve refund flow

[1.0.0] - 2023-05-08

First Release

Versions
Version Stability QA Status Compatibility Released
1.15.4 stable Fail Magento 2.4.7-2.4.8 Details 2026-05-15 12:46:05
1.15.3 stable Not tested Not yet tested Details 2026-04-28 14:47:08
1.15.2 stable Not tested Not yet tested Details 2026-04-01 13:16:20
1.15.1 stable Not tested Not yet tested Details 2026-03-20 14:18:32
1.15.0 stable Not tested Not yet tested Details 2026-02-26 12:32:43
1.14.0 stable Not tested Not yet tested Details 2026-01-12 14:51:59
1.13.2 stable Not tested Not yet tested Details 2025-12-04 12:14:40
1.13.1 stable Not tested Not yet tested Details 2025-12-03 20:35:22
1.13.0 stable Not tested Not yet tested Details 2025-11-27 20:33:01
1.12.1 stable Not tested Not yet tested Details 2025-10-30 14:27:41
1.12.0 stable Not tested Not yet tested Details 2025-09-25 13:48:11
1.11.0 stable Not tested Not yet tested Details 2025-08-14 12:06:41
1.10.1 stable Not tested Not yet tested Details 2025-07-21 17:26:09
1.10.0 stable Not tested Not yet tested Details 2025-05-19 23:39:37
1.9.3 stable Not tested Not yet tested Details 2025-04-10 21:00:59
1.9.2 stable Not tested Not yet tested Details 2025-03-26 20:10:22
1.9.1 stable Not tested Not yet tested Details 2025-02-10 17:26:36
1.9.0 stable Not tested Not yet tested Details 2024-12-18 19:29:40
1.8.5 stable Not tested Not yet tested Details 2024-10-30 20:01:05
1.8.4 stable Not tested Not yet tested Details 2024-09-23 20:53:14
1.8.3 stable Not tested Not yet tested Details 2024-09-05 20:42:43
1.8.2 stable Not tested Not yet tested Details 2024-05-27 19:35:09
1.8.1 stable Not tested Not yet tested Details 2024-04-25 19:27:59
1.8.0 stable Not tested Not yet tested Details 2024-04-09 20:36:34
1.7.0 stable Not tested Not yet tested Details 2024-03-27 20:59:22
1.6.3 stable Not tested Not yet tested Details 2024-03-07 20:02:18
1.6.2 stable Not tested Not yet tested Details 2024-01-29 21:31:54
1.6.1 stable Not tested Not yet tested Details 2024-01-19 19:02:08
1.6.0 stable Not tested Not yet tested Details 2024-01-03 19:47:15
1.5.0 stable Not tested Not yet tested Details 2023-10-09 21:37:04
1.4.2 stable Not tested Not yet tested Details 2023-09-11 21:49:39
1.4.1 stable Not tested Not yet tested Details 2023-07-19 13:02:53
1.4.0 stable Not tested Not yet tested Details 2023-07-07 19:32:08
1.3.0 stable Not tested Not yet tested Details 2023-06-13 19:43:11
1.2.1 stable Not tested Not yet tested Details 2023-05-29 19:35:59
1.2.0 stable Not tested Not yet tested Details 2023-05-25 19:44:08
1.0.0 stable Not tested Not yet tested Details 2023-05-08 12:52:02

Requires 5

Package Constraint
php ~7.3.0||~7.4.0||~8.1.0||~8.2.0||~8.3.0||~8.4.0
ext-json *
ext-gd *
ext-zip *
mp-plugins/php-sdk ^3.3.2

Requires-dev 4

Package Constraint
magento/magento-coding-standard *
phpmd/phpmd ^2.13
phpstan/extension-installer ^1.2
phpstan/phpstan ^1.6.8

Compatibility

Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.

Compatibility matrix (Magento × PHP)
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 Pass Pass
2.4.8 Pass Pass
2.4.9 Fail di error not tested

Code Quality

Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge — a phpcs finding can't make a module incompatible.

Static analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

Static analysis results
Tool Status Findings Summary
PHPCS Fail 3433 6 errors, 3427 warnings (ruleset: Magento2) — 3051 auto-fixable with phpcbf
PHPMD Warning 142 142 rule violations (MissingImport:70, TooManyPublicMethods:18, UnusedFormalParameter:11, UnusedLocalVariable:11, UndefinedVariable:11)
Cpd Pass 0
Composer validate Info 1 valid; 1 advisory note (composer validate --strict)

PHPStan

Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases. Cell → details modal.

PHPStan results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 507 506
2.4.8 506 506
2.4.9 509 N/A

Tests

Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.

Unit tests

Unit tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 1 1
2.4.8 37 Error
2.4.9 Error Error

Integration tests

Integration tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Security

Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.

Security results
Tool Status Findings Summary
Composer audit Pass 0
Malware scan Pass 0
License
OSL-3.0, AFL-3.0
Authors
  • Mercado Pago
Make it pay

Turn an existing module into recurring revenue.

If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.