跳转到主要内容

MercadoPago集成django

项目描述

build status coverage report version on pypi licence

从4.2.0版本开始,此包将在PyPI中重命名为django-mercadopago。请更新您的引用。 导入和模块保持不变。

django-mercadopago-simple 是一个简单的django应用,用于与MercadoPago交互,旨在保持简单,仅覆盖基本的使用场景。

特性

我们的意图不是涵盖上游API的所有功能,而是提供一个简单的应用程序,允许接受和跟踪支付。这对于简单的网站,如购物车、在线销售等应该足够了。

欢迎提交拉取请求。如果您遇到问题,请不要犹豫,提出问题。新功能通常只有在需要时才会添加,但如果您提交了补丁,也会被接受。

安装

通常应通过pip进行安装

pip install django-mercadopago-simple

配置

您需要从此处获取您的API凭据(app idsecret key)并使用它们创建一个Account对象。此创建可以通过此应用中包含的django管理器或编程方式完成。

您还应公开通知端点,如下所示

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

请注意,这些端点是 必需的,因为如果没有它们,通知回调将无法工作。

还有一些Django设置可以配置此应用的行为

MERCADOPAGO_AUTOPROCESS

必需

如果 MERCADOPAGO_AUTOPROCESS 设置为 True,则通知会在收到后立即处理。否则,开发者需要自行处理。每当创建一个通知时,都会触发一个信号。如果不自动处理,则通常会有一个 celery 任务来处理这些通知

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

MERCADOPAGO_POST_PAYMENT_VIEW

必需

设置 MERCADOPAGO_POST_PAYMENT_VIEW 必须定义用户在支付后将被重定向到的视图的名称。此视图将接收一个参数,即为此支付创建的通知的 id

MERCADOPAGO_BASE_HOST

必需

MERCADOPAGO_BASE_HOST 定义用于通知 URL 的域名。它将添加到暴露的通知端点的确切 URL 前面。

使用方法

MercadoPago 允许您创建偏好设置,稍后您将收到通知(指示是否已付款或发生了什么情况)

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

如果您的应用程序将仅使用单个 MercadoPago 账户,则只需使用

account = Account.objects.first()

最后,您可以使用 post_update 钩子实时处理支付通知

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

向后兼容性

版本 2.0.0 大量更改了数据库模式。虽然保留了旧数据,但必须填充一些缺失的字段。自动生成数据将具有负键值,应易于识别。

遗憾的是,无法自动填充这些数据。但是,没有数据丢失。

许可证

本软件基于 ISC 许可证分发。有关详细信息,请参阅 LICENCE。

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

项目详情


下载文件

下载适用于您的平台文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码分发

django-mercadopago-simple-4.1.1.tar.gz (17.9 kB 查看散列)

上传日期 源代码

构建分发

django_mercadopago_simple-4.1.1-py3-none-any.whl (24.1 kB 查看散列)

上传日期 Python 3

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面