POS Mercado Pago

Integrate Mercado Pago payment into Odoo point of sale. Accept diverse electronic payment methods, auto-sync, and improve customer experience.

Point of Sale
Mercado Pago
Payment Gateway
QR Payment
E-wallet

Overview

POS Mercado Pago module integrates Mercado Pago payment gateway directly into Odoo point of sale system, allowing acceptance of credit cards, debit cards, QR codes, and e-wallets at checkout.

Transactions are automatically synced with the accounting system, minimizing manual errors and speeding up payment processing.


Key Features

Key points

  • • Credit/debit card payments - Accept Visa, Mastercard, American Express directly at POS

  • • QR code payments - Customers scan QR code to pay via Mercado Pago app

  • • E-wallet - Support payments through Mercado Pago accounts

  • • Auto-sync - Transactions automatically update in Odoo accounting system

  • • Easy refunds - Process refunds directly from POS interface

  • • Detailed reports - Track revenue by payment method

  • • High security - PCI DSS compliant, encrypted transaction data

  • • Multi-device support - Compatible with card readers, receipt printers


Target Users

Key points

  • • Retail stores - Supermarkets, convenience stores, fashion stores

  • • Restaurants and cafes - Fast payment for customers

  • • Electronics stores - Accept cashless payments

  • • Store chains - Centralized payment management for multiple branches


How to Use

Steps

  • 1. Install POS Mercado Pago module in Odoo

  • 2. Register business Mercado Pago account at mercadopago.com

  • 3. Get API credentials (Access Token) from Mercado Pago account

  • 4. Go to Point of Sale → Configuration → Payment Methods

  • 5. Create new payment method, select "Mercado Pago"

  • 6. Enter Access Token and configure options

  • 7. Assign payment method to POS that needs it

  • 8. Open POS session and start accepting Mercado Pago payments

  • 9. When paying, select "Mercado Pago" method and follow instructions

  • 10. Transaction auto-syncs after completion


Scenario 1: Card payment at checkout

Customer purchases items and wants to pay by credit card. Staff selects Mercado Pago method, customer taps/swipes card on reader, transaction confirmed instantly.

Receipt automatically prints with complete transaction information.


Scenario 2: QR code payment

Customer does not have card but has Mercado Pago app. Staff generates QR code from POS, customer scans code and confirms payment on phone.

Transaction confirmed in seconds, no physical contact needed.


Scenario 3: Customer refund

Customer returns product paid via Mercado Pago. Staff finds original order in POS, selects refund, money automatically returned to customer account/card.

No need to handle cash or manual transfers.


Scenario 4: Split payment

Customer wants to pay partly with cash, partly with Mercado Pago. Staff enters amount for each method, processes both transactions.

System accurately records each payment method.


Scenario 5: End of day report

End of shift, manager closes POS session and views report. System displays total revenue by payment method, including Mercado Pago.

Reconcile with Mercado Pago report to ensure accuracy.


Important Terminology

Key points

  • • Access Token - Authentication code to connect Odoo with Mercado Pago account

  • • Payment Terminal - Card reader device connected to POS

  • • QR Code Payment - Payment by scanning QR code

  • • Refund - Return money for completed transaction

  • • Payment Method - Payment method configured in POS

  • • Transaction ID - Unique transaction code from Mercado Pago

  • • Settlement - Process of transferring money from Mercado Pago to bank account


Tips for Effective Use

Key points

  • • Check internet connection - Ensure stable connection before opening POS session

  • • Train staff - Guide staff on handling different payment scenarios

  • • Prepare backup devices - Have backup card reader for equipment failure

  • • Check transactions regularly - Reconcile Odoo transactions with Mercado Pago daily

  • • Configure reasonable timeout - Set appropriate wait time to not keep customers waiting

  • • Use test mode - Test thoroughly before real deployment

  • • Update software - Keep module and Mercado Pago app up to date


System Requirements

Key points

  • • Point of Sale module installed and configured

  • • Verified business Mercado Pago account

  • • Valid Access Token from Mercado Pago

  • • Stable internet connection at point of sale

  • • Compatible card reader device (if accepting card payments)

  • • Access permission to configure Payment Methods in Odoo


Troubleshooting: Cannot connect to Mercado Pago

Key points

  • • Check if Access Token entered correctly

  • • Confirm Mercado Pago account is active

  • • Check internet connection

  • • View error logs in Odoo for details

  • • Try regenerating Access Token from Mercado Pago


Troubleshooting: Transaction declined

Key points

  • • Check customer card is still valid

  • • Confirm account balance sufficient for payment

  • • Retry transaction or use different method

  • • Contact card issuing bank if problem persists


Troubleshooting: Transaction not syncing

Key points

  • • Check internet connection at transaction time

  • • Go to Point of Sale → Orders → find order and sync manually

  • • Check webhook configuration in Mercado Pago

  • • View sync logs in Odoo

  • • Contact support if problem continues


Troubleshooting: Refund failed

Key points

  • • Confirm original transaction was successfully paid

  • • Check refund time limit (usually within 90 days)

  • • Ensure refund amount does not exceed original amount

  • • Try again after a few minutes

  • • Contact Mercado Pago support if needed


Frequently Asked Questions

Key points

  • • Which countries is Mercado Pago available in? - Mainly Latin American countries: Argentina, Brazil, Chile, Colombia, Mexico, Peru, Uruguay

  • • What are the transaction fees? - Depends on service plan and transaction type, usually 2-5%. See details at mercadopago.com

  • • How long until money reaches account? - Usually 1-2 business days after successful transaction

  • • Can I do partial refunds? - Yes, partial or full refunds are possible

  • • Is special equipment needed? - Not required for QR payments, but card reader needed for card payments

  • • Is offline support available? - No, internet connection required to process transactions


Business Benefits

Key points

  • • Increase payment speed by 30-40% compared to cash

  • • Reduce risk of cash loss and fraud

  • • Improve customer experience with multiple payment options

  • • Automate reconciliation and financial reporting

  • • Increase revenue by accepting cashless payments

  • • Reduce operational costs related to cash handling