当前位置：首页 > news >正文

Django-Oscar支付网关集成终极指南：支持多种支付方式的完整解决方案

news 2026/5/12 17:35:28

Django-Oscar支付网关集成终极指南：支持多种支付方式的完整解决方案

【免费下载链接】django-oscardjango-oscar/django-oscar: 是一个基于 Django 的电子商务框架，可以用于快速开发和部署电子商务网站，提供了多种电子商务功能和插件扩展。项目地址: https://gitcode.com/gh_mirrors/dj/django-oscar

Django-Oscar作为基于Django的电子商务框架，提供了灵活强大的支付网关集成能力，帮助开发者快速构建支持多种支付方式的电商网站。本文将详细介绍如何在Django-Oscar中集成支付网关，从基础配置到高级定制，让你轻松掌握支付系统的实现方法。

为什么选择Django-Oscar进行支付集成？

Django-Oscar的支付系统设计具有高度的灵活性和可扩展性，主要优势包括：

多支付源支持：允许订单通过多种支付方式组合完成支付
完整的支付跟踪模型：提供SourceType、Source和Transaction三个核心模型跟踪支付流程
灵活的扩展点：通过自定义PaymentDetailsView实现各种支付逻辑
异常处理机制：内置多种支付异常类型，如支付取消、支付失败等

图1：Django-Oscar购物车页面，显示了商品、价格和结账按钮，是支付流程的起点

支付系统核心模型解析

Django-Oscar的支付模块提供了三个关键模型来跟踪支付信息：

SourceType模型

用于定义支付来源类型，如PayPal、信用卡、银行转账等。在项目初始化时，你需要为每个使用的支付网关创建对应的SourceType。

from oscar.core.loading import get_model SourceType = get_model('payment', 'SourceType') SourceType.objects.create(name='PayPal') SourceType.objects.create(name='Credit Card')

Source模型

跟踪单个订单的支付来源，记录分配金额、借记金额和退款金额，支持两阶段支付模型（预授权和结算）。

Transaction模型

记录支付来源的每笔交易，提供完整的支付审计跟踪。

快速集成支付网关的步骤

1. 准备工作

首先确保已安装Django-Oscar，并创建了基本的电商网站结构。如果还没有设置项目，可以通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/dj/django-oscar

2. 自定义PaymentDetailsView

支付集成的核心是重写PaymentDetailsView类的handle_payment方法，该方法负责与支付网关交互并记录支付信息。

from oscar.apps.checkout import views from oscar.apps.payment import models class PaymentDetailsView(views.PaymentDetailsView): def handle_payment(self, order_number, total, **kwargs): # 与支付网关交互的代码 reference = gateway.pre_auth(order_number, total.incl_tax, kwargs['bankcard']) # 创建支付来源 source_type, __ = models.SourceType.objects.get_or_create(name="PaymentGateway") source = models.Source( source_type=source_type, amount_allocated=total.incl_tax, reference=reference ) self.add_payment_source(source) # 记录支付事件 self.add_payment_event('pre-auth', total.incl_tax)

3. 处理支付异常

Django-Oscar定义了多种支付异常类型，帮助你优雅地处理支付过程中可能出现的问题：

RedirectRequired：需要重定向到第三方支付页面时使用
UnableToTakePayment：处理预期的支付问题，如无效的银行卡号
UserCancelled：用户取消支付流程时使用
PaymentError：处理意外的支付错误，如网关无响应

支持多种支付方式的实现

集成PayPal

Django-Oscar有专门的扩展库django-oscar-paypal，提供了PayPal快速集成方案。你可以参考该扩展的沙箱示例实现PayPal支付：

PayPal集成示例

集成货到付款（COD）

对于不需要在线支付的场景，可以集成货到付款方式。首先创建对应的SourceType：

from oscar.core.loading import get_model SourceType = get_model('payment', 'SourceType') SourceType.objects.create(name='Cash on delivery')

然后自定义PaymentMethodView实现跳过在线支付步骤：

from django.shortcuts import redirect from django.urls import reverse from oscar.apps.checkout import views class PaymentMethodView(views.PaymentMethodView): def form_valid(self, form): payment_method = form.cleaned_data["payment_method"] self.checkout_session.pay_by(payment_method.code) if payment_method.code == 'cash-on-delivery': return redirect(reverse("checkout:preview")) return super().form_valid(form)

支付流程中的高级定制

支持多阶段支付

Django-Oscar支持复杂的订单处理流程，包括分阶段支付。你可以通过重写EventHandler类来处理不同阶段的支付事件：

from oscar.apps.order.processing import EventHandler class CustomEventHandler(EventHandler): def handle_payment_event(self, order, event_type, amount, **kwargs): # 自定义支付事件处理逻辑 super().handle_payment_event(order, event_type, amount, **kwargs)

实现支付附加费

某些支付方式可能需要收取额外费用，你可以通过自定义计算逻辑实现：

def calculate_surcharge(self, basket, **kwargs): payment_method_code = kwargs.get("payment_method_code") if payment_method_code == "paypal": return basket.total_incl_tax * Decimal('0.03') # 3%的PayPal手续费 return Decimal('0.00')