Django集成微信小程序支付完整指南

Aria

发布时间：2026-10-14| 6人浏览过

原创

本文详细介绍如何在Django项目中集成微信小程序支付功能。内容涵盖安装wechatpy库、配置小程序与商户参数、创建Django应用、编写视图处理登录凭证与支付请求，以及配置URL路由。通过具体代码示例，展示如何获取openid、统一下单及处理支付回调，帮助开发者快速实现支付闭环。

环境配置与依赖安装

准备工作：安装必要的依赖库。

微信官方提供了便捷的开发者SDK，可通过pip命令进行安装：


pip install wechatpy

接下来，在项目根目录下的settings.py文件中添加微信支付相关的配置信息。

具体的配置参数（如APPID、商户号等）需要登录微信小程序微信公众平台和微信商户平台获取。


WECHAT = {
    'APPID': 'appid',               # 小程序ID
    'APPSECRET': 'appsecret',			# 小程序SECRET
    'MCH_ID': 'mch_id',                   # 商户号
    'TOTAL_FEE': '1',                      # 总金额， 单位为“分”
    'SPBILL_CREATE_IP': '127.0.0.1',              # 终端IP
    'NOTIFY_URL': 'http://127.0.0.1:8000/wechat/payNotify/',     # 通知地址
    'TRADE_TYPE': 'JSAPI',                   # 交易类型
    'MERCHANT_KEY': 'merchant_key',     # 商户KEY
    'BODY': '商品描述',                # 商品描述
}

Django应用创建与配置

在Django项目中创建一个新的应用（app）来处理支付逻辑。

例如，这里新建的应用名称为Pay。
确保在settings.py文件的INSTALLED_APPS列表中注册刚才新建的应用。

支付视图逻辑实现

编写该应用的视图文件views.py，实现支付核心逻辑。


from django.http import HttpResponse
import requests
import json
from django.conf import settings
from wechatpy.pay import WeChatPay
from app_base.base_viewset import BaseAPIView
from rest_framework import permissions
from lxml import etree as et
from rest_framework import status


class WeChatPayViewSet(BaseAPIView):
  """
  通过小程序前端 wx.login() 接口获取临时登录凭证 code
  将 code 作为参数传入，调用 get_user_info() 方法获取 openid
  """

  def get_user_info(self, js_code):
    """
    使用 临时登录凭证code 获取 session_key 和 openid 等
    支付部分仅需 openid，如需其他用户信息请按微信官方开发文档自行解密
    """
    req_params = {
      'appid': settings.WECHAT['APPID'],
      'secret': settings.WECHAT['APPSECRET'],
      'js_code': js_code,
      'grant_type': 'authorization_code',
    }
    user_info = requests.get('https://api.weixin.qq.com/sns/jscode2session',
                 params=req_params, timeout=3, verify=False)
    return user_info.json()

  def get(self, request):
    code = request.GET.get("code", None)
    openid = self.get_user_info(code)['openid']

    pay = WeChatPay(settings.WECHAT['APPID'], settings.WECHAT['MERCHANT_KEY'], settings.WECHAT['MCH_ID'])
    order = pay.order.create(
      trade_type=settings.WECHAT['TRADE_TYPE'], # 交易类型，小程序取值：JSAPI
      body=settings.WECHAT['BODY'], # 商品描述，商品简单描述
      total_fee=settings.WECHAT['TOTAL_FEE'], # 标价金额，订单总金额，单位为分
      notify_url=settings.WECHAT['NOTIFY_URL'], # 通知地址，异步接收微信支付结果通知的回调地址，通知url必须为外网可访问的url，不能携带参数。
      user_id=openid # 用户标识，trade_type=JSAPI，此参数必传，用户在商户appid下的唯一标识。
    )
    wxpay_params = pay.jsapi.get_jsapi_params(order['prepay_id'])
    return HttpResponse(json.dumps(wxpay_params))


class WeChatPayNotifyViewSet(BaseAPIView):
  permission_classes = (permissions.AllowAny, )

  def get(self, request):
    _xml = request.body
    # 拿到微信发送的xml请求 即微信支付后的回调内容
    xml = str(_xml, encoding="utf-8")
    print("xml", xml)
    return_dict = {}
    tree = et.fromstring(xml)
    # xml 解析
    return_code = tree.find("return_code").text
    try:
      if return_code == 'FAIL':
        # 官方发出错误
        return_dict['message'] = '支付失败'
        # return Response(return_dict, status=status.HTTP_400_BAD_REQUEST)
      elif return_code == 'SUCCESS':
        # 拿到自己这次支付的 out_trade_no
        _out_trade_no = tree.find("out_trade_no").text
        # TODO 这里省略了 拿到订单号后的操作 看自己的业务需求
    except Exception as e:
      pass
    finally:
      return HttpResponse(return_dict, status=status.HTTP_200_OK)

首先定义一个基础视图类，用于处理权限验证等通用逻辑：


# -*- coding: utf-8 -*-
from rest_framework.authentication import TokenAuthentication
from rest_framework.views import APIView
from rest_framework import permissions

__author__ = 'JayChen'


class BaseAPIView(APIView):
  permission_classes = (permissions.IsAuthenticated,)
  # authentication_classes = (TokenAuthentication,)

为Pay应用创建urls.py文件，并配置相应的URL路由规则。


# -*- coding: utf-8 -*-

__author__ = 'JayChen'

from django.conf.urls import url
from rest_framework.urlpatterns import format_suffix_patterns
from pay import views

app_name = 'pay'
urlpatterns = [
  # 微信小程序支付
  url(r'^pay/', views.WeChatPayViewSet.as_view(), name='pay'),
  # 支付结果回调
  url(r'^payNotify/', views.WeChatPayNotifyViewSet.as_view(), name='pay_notify'),
]

最后，在项目的总urls.py文件中引入上述新增的Pay应用路由。


from django.contrib import admin
from django.urls import path, include
from rest_framework_jwt.views import obtain_jwt_token

urlpatterns = [
  path('admin/', admin.site.urls),
  path('token_auth/', obtain_jwt_token, name='jwt_token'),
  path('user/', include('auth_jwt.urls')),
  
  path('wechat/', include('pay.urls')), # 微信支付相关
]

URL路由配置与调试

完成上述配置后，进行本地调试以验证支付流程。

微信小程序在用户登录后会获取一个临时登录凭证code，需将此code作为参数发送给Django后端：例如请求地址为：http://0.0.0.0:8000/wechat/pay/?code=033h0P0w3ANPRU2ntl0w36HHyy1h0P08

需要注意，该code具有时效性，每次登录都会生成新的code，且旧code使用后即失效。

后端处理成功后返回的数据结构如下：


{
  "appId": "wx14b75285dfe1",
  "timeStamp": "1595228",
  "nonceStr": "1Wtu5lKb6T3fJLiNzc09ay2Z",
  "signType": "MD5",
  "package": "prepay_id=wx02158826854686197390000",
  "paySign": "89599A11E051D3B20FF57"
}

小程序前端获取到上述返回数据后，即可调用微信JSAPI唤起支付界面。

至此，Django实现微信小程序支付的核心流程介绍完毕。如需了解更多相关内容，建议查阅本站过往文章或关注后续更新，感谢支持。