MercadoPago集成django
项目描述
从4.2.0版本开始,此包将在PyPI中重命名为django-mercadopago。请更新您的引用。 导入和模块保持不变。
django-mercadopago-simple 是一个简单的django应用,用于与MercadoPago交互,旨在保持简单,仅覆盖基本的使用场景。
特性
我们的意图不是涵盖上游API的所有功能,而是提供一个简单的应用程序,允许接受和跟踪支付。这对于简单的网站,如购物车、在线销售等应该足够了。
欢迎提交拉取请求。如果您遇到问题,请不要犹豫,提出问题。新功能通常只有在需要时才会添加,但如果您提交了补丁,也会被接受。
安装
通常应通过pip进行安装
pip install django-mercadopago-simple
配置
您需要从此处获取您的API凭据(app id 和 secret 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 的散列
算法 | 散列摘要 | |
---|---|---|
SHA256 | 3c715118717aca4ec1ed2738cfb5f6c1d50f7925a6ade79d5a630063935796ee |
|
MD5 | 1196cccabad80dde11c6fb0162ef919f |
|
BLAKE2b-256 | 2cebbe50192c9a7f17277a99f4e9d5d75cedfcc4556a781975a9599190ef1ce1 |
哈希值 for django_mercadopago_simple-4.1.1-py3-none-any.whl
算法 | 散列摘要 | |
---|---|---|
SHA256 | 0e437162364448a0d531ce6f72aef9dfe60c321cba6f00b521c36b63403701a9 |
|
MD5 | 8687b93e237a2f3e7647a24d785198a1 |
|
BLAKE2b-256 | 49d377839d4886cb99e4523731d59644accd6e164c66793a67d82646aea71651 |