Skip to main content

MercadoPago integration for django

Project description

build status coverage report version on pypi licence

django-mercadopago is a simple django application for interacting with MercadoPago, aiming to be rather simple, and only covers the basic uses cases.

Features

Our intention is not to cover 100% of the features of the upstream API, but rather provide a simple app that allows accepting and tracking payments. This should suffice for simple sites like shopping carts, online sales, etc.

Pull requests are always welcome. Please don’t hesitate to open an issue if you encounter a problem. New features will generally only be added as needed, but again, accepted if you submit a patch.

Installation

Installation should generally be done via pip:

pip install django-mercadopago

Configuration

You’ll need to obtainer your API credentials (app id and secret key) here and create an Account object with them. This creation can be done via the django admin included with this app or programmatically.

You should also expose the notifications endpoints like this:

url(r'^mercadopago/', include('django_mercadopago.urls'), namespace='mp'),
# Make sure namespace is 'mp', since we assume it is for notification URL
# contruction.

Note that these endpoints are required, since notification callbacks won’t work without them.

There are also a few Django settings that configure the behaviour of this app:

MERCADOPAGO_AUTOPROCESS

Required

If MERCADOPAGO_AUTOPROCESS is True, notifications will be processed as soon as they are received. Otherwise, it’s up to the developer to process them. A signal is always fired when a notification has been created, and a common pattern if not auto-processing is to have a celery task to process them:

@receiver(notification_received)
def process_notification(sender, **kwargs):
    tasks.process_notification.delay(notification=sender)

MERCADOPAGO_POST_PAYMENT_VIEW

Required

The setting MERCADOPAGO_POST_PAYMENT_VIEW must define name of the view where users are redirected after a payment. This view will receive as an argument the id of the notification created for this payment.

MERCADOPAGO_BASE_HOST

Required

MERCADOPAGO_BASE_HOST defines the domain name to use for notification URLs. It’ll be prepended to the exact URL of the exposed notifications endpoint.

Usage

MercadoPago lets you create preferences, for which you’ll later receive notifications (indicating if it was paid, or what happened):

self.preference = Preference.objects.create(
    title='the product name',
    price=10.0,
    reference='order-38452',
    success_url='http://example.com/mp_done',
    account=account,
)

If your app will only be using a single MercadoPago account, just use:

account = Account.objects.first()

Finally, you can handle payment notifications in real time using a post_update hook:

@receiver(post_save, sender=MercadoPagoPayment)
def process_payment(sender, instance=None, created=False, **kwargs):
    do_stuff()

Backwards compatibility

Note that, prior to v4.2.0, this package was called django-mercadopago-simple on PyPI. Older release exist under that name.

Version 2.0.0 changes the database schema quite a bit. While older data is retained, some missing fields had to be filled. Auto-generated data will have negative key values, and should easily be recognizable.

Regrettably, filling in this data automatically is not possible. However, there is no data loss involved.

Licence

This software is distributed under the ISC licence. See LICENCE for details.

Copyright (c) 2015-2017 Hugo Osvaldo Barrera <hugo@barrera.io>

Project details


Download files

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

Source Distribution

django-mercadopago-4.6.2.tar.gz (17.6 kB view details)

Uploaded Source

Built Distribution

django_mercadopago-4.6.2-py3-none-any.whl (26.5 kB view details)

Uploaded Python 3

File details

Details for the file django-mercadopago-4.6.2.tar.gz.

File metadata

File hashes

Hashes for django-mercadopago-4.6.2.tar.gz
Algorithm Hash digest
SHA256 bcead2a6041757efa91e3d8a1acd3325d9d6d89fca8a44c992e8be0db4662bae
MD5 d54b52fcf8f03d52f5a8c6c5b31682e9
BLAKE2b-256 06a89d403f5f9745a900634d9c22257df1437a5f0bf9ab3626fe149886797fe1

See more details on using hashes here.

Provenance

File details

Details for the file django_mercadopago-4.6.2-py3-none-any.whl.

File metadata

File hashes

Hashes for django_mercadopago-4.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 32baaff2caa02d5526f5e310699adccdef6be294204569c0dc012e03ee332700
MD5 9a271886baf7dbc54b9ca646eca43ebc
BLAKE2b-256 44582cd2b8e10e7edd9f51dff68b1d0e49763746b8f424d56be74f1be8f78892

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page