Connecting the Mercado Pago terminal to the Odoo point of sale lets you charge by card, QR or digital wallet without typing amounts by hand and with the sale recorded automatically. This guide covers initial setup, token renewal, daily charging, refunds and working with branches.
What the integration gives you
- Charges from the terminal with the sale details sent by Odoo, with no need for the terminal to be connected to a computer.
- Management of several terminals and points of sale from one place.
- Split, declined and cancelled payments handled within the normal POS flow.
- Simpler reconciliation, because each charge is recorded in the accounting journal of the payment method.
Step-by-step setup
1. Create the payment method
In the Point of Sale app, open Payment Methods and create a new one. If you have several stores, create one method per terminal with a descriptive, unique name, for example Mercado Pago Central, and select the matching accounting journal.
2. Set up the terminal integration
In the integration type choose Terminal and then Mercado Pago. Turn on the Smart Payment checkbox to work with the latest terminal model.
3. Get the credentials
You need four items from Mercado Pago: Client ID, Client Secret, Secret Key and the terminal ID. They are sensitive credentials: do not share them with third parties.
4. Validate the token
- With the credentials entered, click Validate Token.
- In the window that opens, sign in and select the country.
- Copy only the PKCE code that is generated and paste it into Odoo.
- Click Create Token to finish.
Token renewal
Each integrated terminal needs an authorization token with a limited validity. If it expires, the payment method stops being available. Odoo offers two ways to renew it:
- Manual: from the payment method settings, with the refresh token button.
- Automatic: Odoo renews the token each time you log in to the point of sale, as long as the renewal date has passed.
You can check each token's expiry date in the payment method settings.
Charging a sale
- Log in to the POS and confirm the Mercado Pago method is linked to your terminal.
- Make the sale as usual and click Pay.
- Choose Mercado Pago: Odoo sends the details to the terminal and the customer chooses how to pay (card, QR, wallet).
- When the payment completes, the terminal issues the receipt and Odoo records the transaction.
Cancelled or declined payment
If the customer cancels or the card is declined, Odoo detects it and notifies you. You can retry the charge, cancel the order or edit the sale before charging again. For a decline, ask the customer for another card or method and retry.
Split payment
Enter the amount paid in cash and the remainder is charged through the Mercado Pago terminal. The system handles each portion separately.
Refunds with Mercado Pago
The refund flow is Odoo's standard one: from the actions menu you choose Refund, select the document, set the quantities and confirm. When choosing how to refund, if the original charge was made with Mercado Pago, you can refund through the same method and the amount goes back to the same card without the customer returning to the terminal.
- If the original charge was not through Mercado Pago, Odoo warns that it cannot find the operation to refund, and you must use the right method.
- To verify, in the terminal activity menu refunds appear as negative values, which helps with reconciliation.
Mercado Pago in branches
In Odoo a branch is a child company that shares the chart of accounts with the parent but keeps independent records. Integrating terminals in branches follows the same process as in the main company: create the payment method from the branch itself, with its journal, the terminal integration with Mercado Pago and Smart Payment, and validate the credentials and token.
When a branch fails, the cause is usually in the Odoo configuration and not in Mercado Pago. Check:
- That the chart of accounts is active for the branch.
- That the sales journals are correctly configured.
- That no third-party app is modifying the base configuration of the payment method.
- That Odoo and the module are up to date, and that each incident is documented.
Implementation with Ganemo
The Mercado Pago integration module is developed by Ganemo, an Odoo partner. Learn about support options on the Mercado Pago with Odoo page, see the Mercado Pago Payment (Peru) module and, for the rest of the point of sale, the Odoo Point of Sale page. If you are starting with Odoo, see how we run an Odoo implementation in Peru, or reach us through contact.