AX3 Mercadopago

AX3 Mercadopago 是一个用于添加 Mercadopago 支付支持的 Django 应用。

安装

AX3 Mercadopago 可以通过 PyPI 包轻松安装。

$ pip install ax3-mercadopago

安装包后，需要配置项目设置。

将 ax3_mercadopago 添加到您的 INSTALLED_APPS

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

    # ax3_mercadopago app can be in any position in the INSTALLED_APPS list.
    'ax3_mercadopago',
]

配置

添加 mercadopago 设置

# app/settings.py

MERCADOPAGO_REFERENCE_PREFIX = ''  # Prefix for Mercadopago external reference 
MERCADOPAGO_PAYMENT_MODEL = ''  # Path to payment model
MERCADOPAGO_PAID_USECASE = ''  # Path to use case for paid payments
MERCADOPAGO_REJECTED_USECASE = ''  # Path to use case for rejected payments

# For Marketplace
# https://www.mercadopago.com.co/developers/es/guides/online-payments/marketplace/checkout-pro/introduction
MERCADOPAGO_MARKETPLACE_SELLER = True
MERCADOPAGO_MARKETPLACE_APP_ID = ''
MERCADOPAGO_MARKETPLACE_REDIRECT_URI = ''  

在应用 URL 中设置 ax3_mercadopago

# app/urls.py
urlpatterns = [
    path('admin/', admin.site.urls),

    # Add this line
    path('mercadopago/', include('ax3_mercadopago.urls', namespace='mercadopago')),
]

在您的支付模型中使用 PaymentModelMixin

class Payment(PaymentModelMixin):

实用工具

在 shell_plus 中获取卖家令牌请求 URI

from ax3_mercadopago.api import AX3Client

mp = AX3Client()
mp.marketplace_tokens.get_auth_uri()
# response
https://auth.mercadopago.com.co/authorization?client_id=&redirect_uri=https%3A%2F%2Fclientes-staging.takami.co&response_type=code&platform_id=mp

要在 shell_plus 中创建卖家令牌，请使用

from app.mercadopago import create_seller_token

brand = Brand.objects.first()
create_seller_token(code='SELLER-CODE', brand=brand)

发布新版本

请确保增加版本号并创建 git 标签

$ python3 -m pip install --user --upgrade setuptools wheel twine
$ ./release.sh