这一篇教程,我们一起通过使用支付宝官方的SDK实现支付和支付结果验证。
一、准备工作
在正式开始之前,需要做一些准备,包括:
1、生成RSA密钥:https://docs.open.alipay.com/291/105971/
密钥格式选择“PKCS1(非Java适用)”,密钥长度选择“2048”。
2、设置沙箱环境:https://openhome.alipay.com/platform/appDaily.htm
复制保存“APPID”和“支付网关”信息,然后,将上一步生成的应用公钥填入,并将支付宝公钥也复制保存。
除以上设置外,其他无需设置。
沙箱环境是开发过程中可以反复测试使用的虚拟支付环境,开发完成后,在生产环境中将APPID和支付宝网关改为实际应用APPID以及支付宝正式网关即可。
3、手机安装支付宝APP(沙箱版)
沙箱环境页面点击“沙箱工具”,下载安装沙箱钱包,用于扫码支付测试。
下载地址:https://sandbox.alipaydev.com/user/downloadApp.htm
或者扫描二维码安装:
在沙箱环境页面再点击“沙箱账号”,根据买家信息中的账号、登录密码登录沙箱钱包,别忘了给沙箱钱包输入金额进行充值。
完成以上准备之后,接下来我们正式开始支付宝接口的调用。
二、安装官方SDK
支付宝官方在2018年5月23日,发布了一个Python版的SDK(公测版),之后在2018年7月20日发布了正式版(3.1.6)。
本文基于正式版为大家进行介绍。
我们可以通过“pip”命令进行安装。
不过这个SDK依赖Pycrypto,所以建议先进行Pycrypto的安装。
pip install pycrypto
如果是Windows系统,到这里可能安装出错了,可能出现的错误如下:
解决这些错误,需要安装Visual Studio 2015。
下载地址:https://pan.baidu.com/s/1Bz8zB2et71xxyTaCUuU36A
下载之后,双击进行安装,在组件选择页面我们只选择需要的组件。
因为,我们只是下载了安装器,勾选组件之后,安装器会下载相应的组件进行安装,不过即便这样安装过程也非常漫长。
完成安装之后,我们进行环境变量中用户变量(不是系统变量)的设置。
变量名称:VCINSTALLDIR
变量值:C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC
接下来,打开cmd,执行如下命令:
set CL=/FI"%VCINSTALLDIR%\\INCLUDE\\stdint.h" %CL%
注意:如果是虚拟环境,请在虚拟环境的命令行中输入此命令,并且命令中的符号都是英文半角的,网上有的资料中引号是中文符号,导致仍然无法安装Pycrypto(我特么就是受害者…)。
如果还报错误“src/winrand.c: fatal error C1083: Cannot open include file: ‘%VCINSTALLDIR%\\INCLUDE\\stdint.h’: No such file or directory”,可以尝试把命令改为绝对路径。
先通过“set CL=
”命令,将已有设置清空。
然后,执行命令:
set CL=/FI"C:\\Program Files (x86)\\Microsoft Visual Studio 14.0\\VC\\\INCLUDE\\stdint.h" %CL%
完成上述步骤之后,重新执行安装Pycrypto的命令,就应该不出什么问题了。
继续安装alipay-sdk-python。
pip install alipay-sdk-python
安装过程中会自动安装一些依赖项,如果上面没有安装Pycrypto,此时也会自动进行安装。
三、使用Django2创建支付项目
1、创建一个模板用于提交订单。
示例代码:(buy.html)
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>结算</title> </head> <body> <form action="../to_pay/" method="get"> <p>商品:Python 入门视频</p> <input type="hidden" name="goods_name" value="Python 入门视频"> <p>价格:¥29.00</p> <input type="hidden" name="price" value="29.00"> 数量:<input type="number" name="quantity" value="3"> <p><input type="submit"></p> </form> </body> </html>
2、添加URL配置
这里需要3个URL,分别用于打开购买页面、唤起支付页面和回调通知验签
示例代码:(urls.py)
path('buy/', site_view.buy), # 打开购买页面 path('to_pay/', site_view.to_pay), # 唤起支付页面 path('pay_result/', site_view.pay_result), # 回调通知验签
3、添加相关设置
示例代码:(settings.py)
ALLOWED_HOSTS = ['*'] # 外网访问需设置,填写域名或服务器IP地址,“*”表示允许所有访问(不建议生产环境使用)。 INSTALLED_APPS = [ ...省略部分代码... 'website', ] MIDDLEWARE = [ ...省略部分代码... # 'django.middleware.csrf.CsrfViewMiddleware', # 注释这一行 ...省略部分代码... ] # APPID ALIPAY_APPID = "2016*********590" # 沙箱APPID,生产环境须更改为应用APPID。 # 网关 ALIPAY_URL = "https://openapi.alipaydev.com/gateway.do" # 沙箱网关,生产环境须更改为正式网关。 # ALIPAY_URL = "https://openapi.alipay.com/gateway.do" # 正式网关,开发环境勿使用。 # 回调通知地址 # ALIPAY_NOTIFY_URL = "http://127.0.0.1:8888/pay_result/" # 如果只可以内网访问开发服务器 ALIPAY_NOTIFY_URL = "http://1.203.45.678:8888/pay_result/" # 如果生产环境或外网可以访问开发服务器 ALIPAY_RETURN_URL = "http://1.203.45.678:8888/pay_result/" # return_url可以单独设置,本文中保持一致。 # 使用密钥文件 APP_PRIVATE_KEY_PATH = os.path.join(BASE_DIR, 'website/keys/app_private_key.txt') ALIPAY_PUBLIC_KEY_PATH = os.path.join(BASE_DIR, 'website/keys/alipay_public_key.txt') # 使用密钥字符串 APP_PRIVATE_KEY = 'MIIEowIBAAKCAQEA0v793k1...省略...' # 应用私钥 ALIPAY_PUBLIC_KEY = 'MIIBIjANBgkqhkiG9w0BAQEFAA...省略...' # 支付宝公钥
在上方设置中,回调通知地址需要视网络状况而决定。
如果启动开发服务器之后,通过外网IP(百度搜索“IP”即可看到)可以进行访问,就使用外网地址。
如果只能通过内网访问,那就只能使用本机地址。
一般来说,外网不能访问可以尝试按以下方法解决。
(1)联系宽带服务商,要求转为公网IP。服务商一般不会拒绝这个要求,只是需要等待1~2天。
(2)为无线路由器设置端口转发(端口映射)或者开启DMZ功能。
4、定义打开购买页面的视图函数
示例代码:(views.py)
from django.shortcuts import render
def buy(request): return render(request, 'buy.html')
5、定义唤起支付页面的视图函数
示例代码:(views.py)
from django.shortcuts import HttpResponseRedirect from alipay.aop.api.AlipayClientConfig import AlipayClientConfig # 客户端配置类 from alipay.aop.api.DefaultAlipayClient import DefaultAlipayClient # 默认客户端类 from alipay.aop.api.domain.AlipayTradePagePayModel import AlipayTradePagePayModel # 网站支付数据模型类 from alipay.aop.api.request.AlipayTradePagePayRequest import AlipayTradePagePayRequest # 网站支付请求类 from myproject import settings import random
def to_pay(request): alipay_client_config = AlipayClientConfig() # 创建配置对象 alipay_client_config.server_url = settings.ALIPAY_URL # 网关 alipay_client_config.app_id = settings.ALIPAY_APPID # APPID alipay_client_config.app_private_key = settings.APP_PRIVATE_KEY # 应用私钥 client = DefaultAlipayClient(alipay_client_config=alipay_client_config) # 使用配置创建客户端 model = AlipayTradePagePayModel() # 创建网站支付模型 model.out_trade_no = 'order_%s' % random.randrange(100000, 999999) # 商户订单号码 model.total_amount = int(request.GET['quantity']) * float(request.GET['price']) # 支付总额 model.subject = request.GET['goods_name'] # 订单标题 model.body = '一套完整详细的Python入门视频。' # 订单描述 model.product_code = 'FAST_INSTANT_TRADE_PAY' # 与支付宝签约的产品码名称,目前只支持这一种。 model.timeout_express = '30m' # 订单过期关闭时长(分钟) pay_request = AlipayTradePagePayRequest(biz_model=model) # 通过模型创建请求对象 pay_request.notify_url = settings.ALIPAY_NOTIFY_URL # 设置回调通知地址(POST) pay_request.return_url = settings.ALIPAY_RETURN_URL # 设置回调通知地址(GET) response = client.page_execute(pay_request, http_method='GET') # 获取支付链接 return HttpResponseRedirect(response) # 重定向到支付宝支付页面
上方代码中,支付模型负责组织支付链接参数,包括公共参数和请求参数。
所有参数可以参考官方文档:https://docs.open.alipay.com/270/alipay.trade.page.pay
完成以上代码后,如果没有问题,已经可以在购买页面点击提交按钮打开支付宝付款页面了。
6、定义检查支付结果的函数
当我们使用沙箱钱包扫码完成支付,如果设置了回调通知地址,此时支付宝会有两个回调通知:同步通知和异步通知。
不同的是:
不管是同步通知还是异步通知,我们都需要对通知中的签名(sign)进行校验,以确认该通知来自支付宝,保障信息安全。
在支付宝SDK中,为我们提供了验签的函数,我们只需要组织参数进行验签。
因为,两种回调通知的验签参数处理过程都是一样的,只是参数分别来自于GET和POST,所以我们可以只定义1个检查支付结果的函数。
参考官方的验签过程,取出的回调参数后,必须经过以下处理。
示例代码:(views.py)
from alipay.aop.api.util.SignatureUtils import verify_with_rsa
def check_pay(params): # 定义检查支付结果的函数 sign = params.pop('sign', None) # 取出签名 params.pop('sign_type') # 取出签名类型 params = sorted(params.items(), key=lambda e: e[0], reverse=False) # 取出字典元素按key的字母升序排序形成列表 message = "&".join(u"{}={}".format(k, v) for k, v in params).encode() # 将列表转为二进制参数字符串 # with open(settings.ALIPAY_PUBLIC_KEY_PATH, 'rb') as public_key: # 打开公钥文件 try: # status =verify_with_rsa(public_key.read().decode(),message,sign) # 验证签名并获取结果 status = verify_with_rsa(settings.ALIPAY_PUBLIC_KEY.encode('utf-8').decode('utf-8'), message, sign) # 验证签名并获取结果 return status # 返回验证结果 except: # 如果验证失败,返回假值。 return False
7、创建不同回调方式的响应结果
同步通知的响应结果,我们需要返回内容到页面。
异步通知的响应结果,我们需要返回内容到支付宝服务器。
这里特别注意,异步通知如果没有向支付宝返回字符串“success”的话,会在一定时间内不停的发起回调请求,直到超出时限或者接收到字符串“success”为止。
示例代码:(views.py)
from django.shortcuts import HttpResponse
def pay_result(request): # 定义处理回调通知的函数 if request.method == 'GET': params = request.GET.dict() # 获取参数字典 if check_pay(params): # 调用检查支付结果的函数 ''' 此处编写支付成功后的业务逻辑 ''' return HttpResponse('支付成功!') else: ''' 此处编写支付失败后的业务逻辑 ''' return HttpResponse('支付失败!') if request.method == 'POST': params = request.POST.dict() # 获取参数字典 if check_pay(params): # 调用检查支付结果的函数 ''' 此处编写支付成功后的业务逻辑 ''' # print('支付成功!') return HttpResponse('success') # 返回成功信息到支付宝服务器 else: ''' 此处编写支付失败后的业务逻辑 ''' return HttpResponse('')
项目源代码下载:【点此下载】
本文链接:http://so.lmcjl.com/news/2168/