Skip to main content
Mercado Pago Gateway for Odoo (LatAm) — Build-to-order Mercado Pago payment acquirer for Odoo 17/18/19: cards, Pix, boleto, i — 1/1Illustrative preview

Build-to-order Mercado Pago payment acquirer for Odoo 17/18/19:

cards, Pix, boleto, installments, webhooks & refunds across LatAm.

What is Mercado Pago Gateway for Odoo (LatAm)?

Build-to-order Mercado Pago payment acquirer for Odoo 17/18/19: cards, Pix, boleto, installments, webhooks & refunds across LatAm. Built to order by ECOSIRE for Odoo 17, 18, 19 — indicative price from $999.00 USD; request a quote for a scoped proposal.

Key Features

New `payment.provider` record for Mercado Pago with sandbox/production toggle, per-country account support (AR, BR, MX, CL, CO, UY, PE) and encrypted credential fields (public key, access token, webhook secret) exposed only to accounting/admin via record rules
Checkout Pro (hosted, redirect) flow — lowest PCI burden, fastest to launch, mobile-optimized Mercado Pago wallet login and saved cards
Transparent / Bricks checkout — on-site card capture inside your Odoo eCommerce so buyers never leave your storefront
Card payments (credit and debit) with tokenization handled by Mercado Pago, so raw PAN never touches your Odoo server
Pix instant payments with QR code and copy-paste code rendered at checkout, reconciled automatically on webhook confirmation
Boleto bancário support (Brazil) with due-date handling and pending-state tracking until the bank confirms
Account money (dinero en cuenta) and other Mercado Pago wallet balances as a checkout option
Installment (cuotas) configuration — choose issuers, max installments, and merchant- vs buyer-paid interest; live installment picker at checkout with per-plan totals
Webhook / IPN endpoint that reconciles asynchronous payments and maps Mercado Pago statuses (approved, pending, in_process, rejected, refunded, charged_back) onto Odoo `payment.transaction` states
Full and partial refunds triggered from the Odoo transaction, pushed to Mercado Pago's refund API and written back onto the linked invoice and journal
Automated action / scheduled `ir.cron` job that re-polls pending Pix/boleto transactions as a safety net if a webhook is missed
Signature-verified webhook handling (x-signature / secret validation) to reject spoofed notifications
Multi-currency awareness aligned to your Mercado Pago country (ARS, BRL, MXN, CLP, COP, UYU, PEN) with rounding that matches Odoo journals
Customer portal and order confirmation integration so paid, pending and refunded states show consistently to buyers and staff
Structured logging of API requests/responses for auditability and faster support, with secrets redacted

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your Odoo.

  3. 3

    Go live + support

    You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.

Technical Specifications

Odoo Compatibility
Odoo 17, Odoo 18, Odoo 19
Editions
Enterprise & Community
License
Licence confirmation required
Python Requirement
Python 3.10+
Database
PostgreSQL 12+

About this Product

Mercado Pago is the default way Latin American shoppers pay — yet Odoo ships no native connector for it, so most merchants fall back to manual bank transfers, lose sales to installment-hungry buyers, or stitch together brittle scripts. This is a build-to-order Odoo payment acquirer that ECOSIRE designs, codes, installs and supports for your specific store. It is not an instant apps.odoo.com download; we build it around your business, your Mercado Pago country account (Argentina, Brazil, Mexico, Chile, Colombia, Uruguay, Peru), your currency and your checkout flow, then hand over the full source.

Under the hood we extend Odoo's standard payment framework: a new payment.provider (Mercado Pago) with server-side credential fields (public key, access token, webhook secret) stored on a dedicated models.Model, secured by ir.model.access.csv plus record rules so only accounting and admin roles can view live tokens. Transactions flow through Odoo's payment.transaction model, so orders, invoices and the customer portal reconcile exactly the way native acquirers do — no parallel bookkeeping. We wire both Checkout Pro (hosted, PCI-lightest) and transparent/Bricks checkout (on-site card capture) so you choose the balance of conversion and control that fits your risk profile.

The gateway speaks Mercado Pago's REST API for payment creation, status polling and refunds, and consumes IPN/webhook notifications to reconcile asynchronous methods like Pix and boleto. Installments (cuotas) are fully configurable — you decide which card issuers, how many installments, and whether interest is merchant- or buyer-borne — and the choices render live at checkout. Every state transition (pending, authorized, done, cancelled, refunded) maps cleanly onto Odoo's transaction states and fires the standard confirmation and dunning logic. Refunds are one click from the Odoo transaction: total or partial, pushed to Mercado Pago and written back on the linked invoice.

Because it is real Odoo code — clean models, XML/OWL views, QWeb-friendly transaction reports, and automated actions for stuck-payment retries — it upgrades with your database and stays inspectable by any Odoo developer. Works on Community and Enterprise, on Odoo 17, 18 and 19. ECOSIRE handles the module, the sandbox-to-production credential setup, a documented handover and a support window; you get a maintainable connector, not a black box.

What you get

  • Complete Odoo module source (own addon with `__manifest__.py`, models, views, security CSV, static assets) targeting your chosen version — 17, 18 or 19 — delivered to your Git or as a zip you own outright
  • Mercado Pago account wiring: sandbox validation first, then production credentials configured on the `payment.provider`, webhook URL registered, and a documented go-live checklist
  • Installment (cuotas) and checkout-mode configuration (Checkout Pro and/or transparent) tuned to your country, issuers and margin policy
  • Refund and reconciliation workflow set up against your accounting journals, tested with real sandbox refunds (full and partial)
  • Written technical + admin documentation: architecture notes, credential rotation steps, webhook troubleshooting, and how to add issuers or change installment rules later
  • A live training/handover session for your team (checkout ops, refunds, reading transaction states) with a recording
  • A defined post-launch support and bug-fix window covering the delivered scope, plus paid options to extend
  • Deployment support to your environment (Odoo.sh, ECOSIRE-managed, or self-hosted) with a sandbox-to-production migration path

Who this is for

LatAm eCommerce merchant on Mercado Pago

Runs an Odoo website/eShop in Argentina, Brazil or Mexico and needs shoppers to pay the way they already do — cards, Pix, boleto and, above all, installments — instead of dropping off at a bank-transfer wall.

Finance / accounting lead

Wants every Mercado Pago charge, installment and refund reconciled inside Odoo against the right journal automatically, with no spreadsheet re-keying and a clear audit trail for chargebacks.

Odoo partner or in-house developer

Needs a clean, upgrade-safe acquirer built on Odoo's standard `payment.provider`/`payment.transaction` framework — real code they can read, extend and maintain — not an opaque third-party binary.

Operations manager scaling across countries

Manages checkout for multiple LatAm markets and needs one consistent Odoo flow that swaps per-country Mercado Pago credentials, currencies and installment rules without re-architecting the store.

How Mercado Pago Gateway for Odoo (LatAm) Compares

CriterionECOSIRECustom BuildCompetitorOdoo Native
Mercado Pago cards, Pix, boleto & account money in Odoo checkoutIncludedPartial supportPartial supportNot included
Installment (cuotas) configuration with live per-plan totals at checkoutIncludedPartial supportPartial supportNot included
Built on standard `payment.provider`/`payment.transaction` — upgrade-safe, no parallel bookkeepingIncludedPartial supportPartial supportIncluded
Webhook/IPN reconciliation for async Pix & boleto + `ir.cron` re-poll fallbackIncludedPartial supportPartial supportNot included
Full & partial refunds pushed from Odoo and written back to the invoiceIncludedPartial supportPartial supportNot included
Full source ownership, documentation, training & support windowIncludedPartial supportNot includedNot included
Both Checkout Pro (hosted) and transparent/Bricks on-site checkoutIncludedPartial supportPartial supportNot included
Tailored to your country account, currency, issuers & margin policyIncludedIncludedNot includedNot included

Frequently Asked Questions about Mercado Pago Gateway

How long until the Mercado Pago gateway is live, and is this an instant download?

This is a build-to-order module, not an instant apps.odoo.com download. Typical delivery is one working week depending on which checkout modes you need (Checkout Pro, transparent, or both), how many payment methods and installment rules apply, and your target Odoo version. We start in Mercado Pago sandbox, validate every method and refund path, then cut over to production credentials on your environment. You receive a go-live date after a short scoping call.

What kind of support and updates do I get after launch?

Every build includes a defined post-launch support and bug-fix window covering the delivered scope — if a webhook, refund or checkout path misbehaves, we fix it. Because it's genuine Odoo code using the standard payment framework, the module upgrades cleanly with your database; we also offer paid retainers for new methods, added installment issuers, Mercado Pago API changes, or upgrades across Odoo 17, 18 and 19.

Which Odoo versions and editions does this support?

Odoo 17, 18 and 19, on both Community and Enterprise. It extends the same `payment.provider` and `payment.transaction` models the core acquirers use, so it fits Odoo Website/eCommerce checkout and the customer portal natively. Tell us your version and edition during scoping and we build to match.

Which payment methods and installments are covered?

Credit and debit cards, Pix, boleto bancário, and Mercado Pago account money, depending on your country account (Argentina, Brazil, Mexico, Chile, Colombia, Uruguay, Peru). Installments (cuotas) are fully configurable — you choose the eligible issuers, the maximum number of installments, and whether interest is absorbed by you or the buyer. The installment picker and per-plan totals render live at checkout.

How are asynchronous payments like Pix and boleto reconciled?

The module exposes a signature-verified webhook/IPN endpoint that Mercado Pago calls when a payment's status changes. We map Mercado Pago statuses (approved, pending, in_process, rejected, refunded, charged_back) onto Odoo transaction states so orders confirm automatically once payment clears. As a safety net, a scheduled `ir.cron` job re-polls any transaction still pending in case a webhook is missed.

Is it secure, and do raw card numbers touch my server?

No raw card data is stored on your Odoo server. Card tokenization is handled by Mercado Pago; with Checkout Pro the card entry happens on Mercado Pago's hosted page, and with transparent/Bricks checkout the sensitive fields are tokenized client-side. Live API credentials are stored on a dedicated model protected by `ir.model.access.csv` and record rules so only accounting and admin roles can read them, and webhook notifications are signature-verified to reject spoofed calls.

Can I use one build across multiple LatAm countries?

Yes. The acquirer is currency- and country-aware, so you can run per-country Mercado Pago credentials, currencies (ARS, BRL, MXN, CLP, COP, UYU, PEN) and installment rules through the same Odoo checkout flow. Multi-country scope is part of the scoping conversation and may extend the build timeline slightly.

Request a quote

Mercado Pago Gateway

Build-to-order Mercado Pago payment acquirer for Odoo 17/18/19: cards, Pix, boleto, installments, webhooks & refunds across LatAm.

  • New `payment.provider` record for Mercado Pago with sandbox/production toggle, per-country account support (AR, BR, MX, CL, CO, UY, PE) and encrypted credential fields (public key, access token, webhook secret) exposed only to accounting/admin via record rules
  • Checkout Pro (hosted, redirect) flow — lowest PCI burden, fastest to launch, mobile-optimized Mercado Pago wallet login and saved cards
  • Transparent / Bricks checkout — on-site card capture inside your Odoo eCommerce so buyers never leave your storefront
  • Card payments (credit and debit) with tokenization handled by Mercado Pago, so raw PAN never touches your Odoo server

Request a Quotation

Tell us about your Mercado Pago Gateway requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.