# mercadopago/adb-payment > MercadoPago - Payment for Adobe Commerce `composer require mercadopago/adb-payment` Canonical URL: https://packagento.com/mercadopago/adb-payment ## At a glance - **Vendor**: mercadopago (https://packagento.com/mercadopago.md) - **Latest version**: 1.15.5 — released 2026-07-06 - **Pricing**: Free - **Package type**: Magento 2 module - **Status**: active, accepting new buyers ## Installation Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them. 1. **Sign in or create an account** at https://packagento.com/customer/account/. 2. **Add the package to your account.** Open https://packagento.com/mercadopago/adb-payment and complete the free checkout. A licence is minted automatically. 3. **Create or pick a project, then activate the licence on it.** - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/. - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project. 4. **Add the project credentials to your Magento codebase.** Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`: ```json { "http-basic": { "packagento.com": { "username": "ppk_live_...", "password": "psk_live_..." } } } ``` Add the Packagento Composer repository to `composer.json`: ```json { "repositories": [ { "type": "composer", "url": "https://packagento.com" } ] } ``` 5. **Install and apply.** ```bash composer require mercadopago/adb-payment:* bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flush ``` ## What it does MercadoPago - Payment for Adobe Commerce ## README ## 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: - 🇦🇷 [Argentina](https://www.mercadopago.com.ar/developers/es/docs/adobe-commerce/landing) - 🇧🇷 [Brasil](https://www.mercadopago.com.br/developers/pt/docs/adobe-commerce/landing) - 🇨🇱 [Chile](https://www.mercadopago.cl/developers/es/docs/adobe-commerce/landing) - 🇨🇴 [Colômbia](https://www.mercadopago.com.co/developers/es/docs/adobe-commerce/landing) - 🇲🇽 [México](https://www.mercadopago.com.mx/developers/es/docs/adobe-commerce/landing) - 🇵🇪 [Peru](https://www.mercadopago.com.pe/developers/es/docs/adobe-commerce/landing) - 🇺🇾 [Uruguai](https://www.mercadopago.com.uy/developers/es/docs/adobe-commerce/landing) ### License [Open Source License](LICENSE) ## Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ### [1.15.5] - 2026-07-01 #### Fixed - Fixed SVG logo/icon dimension extraction by replacing `getimagesizefromstring()` with `simplexml_load_file()` across all ConfigProvider models - Fixed console commands compatibility with Symfony 7 (Magento 2.4.9) by adding `: int` return type to `execute()` and replacing `Command::SUCCESS` with literal `0` #### Added - Added PHP 8.5 to supported platform constraint in `composer.json` for Adobe Commerce 2.4.9 compatibility - Declared `ext-simplexml` and `ext-libxml` as explicit `require` dependencies in `composer.json` - Added alphanumeric CNPJ validation and uppercase normalization before sending to payment API, supporting RFB Nota Técnica 49/2024 format #### Changed - Updated `mp-plugins/php-sdk` from `^3.3.2` to `^3.6.1` for PHP 8.5 compatibility ### [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 _(Changelog truncated for .md surface. Full history on https://packagento.com/mercadopago/adb-payment.)_ ## Recent Versions | Version | Released | |---|---| | 1.15.5 | 2026-07-06 | | 1.15.4 | 2026-05-15 | | 1.15.3 | 2026-04-28 | | 1.15.2 | 2026-04-01 | | 1.15.1 | 2026-03-20 | | 1.15.0 | 2026-02-26 | | 1.14.0 | 2026-01-12 | | 1.13.2 | 2025-12-04 | | 1.13.1 | 2025-12-03 | | 1.13.0 | 2025-11-27 | Showing 10 of 38 versions. Full release history on https://packagento.com/mercadopago/adb-payment. ## Dependencies ### Require | Package | Constraint | |---|---| | ext-gd | * | | ext-json | * | | ext-libxml | * | | ext-simplexml | * | | ext-zip | * | | mp-plugins/php-sdk | ^3.6.1 | | php | ~7.3.0\|\|~7.4.0\|\|~8.1.0\|\|~8.2.0\|\|~8.3.0\|\|~8.4.0\|\|~8.5.0 | ### Require (dev) | Package | Constraint | |---|---| | magento/magento-coding-standard | * | | phpmd/phpmd | ^2.13 | | phpstan/extension-installer | ^1.2 | | phpstan/phpstan | ^1.6.8 | ## Quality Latest release (1.15.5) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers. ### Compatibility Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`. | 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 | – | – | Pass | Pass | ### Code Quality Advisory checks against the module's source. Never affect the Compatibility verdict — 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 | 3431 | 6 errors, 3425 warnings (ruleset: Magento2), 3049 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 against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases. | Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 | |---|---|---|---|---| | 2.4.7 | 449 | 449 | – | – | | 2.4.8 | – | 449 | 449 | – | | 2.4.9 | – | – | 448 | 448 | ### Tests Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately. #### Unit Tests | Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 | |---|---|---|---|---| | 2.4.7 | 1 | 1 | – | – | | 2.4.8 | – | 37 | 37 | – | | 2.4.9 | – | – | 152 | 166 | #### 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 Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright. | Tool | Status | Findings | Summary | |---|---|---|---| | Composer audit | Pass | 0 | | | Malware scan | Pass | 0 | | ## Licence and pricing Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step. Refundable within 14 days of first purchase via https://packagento.com/account/refunds/. ## Install via Claude Code or any MCP client The Packagento MCP server can run the licence + project + Composer steps above in one tool call: ``` purchase_and_install_packages( composer_names=["mercadopago/adb-payment"], project_id="proj_xxx" ) ``` This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup. ## Vendor mercadopago is a Magento 2 vendor on Packagento. See https://packagento.com/mercadopago.md for their full catalogue.