mercadopago / adb-payment
mercadopago/adb-payment
MercadoPago - Payment for Adobe Commerce
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
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_categoriesendpoint with a static hardcoded array, removing dependency on the deprecatedcheckout-off-api-v1application
[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
| 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.
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.
| 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.
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
Integration tests
| 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.
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.