---
id: mercadopago
version: "3.5.0"
license: MIT License Copyright (c) 2021 MercadoPago Developers Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# mercadopago — Mercadopago SDK module for Payments integration

License: permissive · Maintenance: active · Downloads: 366.1K/mo

## 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 above — 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

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

- License: MIT License Copyright (c) 2021 MercadoPago Developers Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 366.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mercado pago payment sdk, python payment gateway integration, checkout api client, online payment processing, mercadopago orders api, payment method integration, credit card payment sdk, payment-processing, mercado-pago, e-commerce

[View on SkillFed](https://skillfed.io/packages/mercadopago) · [View on PyPI](https://pypi.org/project/mercadopago/)