mercadopago

What it is and what it does

The mercadopago package is the official Python SDK for Mercado Pago, a Latin American payment platform. It wraps Mercado Pago's REST APIs into a Python object model, letting you create orders, process payments, and manage transactions without building HTTP calls manually. The SDK supports both the modern Orders API (recommended for new integrations) and the legacy Payments API, with optional typed request dataclasses for schema validation.

You initialize the SDK with your access token, then call methods like `sdk.order().create()` or `sdk.payment().create()` with payment data as a dict or typed object. Responses come back as dicts keyed by 'response' and 'status'. The package depends only on requests and requires Python 3.10+, making it lightweight to add to existing projects.

Use it for:

• Accept online payments on an e-commerce site using the Orders API with card tokens and installment options.
• Process recurring or subscription payments with automatic payment methods and stored credentials.
• Integrate Mercado Pago Checkout Pro or Web Tokenize Checkout into a web application.
• Query and manage payment history and transaction details programmatically.
• Build a payment flow with custom headers and idempotency keys for reliable request handling.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides Python bindings to integrate Mercado Pago's payment APIs, enabling you to create orders, process payments, and manage transactions programmatically.

Yes. The package is actively maintained, has no known vulnerabilities, installs with minimal friction, and is MIT-licensed. Install it if you need to integrate Mercado Pago payments into a Python application. The only prerequisite is Python 3.10+ and a valid Mercado Pago account with an access token.

Install

mercadopago on PyPI

pip install mercadopago

uv add mercadopago

poetry add mercadopago

Installing mercadopago

Before you install

Low friction install with a single dependency (requests). The package is actively maintained with a recent release (3 days old) and has been in development since 2012, indicating stable long-term support.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install mercadopago

import mercadopago

sdk = mercadopago.SDK("YOUR_ACCESS_TOKEN")
order_data = {"type": "online", "total_amount": "100.00"}
result = sdk.order().create(order_data)
print(result["response"])

Requires Python 3.10 or higher; you must obtain an Access Token from your Mercado Pago credentials panel.

Verify before relying

• Whether the SDK handles webhook signature verification for payment notifications.
• Rate limiting behavior and retry logic for failed API requests.
• Support for all Mercado Pago payment methods beyond credit cards (e.g., digital wallets, bank transfers).

Package facts

Evidence: mercadopago-3.5.0-py3-none-any.whl

Keywords: api, mercadopago, checkout, payment in sdk integration, lts

Tags

More Python Modules packages