django-payments-payu 1.5.0

文档

完整文档位于 https://django-payments-payu.readthedocs.io。

快速入门

安装 django-payments 并根据 django-payments 文档 设置PayU支付提供商后端。

此后端实现使用 PayU.com 进行支付。

设置支付提供商

示例

# use sandbox
PAYMENT_VARIANTS = {
    'payu': ('payments_payu.provider.PayuProvider', {
        'pos_id': '123456',
        'second_key': 'iseedeadpeople',
        'client_secret': 'peopleiseedead',
        'sandbox': True,
        'capture': False,
        'get_refund_description': lambda payment, amount: 'My refund',
        'get_refund_ext_id': lambda payment, amount: str(uuid.uuid4()),
    }),
}

以下是提供者的有效参数

client_secret:

PayU OAuth协议客户端密钥

pos_id:

PayU POS ID

second_key:

PayU第二个密钥（MD5）

shop_name:

发送到API的商店名称

sandbox:

如果 True，则将端点设置为沙盒

endpoint:

端点URL，如果未设置，将根据 sandbox 设置自动设置

recurring_payments:

启用周期性支付，仅当 express_payments=True 时有效，以下为其他所需的设置

express_payments:

使用 PayU 快速表单

widget_branding:

指示快速表单显示 PayU 品牌信息

store_card:

(默认：False) PayU 是否应存储卡片

get_refund_description:

一个可选的可调用对象，当调用 provider.refund(payment, amount) 时，会使用两个关键字参数 payment 和 amount 来获取特定退款字符串描述。由于向后兼容性，该可调用对象是可选的。然而，如果没有设置，尝试退款将引发异常。已弃用的 get_refund_description 默认值。

get_refund_ext_id:

一个可选的可调用对象，当调用 provider.refund(payment, amount) 时，会使用两个关键字参数 payment 和 amount 来获取特定退款的外部字符串退款 ID。如果返回 None，则不设置外部退款 ID。如果不会执行超过每秒一次的部分退款，则不需要外部退款 ID。否则，建议使用唯一 ID，因为 PayuProvider.refund 是幂等的，如果提供了完全相同的数据，它将返回之前已执行退款的 结果而不是执行新的退款。默认为标准形式下的随机 UUID 版本 4。

注意：请将来自 PayU 的支付状态通知请求发送到 django-payments process_payment url。PayU 的请求可能因多种原因失败（例如，可能被代理阻止）。请使用 PayU 管理中的“显示报告”页面以获取有关请求的更多信息。

周期性支付:

如果启用了周期性支付，PayU 卡令牌需要存储在您的应用程序中以供下一次支付使用。下一次支付可以由用户通过（用户将被快速表单提示进行支付确认）或服务器发起。要启用周期性支付，您需要设置其他一些内容

注意：即使在沙盒中，周期性支付默认也是未启用的，您应该咨询他们的帮助台以启用此功能。

• 为了使支付周期性，需要为 Payment 的用户（而不仅仅是支付本身）存储卡令牌。实现 Payment.set_renew_token() 和 Payment.get_renew_token()。

• 实现 Payment.get_payment_url()。

• 对于由服务器发起的周期性支付，您需要创建新的支付并调用 payment.auto_complete_recurring()。

  • 该方法返回字符串 'success' 或用户可以提供其 CVV2 或 3D 安全信息的 URL。

  • 字符串 'success' 表示，支付正在等待来自 PayU 的通知，但不需要进一步的用户操作。

触发周期性支付示例

payment = Payment.objects.create(...)
redirect_url = payment.auto_complete_recurring()
if redirect_url != 'success':
    send_mail(
        'Recurring payment - action required',
        'Please renew your CVV2/3DS at %s' % redirect_url,
        'noreply@test.com',
        [user.email],
        fail_silently=False,
    )

运行测试

代码是否真的起作用？

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install tox
(myenv) $ tox

致谢

用于渲染此包的工具

• Cookiecutter

• cookiecutter-djangopackage

历史记录