Skip to main content

An API wrapper for MercadoPago

Project description


.. image::
:alt: Latest Version

.. image::

PyMercadoPago is user-friendly library to interact with the MercadoPago API.

To install from PyPI::

pip install pymercadopago

If you haven't done so already, obtain your ``CLIENT_ID`` and ``CLIENT_SECRET`` `here


Create a new ``mercadopago.Client`` instance and pass it your credentials:

.. highlight:: python


import mercadopago


mp = mercadopago.Client(CLIENT_ID, CLIENT_SECRET)

You can navigate the full API from the client methods. Try running the above
code in a Python shell and explore them.


# Get the invoice with ID 1234


# Get the current user account balance


# Create a new customer instance
# ...

In general, assuming ``mp`` is a ``mercadopago.Client`` instance and there is
an endpoint documented at (for example) ``/customers`` or ``/v1/customers``,
you can do:

List all customers. Pass pagination parameters via keyword arguments.

Create a new Customer.

Delete a Customer.

Update a Customer, include ``ìd`` in your keword arguments.

Search for customers matching params.

Not all methods are available for all resources, and some additional methods
are provided for convenience. To learn more, check out the official docs and
the code from the ``mercadopago.api`` module.

Nested resources like ``/v1/customers/:id/cards`` are usually accessed by
following the resource paths: ````

All methods return a ``mercadopago.response.Response`` object if successful
(HTTP status code in the 2XX range) or raise a ``mercadopago.errors.Error`` or
one of its subclasses otherwise.


:url The requested URL.
:status_code: The HTTP status_code returned by the API.
:data: The JSON response returned by the API, as a standard Python dict/list.

If MercadoPago returns a response with pagination information, a
``mercadopago.response.PaginatedResponse`` will be returned instead.


:http_status: The HTTP status_code returned by the API, if applicable.
:code: The error code returned by the API, if applicable.
:json_data: The full JSON response returned by the API, if applicable.

The library will raise specific subclasses of ``mercadopago.errors.Error``
according to the HTTP status code returned:

:400: ``mercadopago.errors.BadRequestError``
:401: ``mercadopago.errors.AuthorizationError``
:404: ``mercadopago.errors.NotFoundError``


For more information about the API, refer to the `official docs


Federico Bond



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pymercadopago, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size pymercadopago-0.1.1.tar.gz (9.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page