Quick facts
- Price
- $199.00 USD
- magento_2 versions
- —
- Setup time
- 90 min
- License
- One-time perpetual
- Languages
- 11 languages
One-time Purchase
MercadoPago Gateway for Magento 2
A MercadoPago payment method for Magento 2 and Adobe Commerce covering cards with installments, Pix, boleto bancário and OXXO cash vouchers, Wallet checkout, refunds and webhook reconciliation — built to order, installed and supported by ECOSIRE for Brazil, Mexico and Argentina merchants.
$199.00USD
No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.
Key Features
Card payments with installments (cuotas/parcelas) — installment plans, interest-free and interest-bearing options resolved live from the MercadoPago API per country and amount
Pix support for Brazil with QR code, copy-paste payload, expiry and pending-to-paid reconciliation
Boleto bancário generation with barcode/voucher rendering and due-date handling
OXXO cash voucher support for Mexico with printable reference and pending order state
Wallet checkout via MercadoPago Checkout Pro / Bricks (account-based redirect or embedded payment)
Native Magento Payment Gateway architecture — command pool, request/response builders, value handlers and validators wired in di.xml
Asynchronous webhook/IPN controller with signature/notification validation that reconciles payment status to Magento order state and invoices via service contracts
Online refunds and partial refunds posted back to MercadoPago through the Magento credit-memo flow
Sandbox and production credentials with encrypted storage, per-website/store-view scope and admin ACL under Stores → Configuration
Country-aware method availability (BR / MX / AR) so only valid payment options render at checkout
Works with Luma checkout and headless/PWA storefronts through Magento GraphQL and REST payment endpoints
Order status mapping for approved, pending, in_process, rejected, refunded and charged_back with safe invoice/cancel transitions
Logging and a debug mode for API request/response tracing to simplify dispute and reconciliation investigations
Cron-assisted cleanup of stale pending Pix/boleto/OXXO orders that never clear
About this Product
This is a build-to-order MercadoPago integration for Magento 2 (Open Source) and Adobe Commerce, engineered around Magento's native Payment Gateway abstraction rather than bolted onto the legacy Mage_Payment flow. ECOSIRE delivers it as a versioned module under app/code/Ecosire/MercadoPago, wired through di.xml using Magento\Payment\Gateway\Command, value handlers and validators, so authorize, capture, sale and refund each map to a discrete gateway command against the MercadoPago Payments API.
Why Choose MercadoPago Gateway for Magento 2
Card payments with installments (cuotas/parcelas) — installment plans, interest-free and interest-bearing options resolved live from the MercadoPago API per country and amount
Pix support for Brazil with QR code, copy-paste payload, expiry and pending-to-paid reconciliation
Boleto bancário generation with barcode/voucher rendering and due-date handling
OXXO cash voucher support for Mexico with printable reference and pending order state
Wallet checkout via MercadoPago Checkout Pro / Bricks (account-based redirect or embedded payment)
Native Magento Payment Gateway architecture — command pool, request/response builders, value handlers and validators wired in di.xml
LATAM checkout is the point of the module. Brazilian buyers get Pix (with QR + copy-paste code and expiry handling) and boleto bancário; Mexican buyers get OXXO cash vouchers; and across BR/MX/AR shoppers can pay by card in installments (cuotas/parcelas), with installment options resolved live from MercadoPago so the storefront shows real interest-bearing and interest-free plans. Wallet checkout (Checkout Pro redirect / Brick) is included for account-based payment.
On the back end, an asynchronous webhook controller validates MercadoPago IPN/Webhook notifications, reconciles payment status (approved, pending, in_process, rejected, refunded, charged_back) and drives Magento order state and invoices through service contracts — critical because Pix, boleto and OXXO are confirmed minutes to days after order placement. Online refunds and partial refunds post back through the credit-memo flow. Admin configuration lives under Stores → Configuration with proper ACL, encrypted credentials, sandbox/production toggles and per-website scope.
ECOSIRE builds the module to your store's Magento version, theme and checkout (Luma or a headless/PWA front via GraphQL/REST), installs it on your environment, and supports it after launch. It is not an instant Adobe Commerce Marketplace download — there is an honest delivery lead time while we configure it against your MercadoPago account and country.
What you get
- Custom Magento 2 module (Ecosire_MercadoPago) under app/code, version-matched to your Magento 2 Open Source or Adobe Commerce release
- Installation and configuration on your environment (staging then production), including composer/registration and setup:upgrade
- MercadoPago account wiring — sandbox and live credentials, country/payment-method setup and webhook URL registration
- Webhook endpoint configured and verified end-to-end for Pix, boleto, OXXO and card status updates
- Admin configuration walkthrough and a short operator guide for refunds, reconciliation and pending-order handling
- Source code with module documentation, plus post-launch support and compatibility updates per the agreed support term
Who this is for
Brazilian Magento merchant
Sells on Magento 2 in Brazil and needs Pix and boleto bancário at checkout — the dominant local methods — alongside cards in parcelas, with orders only invoicing once MercadoPago confirms payment.
Mexican store operator
Runs an Adobe Commerce store in Mexico and wants OXXO cash vouchers plus installment card payments (meses sin intereses) so unbanked and cash-preferring customers can complete purchases.
Cross-border LATAM operations lead
Manages stores across Brazil, Mexico and Argentina on one Magento instance and needs a single MercadoPago integration that shows the right local methods and installments per country with reliable webhook reconciliation.
Installation overview
Download from ECOSIRE
Buy the license on ecosire.com and download the MercadoPago Gateway for Magento 2 module ZIP from your account dashboard.
Upload to Odoo
Extract the ZIP into your Odoo custom addons folder on the server (or upload via Apps > Install from file on Odoo.sh / runbot).
Install the module
Activate Developer Mode, open Apps, click Update Apps List, search for MercadoPago Gateway for Magento 2, and press Install.
Configure settings
Open the new menu, paste your ECOSIRE license key, connect any external credentials (Shopify, Amazon, Stripe, etc.), and save.
Verify & go live
Run the built-in connection test, sync your first 10 records, and schedule the recurring cron. Contact support if anything fails.
How MercadoPago Gateway for Magento 2 Compares
| Criterion | ECOSIRE | Custom Build | Competitor | Odoo Native |
|---|---|---|---|---|
| Cards with installments (cuotas/parcelas) resolved live from MercadoPago | ||||
| Pix, boleto bancário and OXXO cash vouchers | ||||
| Asynchronous webhook reconciliation to order state and invoices | ||||
| Built to your exact Magento version, theme and headless/PWA checkout | ||||
| Installed and configured on your environment by the provider | ||||
| Online and partial refunds via Magento credit-memo flow | ||||
| Post-launch support and API/version compatibility updates | ||||
| Native Magento Payment Gateway (di.xml command pool) architecture, no legacy hacks |
Frequently Asked Questions about MercadoPago Gateway for Magento 2
+How long does delivery take and what is the process?
This is built to order, not an instant Marketplace download. After purchase we confirm your Magento edition and version, MercadoPago account country (BR/MX/AR) and checkout type (Luma or headless). Typical delivery is around 2–3 weeks: we build the module to your environment, install it on staging, wire your sandbox credentials, verify the full webhook flow for cards, Pix, boleto and OXXO, then promote to production. Timelines can shift with custom checkout or PWA requirements, which we confirm in writing before starting.
+What ongoing support and updates do I get after launch?
The build includes a post-launch support term for bug fixes, configuration help and compatibility with Magento patch releases. Because MercadoPago periodically changes its API and payment-method rules, we keep the gateway commands and webhook handling current for your version during the support window. Extended support and upgrades for major Magento or Adobe Commerce version jumps are available as a continuing arrangement.
+Does it work with Adobe Commerce and headless / PWA storefronts?
Yes. The module targets both Magento Open Source and Adobe Commerce, and because payment data flows through Magento's service contracts and GraphQL/REST payment endpoints, it works with Luma checkout and with headless/PWA front ends. We confirm your specific storefront during scoping so the payment renderers and webhook return paths are built for your setup.
+Which payment methods and countries are supported?
Cards with installments (cuotas/parcelas) across Brazil, Mexico and Argentina; Pix and boleto bancário for Brazil; OXXO cash vouchers for Mexico; and Wallet/Checkout Pro. Available methods are country-aware, so customers only see options valid for the configured MercadoPago account. If you need additional MercadoPago methods for a specific country, we can scope them into the build.
+How are Pix, boleto and OXXO payments confirmed since they aren't instant?
These methods place the order in a pending state and are confirmed asynchronously — Pix usually within minutes, boleto and OXXO within hours to a few days. Our webhook controller validates each MercadoPago notification and reconciles the payment status to the Magento order, creating the invoice on approval or releasing/cancelling stale orders that never clear, with a cron-assisted cleanup for expired vouchers.
Why Customers Trust ECOSIRE
SOC 2 Aligned
GDPR Compliant
Secure Stripe Payment
30-Day Money Back
Lifetime Updates
LGPL-3.0 License
Related Modules
Request a quote
MercadoPago Gateway for Magento 2
A MercadoPago payment method for Magento 2 and Adobe Commerce covering cards with installments, Pix, boleto bancário and OXXO cash vouchers, Wallet checkout, refunds and webhook reconciliation — built to order, installed and supported by ECOSIRE for Brazil, Mexico and Argentina merchants.
- Card payments with installments (cuotas/parcelas) — installment plans, interest-free and interest-bearing options resolved live from the MercadoPago API per country and amount
- Pix support for Brazil with QR code, copy-paste payload, expiry and pending-to-paid reconciliation
- Boleto bancário generation with barcode/voucher rendering and due-date handling
- OXXO cash voucher support for Mexico with printable reference and pending order state