Skip to main content

Mercadopago SDK module for Payments integration

Project description

Install

On Python 2.x

pip install mercadopago

On Python 3.x

pip3 install mercadopago

Basic checkout

Configure your credentials

import mercadopago
import json

mp = mercadopago.MP("CLIENT_ID", "CLIENT_SECRET")

Preferences

Get an existent Checkout preference

def index(req, **kwargs):
    preferenceResult = mp.get_preference("PREFERENCE_ID")

    return json.dumps(preferenceResult, indent=4)

Create a Checkout preference

def index(req, **kwargs):
    preference = {
        "items": [
            {
                "title": "Test",
                "quantity": 1,
                "currency_id": "USD",
                "unit_price": 10.4
            }
        ]
    }

    preferenceResult = mp.create_preference(preference)

    return json.dumps(preferenceResult, indent=4)

Update an existent Checkout preference

def index(req, **kwargs):
    preference = {
            "items": [
                {
                    "title": "Test Modified",
                    "quantity": 1,
                    "currency_id": "USD",
                    "unit_price": 20.4
                }
            ]
        }

    preferenceResult = mp.update_preference(id, preference)

    return json.dumps(preferenceResult, indent=4)

Payments/Collections

Search for payments

def index(req, **kwargs):
    filters = {
        "id": None,
        "site_id": None,
        "external_reference": None
    }

    searchResult = mp.search_payment(filters)

    return json.dumps(searchResult, indent=4)

Get payment data

import mercadopago
import json

def index(req, **kwargs):
    mp = mercadopago.MP("CLIENT_ID", "CLIENT_SECRET")
    paymentInfo = mp.get_payment (kwargs["id"])

    if paymentInfo["status"] == 200:
        return json.dumps(paymentInfo, indent=4)
    else:
        return None

Cancel (only for pending payments)

def index(req, **kwargs):
    result = mp.cancel_payment("ID")

    // Show result
    return json.dumps(result, indent=4)

Refund (only for accredited payments)

def index(req, **kwargs):
    result = mp.refund_payment("ID")

    // Show result
    return json.dumps(result, indent=4)

Customized checkout

Configure your credentials

import mercadopago
import json

mp = mercadopago.MP("ACCESS_TOKEN")

Create payment

mp.post ("/v1/payments", payment_data)

Create customer

mp.post ("/v1/customers", {"email": "email@test.com"})

Get customer

mp.get ("/v1/customers/CUSTOMER_ID")

Generic methods

You can access any other resource from the MercadoPago API using the generic methods:

// Get a resource, with optional URL params. Also you can disable authentication for public APIs
mp.get ("/resource/uri", [params], [authenticate=true]);

// Create a resource with "data" and optional URL params.
mp.post ("/resource/uri", data, [params]);

// Update a resource with "data" and optional URL params.
mp.put ("/resource/uri", data, [params]);

// Delete a resource with optional URL params.
mp.delete ("/resource/uri", [params]);

For example, if you want to get the Sites list (no params and no authentication):

result = mp.get ("/sites", null, false);

print (json.dumps(result, indent=4))

Running tests

On Python 2.x

python setup.py test

On Python 3.x

python3 setup.py test

Project details


Release history Release notifications

This version
History Node

0.3.4

History Node

0.3.3

History Node

0.3.1

History Node

0.3.0

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.8

History Node

0.1.5

History Node

0.0.2

History Node

0.0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
mercadopago-0.3.4.macosx-10.10-intel.exe (74.0 kB) Copy SHA256 hash SHA256 Windows Installer any Aug 20, 2015
mercadopago-0.3.4.tar.gz (5.3 kB) Copy SHA256 hash SHA256 Source None Aug 20, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page