开始免费使用
当前位置：首页 > Python > Python实现微信小程序支付全流程指南

Python实现微信小程序支付全流程指南

Cora
Cora
发布时间：2026-10-13| 6人浏览过
原创

本文详细介绍使用Python实现微信小程序支付的完整流程，涵盖获取OpenID、统一下单、支付回调处理及签名验证等核心环节。文中针对常见的签名错误、HTTPS回调问题及资金安全校验提供了具体的代码示例与解决方案，帮助开发者快速完成支付功能集成。

正文

近期在开发小程序支付功能时，整理了一份基于Python的实现流程供参考。在正式编码前，建议先阅读官方文档，明确支付的整体交互逻辑，这有助于避免后续开发中的方向性错误。

1. 支付交互流程

具体的参数配置细节可参考微信支付官方文档：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_3&index=1

2. 获取OpenID（微信用户标识）


 import requests
 from config import APPID, SECRET
 class OpenidUtils(object):
  def __init__(self, jscode):
   self.url = "https://api.weixin.qq.com/sns/jscode2session"
   self.appid = APPID # 小程序id
   self.secret = SECRET # 不要跟后面支付的key搞混
   self.jscode = jscode # 前端传回的动态jscode
  def get_openid(self):
   # url一定要拼接，不可用传参方式
   url = self.url + "?appid=" + self.appid + "&secret=" + self.secret + "&js_code=" + self.jscode + "&grant_type=authorization_code"
   r = requests.get(url)
   print(r.json())
   openid = r.json()['openid']
   return openid

3. 支付请求


# -*- coding:utf-8 -*-
import requests
import hashlib
import xmltodict
import time
import random
import string
import urllib2
import sys
class WX_PayToolUtil():
 """ 微信支付工具 """
 def __init__(self, APP_ID, MCH_ID, API_KEY, NOTIFY_URL):
  self._APP_ID = APP_ID # 小程序ID
  self._MCH_ID = MCH_ID # # 商户号
  self._API_KEY = API_KEY
  self._UFDODER_URL = "https://api.mch.weixin.qq.com/pay/unifiedorder" # 接口链接
  self._NOTIFY_URL = NOTIFY_URL # 异步通知
 def generate_sign(self, param):
   '''生成签名'''
   stringA = ''
   ks = sorted(param.keys())
   # 参数排序
   for k in ks:
    stringA += (k + '=' + param[k] + '&')
   # 拼接商户KEY
   stringSignTemp = stringA + "key=" + self._API_KEY
   # md5加密,也可以用其他方式
   hash_md5 = hashlib.md5(stringSignTemp.encode('utf8'))
   sign = hash_md5.hexdigest().upper()
   return sign
 '''
 # python2另外一种实现方法
 def generate_sign(self, params):
  ret = []
  for k in sorted(params.keys()):
   if (k != 'sign') and (k != '') and (params[k] is not None):
    ret.append('%s=%s' % (k, params[k]))
  params_str = '&'.join(ret)
  params_str = '%(params_str)s&key=%(partner_key)s' % {'params_str': params_str, 'partner_key': key}
  reload(sys)
  sys.setdefaultencoding('utf8')
  params_str = hashlib.md5(params_str.encode('utf-8')).hexdigest()
  sign = params_str.upper()
  return sign
 '''
 def getPayUrl(self, orderid, openid, goodsPrice, **kwargs):
  """向微信支付端发出请求，获取url"""
  key = self._API_KEY
  nonce_str = ''.join(random.sample(string.letters + string.digits, 30)) # 生成随机字符串，小于32位
  params = {
   'appid': self._APP_ID, # 小程序ID
   'mch_id': self._MCH_ID, # 商户号
   'nonce_str': nonce_str, # 随机字符串
   "body": '测试订单', # 支付说明
   'out_trade_no': orderid, # 生成的订单号
   'total_fee': str(goodsPrice), # 标价金额
   'spbill_create_ip': "127.0.0.1", # 小程序不能获取客户ip，web用socekt实现
   'notify_url': self._NOTIFY_URL,
   'trade_type': "JSAPI", # 支付类型
   "openid": openid, # 用户id
   }
  # 生成签名
  params['sign'] = self.generate_sign(params)
  # python3一种写法
  param = {'root': params}
  xml = xmltodict.unparse(param)
  response = requests.post(self._UFDODER_URL, data=xml.encode('utf-8'), headers={'Content-Type': 'text/xml'})
  # xml 2 dict
  msg = response.text
  xmlmsg = xmltodict.parse(msg)
  # 4. 获取prepay_id
  if xmlmsg['xml']['return_code'] == 'SUCCESS':
   if xmlmsg['xml']['result_code'] == 'SUCCESS':
    prepay_id = xmlmsg['xml']['prepay_id']
    # 时间戳
    timeStamp = str(int(time.time()))
    # 5. 五个参数
    data = {
     "appId": self._APP_ID,
     "nonceStr": nonce_str,
     "package": "prepay_id=" + prepay_id,
     "signType": 'MD5',
     "timeStamp": timeStamp,
    }
    # 6. paySign签名
    paySign = self.generate_sign(data)
    data["paySign"] = paySign # 加入签名
    # 7. 传给前端的签名后的参数
    return data
  # python2一种写法
  '''
  request_xml_str = '<xml>'
  for key, value in params.items():
   if isinstance(value, str):
    request_xml_str = '%s<%s><![CDATA[%s]]></%s>' % (request_xml_str, key, value, key,)
   else:
    request_xml_str = '%s<%s>%s</%s>' % (request_xml_str, key, value, key,)
  request_xml_str = '%s</xml>' % request_xml_str
  # 向微信支付发出请求，并提取回传数据
  res = urllib2.Request(self._UFDODER_URL, data=request_xml_str.encode("utf-8"))
  res_data = urllib2.urlopen(res)
  res_read = res_data.read()
  doc = xmltodict.parse(res_read)
  return_code = doc['xml']['return_code']
  if return_code == "SUCCESS":
   result_code = doc['xml']['result_code']
   if result_code == "SUCCESS":
    doc = doc['xml']
    data = {
     "appId": self._APP_ID,
     "nonceStr": nonce_str,
     "package": "prepay_id=" + doc["prepay_id"],
     "signType": 'MD5',
     "timeStamp": str(int(time.time())),
    }
    # paySign签名
    paySign = self.generate_sign(data)
    data["paySign"] = paySign # 加入签名
    return data
   else:
    err_des = doc['xml']['err_code_des']
    return err_des 
  else:
   fail_des = doc['xml']['return_msg']
   return fail_des
  '''

开发中常遇到的错误是签名失败，通常原因是混淆了AppSecret与商户API密钥。若排除此因素，可参考该链接排查其他问题：https://www.jb51.net/article/166176.htm 。

其他支付方式中，若需获取用户IP地址，可通过 socket.gethostbyname(socket.gethostname()) 方法实现。

4. 支付回调


# 统一下单回调处理
import xmltodict
from django.http import HttpResponse
def payback(request):
 msg = request.body.decode('utf-8')
 xmlmsg = xmltodict.parse(msg)
 return_code = xmlmsg['xml']['return_code']
 if return_code == 'FAIL':
  # 官方发出错误
  return HttpResponse("""<xml><return_code><![CDATA[FAIL]]></return_code>
       <return_msg><![CDATA[Signature_Error]]></return_msg></xml>""",
       content_type='text/xml', status=200)
 elif return_code == 'SUCCESS':
  # 拿到这次支付的订单号
  out_trade_no = xmlmsg['xml']['out_trade_no']
  # 根据需要处理业务逻辑
  return HttpResponse("""<xml><return_code><![CDATA[SUCCESS]]></return_code>
       <return_msg><![CDATA[OK]]></return_msg></xml>""",
       content_type='text/xml', status=200)

微信回调包含大量参数，详细规范请参考：https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=9_7&index=8

回调处理时可能遇到支付成功但未触发回调函数的问题。曾遇到一个案例：将回调地址从HTTPS改为HTTP后问题解决。尽管服务器未屏蔽HTTPS且证书正常，但改为HTTP后成功接收回调，具体原因尚不明确。

5. 安全机制

商户系统在接收支付结果通知时，必须进行签名验证，并核对返回的订单金额是否与本地订单金额一致。此举旨在防止因数据泄露导致的“假通知”，从而避免资金损失。

我的解决策略是：在发起微信支付请求时，将订单号、金额及签名等信息存入数据库；在回调函数中再次校验这些信息。只有当回调数据与数据库记录完全一致时，才执行后续业务逻辑。

最后送给大家一段祝福


#         _oo8oo_
#         o8888888o
#         88" . "88
#         (| -_- |)
#         0\ = /0
#        ___/'==='\___
#        .' \\|  |# '.
#       / \\||| : |||# \
#       / _||||| -:- |||||_ \
#       | | \\\ - #/ | |
#       | \_| ''\---/'' |_/ |
#       \ .-\__ '-' __/-. /
#      ___'. .' /--.--\ '. .'___
#      ."" '< '.___\_<|>_/___.' >' "".
#     | | : `- \`.:`\ _ /`:.`/ -` : | |
#     \ \ `-. \_ __\ /__ _/ .-` / /
#    =====`-.____`.___ \_____/ ___.`____.-`=====
#         `=---=`
#
#
#    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#
#

总结

以上为Python实现微信小程序支付功能的详细介绍，希望能为开发者提供帮助。如有疑问欢迎留言，小编会及时回复。感谢大家的支持！ 若本文对您有帮助，欢迎转载，请注明出处，谢谢！

相关文章

相关标签: Python 微信小程序

免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。

作者最新文章

全部文章

Python 相关产品和应用

全部下载
PythonSelenium
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

Python机器学习
scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Python代码质量
Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Python代码质量
Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

Pythonpytest
pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

PythonFastAPI
FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架，支持类型提示和自动接口文档。

PythonFlask
Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

PythonDjango
Django

Django

6.1.2 · Windows

成熟的 Python Web 框架，适合构建内容站点和业务系统。

PythonSpyder
Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

PythonSciPy
SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。