django-oscar-docdata 1.3.3

配置

配置应用程序

DOCDATA_MERCHANT_NAME

支付提供商提供的凭据。

DOCDATA_MERCHANT_PASSWORD

支付提供商提供的凭据。

DOCDATA_PROFILE

在Docdata后台办公室创建的支付方式配置文件。默认名称为“标准”。

DOCDATA_TESTING

是否以测试模式运行。默认为 True。

添加到 urls.py

from oscar_docdata.dashboard.app import application as docdata_dashboard_app

urlpatterns += [
    url(r'^api/docdata/', include('oscar_docdata.urls')),
    url(r'^dashboard/docdata/', include(docdata_dashboard_app.urls)),
]

添加到 settings.py

OSCAR_DASHBOARD_NAVIGATION[2]['children'].insert(1, {
    'label': _('Docdata Orders'),
    'url_name': 'docdata-order-list',
})

在开发过程中，建议启用 suds 和 oscar_docdata 的日志记录功能以查看详细信息

LOGGING = {
    # ...
    'loggers': {
        # ...
        'suds.transport': {
            'handlers': ['console'],
            'level': 'DEBUG',
            'propagate': True,
        },
        'oscar_docdata': {
            'handlers': ['mail_admins', 'console'],
            'level': 'DEBUG',
            'propagate': True,
        },
    },
}

集成到您的项目中

请查看 沙箱应用程序 了解如何集成应用程序。这包括特定于项目的决策，例如

• 如何创建支付事件。

• 如何创建自定义外观类

• 将哪些字段映射到“门牌号”字段。（例如 line2、line3 或自定义字段）。

• 当客户取消支付时是否取消订单。

• 何时提交确认电子邮件。

本地开发和运行测试

您可以使用包含的 Makefile 安装开发环境并运行 flake8 检查器和测试运行器。请确保在虚拟环境中执行此操作

git clone git@github.com:django-oscar/django-oscar-docdata.git

cd django-oscar-docdata
make install
make lint
make test

运行沙箱应用程序

可以运行 沙箱应用程序 以测试此包并查看您的 Docdata 凭证是否有效。在运行 manage.py 之前，您可以设置 DOCDATA_MERCHANT_NAME、DOCDATA_MERCHANT_PASSWORD 和 DOCDATA_PROFILE 环境变量

# creates a local sqlite database
./sandbox/manage.py migrate

# loads some sample products (books)
./sandbox/manage.py oscar_import_catalogue sandbox/fixtures/books.csv

# so you can fill out your shipping address
./sandbox/manage.py loaddata sandbox/fixtures/countries.json

# run the sandbox installation with the docdata merchant username, password and profile
DOCDATA_MERCHANT_NAME=merchant DOCDATA_MERCHANT_PASSWORD=merchant DOCDATA_PROFILE=test ./sandbox/manage.py runserver

Docdata 非常希望拥有唯一的商家订单 ID。原因不是很清楚，因为他们没有使用这些参考（他们使用自己的）。为了避免冲突，沙箱应用程序添加了当前日期时间作为前缀。

Docdata 的支付菜单允许您选择可用的支付方式，因此您不需要在结账应用程序中包含它。您可以使用以下环境变量禁用沙箱支付方式选择

SKIP_PAYMENT_CHOICES=1

配置 Docdata 后台办公室

请确保以下设置已配置

• “支付方式名称”需要添加到配置文件中（DOCDATA_PROFILE 的默认值是“标准”）。

• 需要设置通知 URL 和返回 URL。示例值

• 成功：http://example.org/api/docdata/update_order/?callback=SUCCESS&order_id=

• 已取消：http://example.org/api/docdata/update_order/?callback=CANCELLED&order_id=

• 错误：http://example.org/api/docdata/update_order/?callback=ERROR&order_id=

• 挂起：http://example.org/api/docdata/update_order/?callback=PENDING&order_id=

• 更新 URL：http://example.org/api/docdata/update_order/?order_id=

Docdata 支付服务规范

有关详细技术信息，请参阅 支付服务 规范。