支付宝即时到帐接口的python实现，示例采用django框架

向右看齐 2022-07-15 00:28 140阅读 0赞

因工作需要研究了支付宝即时到帐接口，并成功应用到网站上，把过程拿出来分享。

即时到帐只是支付宝众多商家服务中的一个，表示客户付款，客户用支付宝付款，支付宝收到款项后，马上通知你，并且此笔款项与交易脱离关系，商家可以马上使用。

即时到帐只对企业客户服务，注册成功企业账号以后，申请签约即时到帐产品，大约3-5个工作日后，签约成功，可以马上进入集成产品阶段。

这个是支付宝提供的接口，有asp，c\#，[Java][]，[PHP][]四种语言的，每种语言提供GBK和UTF-8两种方案。另带一份支付宝的文档，这份文档我感觉本来简单的事情越说越麻烦了。

http://download.alipay.com/public/api/base/alipaydirect.zip

网上搜了一下，发现[Python][]接口有几个现成的方案。

https://github.com/fengli/alipay\_python

这两个是一个，代码我还没看，写文档的时候发现的。  
https://github.com/lxneng/alipay

https://pypi.python.org/pypi/alipay/0.2.2

支付宝即时到帐交易过程。

商家：是指支付宝的企业客户。也就是你集成服务单位。

终端消费者：是指在网上购物的消费者，你集成服务单位的客户。

1、终端消费者在商家网站选择商品，下订单。

2、商家把支付信息，get到支付宝指定的链接。

3、终端消费者在支付宝的网站上操作付款。

4、付款成功后，支付宝post付款成功的信息到商家预先提供的地址。

5、支付宝在终端消费者付款成功后三秒后，通过get跳回商家指定的链接。

第4步跟终端消费者操作付款的跳转无关，所以被称为异步通知。这一步，支付宝期待你返回'success'，如果你不返回'success'，支付宝会于4分钟后再次post付款成功的信息，此后每10分钟post一次，至少30分钟内如此。如果终端消费者付款失败，异步通知不会发生。

通过集成，我知道为什么终端消费者付款成功后要等3秒后跳转回商家页面了，因为它要等异步通知的信息先到达，先处理订单，再带终端消费者回到客户的界面，这样就可以看到支付成功的页面了。当然付款失败，异步通知不发生，订单状态没有改变，终端消费者就只能看到付款失败的信息。

了解了支付过程，开始设计程序。

1、生成商品订单。终端消费者选择商品生成商品订单。ID号要唯一，这个唯一不是要你采用UUID，而是跟支付宝往来过程唯一即可，从1递增也可以，只是终端消费者能看到这个id，所以最好采用固定长度的字符串，终端消费者如果知道自己是第一个客户，会不会心里发怵？后面会谈到，为了安全不仅不能用递增，而且至少要6位随机码以上。

2、选择支付方式。因为我们仅仅集成了即时到帐，所以只有支付宝付款一个选项。把支付方式加入订单信息，同时把订单id post到下一步地址，这一步post，最好采用新开页面，本页面弹出对话框，让客户自己选择支付成功或者支付失败。

3、发送支付信息。根据post过来的订单号组合信息，get方式发送数据给支付宝，同时带动终端消费者页面跳转到支付宝支付页面。

4、接受异步通知。

5、支付成功后支付宝跳转回来的程序。因为回来时get方式，为避免终端消费者看到更多敏感信息，这一步并没有渲染页面，而是处理信息，跳转到另外一个页面。

6、显示支付结果。这个页面和第2步让客户点击支付成功跳转的是同一个。支付失败，就跳转到一个说明吧。

alipay.py

**\[python\]**  [view plain][]   [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  **import** types  
2.  **from** urllib **import** urlencode, urlopen  
3.  **from** hashcompat **import** md5\_constructor as md5<span style="white-space:pre">   </span>\#见hashcompact.py  
4.  **from** config **import** settings<span style="white-space:pre">         </span>\#见config.py  
5.    
6.  \#字符串编解码处理  
7.  **def** smart\_str(s, encoding='utf-8', strings\_only=False, errors='strict'):  
8.      **if** strings\_only **and** isinstance(s, (types.NoneType, int)):  
9.          **return** s  
10.     **if** **not** isinstance(s, basestring):  
11.         **try**:  
12.             **return** str(s)  
13.         **except** UnicodeEncodeError:  
14.             **if** isinstance(s, Exception):  
15.                 **return** ' '.join(\[smart\_str(arg, encoding, strings\_only,  
16.                         errors) **for** arg **in** s\])  
17.             **return** unicode(s).encode(encoding, errors)  
18.     **elif** isinstance(s, unicode):  
19.         **return** s.encode(encoding, errors)  
20.     **elif** s **and** encoding != 'utf-8':  
21.         **return** s.decode('utf-8', errors).encode(encoding, errors)  
22.     **else**:  
23.         **return** s  
24.   
25. \# 网关地址  
26. \_GATEWAY = 'https://mapi.alipay.com/gateway.do?'  
27.   
28.   
29. \# 对数组排序并除去数组中的空值和签名参数  
30. \# 返回数组和链接串  
31. **def** params\_filter(params):  
32.     ks = params.keys()  
33.     ks.sort()  
34.     newparams = \{\}  
35.     prestr = ''  
36.     **for** k **in** ks:  
37.         v = params\[k\]  
38.         k = smart\_str(k, settings.ALIPAY\_INPUT\_CHARSET)  
39.         **if** k **not** **in** ('sign','sign\_type') **and** v != '':  
40.             newparams\[k\] = smart\_str(v, settings.ALIPAY\_INPUT\_CHARSET)  
41.             prestr += '%s=%s&' % (k, newparams\[k\])  
42.     prestr = prestr\[:-1\]  
43.     **return** newparams, prestr  
44.   
45.   
46. \# 生成签名结果  
47. **def** build\_mysign(prestr, key, sign\_type = 'MD5'):  
48.     **if** sign\_type == 'MD5':  
49.         **return** md5(prestr + key).hexdigest()  
50.     **return** ''  
51.   
52.   
53. \# 即时到账交易接口  
54. **def** create\_direct\_pay\_by\_user(tn, subject, body, bank, total\_fee):  
55.     params = \{\}  
56.     params\['service'\]       = 'create\_direct\_pay\_by\_user'  
57.     params\['payment\_type'\]  = '1'       \#商品购买，只能选这个  
58.       
59.     \# 获取配置文件  
60.     params\['partner'\]           = settings.ALIPAY\_PARTNER  
61.     params\['seller\_id'\]         = settings.ALIPAY\_PARTNER  
62.     params\['seller\_email'\]      = settings.ALIPAY\_SELLER\_EMAIL  
63.     params\['return\_url'\]        = settings.ALIPAY\_RETURN\_URL  
64.     params\['notify\_url'\]        = settings.ALIPAY\_NOTIFY\_URL  
65.     params\['\_input\_charset'\]    = settings.ALIPAY\_INPUT\_CHARSET  
66.     params\['show\_url'\]          = settings.ALIPAY\_SHOW\_URL  
67.       
68.     \# 从订单数据中动态获取到的必填参数  
69.     params\['out\_trade\_no'\]  = tn        \# 请与贵网站订单系统中的唯一订单号匹配  
70.     params\['subject'\]       = subject   \# 订单名称，显示在支付宝收银台里的“商品名称”里，显示在支付宝的交易管理的“商品名称”的列表里。  
71.     params\['body'\]          = body      \# 订单描述、订单详细、订单备注，显示在支付宝收银台里的“商品描述”里，可以为空  
72.     params\['total\_fee'\]     = total\_fee \# 订单总金额，显示在支付宝收银台里的“应付总额”里，精确到小数点后两位  
73.       
74.     \# 扩展功能参数——网银提前  
75.     **if** bank=='alipay' **or** bank=='':  
76.         params\['paymethod'\] = 'directPay'   \# 支付方式，四个值可选：bankPay(网银); cartoon(卡通); directPay(余额); CASH(网点支付)  
77.         params\['defaultbank'\] = ''          \# 支付宝支付，这个为空  
78.     **else**:  
79.         params\['paymethod'\] = 'bankPay'     \# 默认支付方式，四个值可选：bankPay(网银); cartoon(卡通); directPay(余额); CASH(网点支付)  
80.         params\['defaultbank'\] = bank        \# 默认网银代号，代号列表见http://club.alipay.com/read.php?tid=8681379          
81.       
82.   
83.       
84.     params,prestr = params\_filter(params)  
85.       
86.     params\['sign'\] = build\_mysign(prestr, settings.ALIPAY\_KEY, settings.ALIPAY\_SIGN\_TYPE)  
87.     params\['sign\_type'\] = settings.ALIPAY\_SIGN\_TYPE  
88.       
89.     **return** \_GATEWAY + urlencode(params)  
90.   
91. **def** notify\_verify(post):  
92.     \# 初级验证--签名  
93.     \_,prestr = params\_filter(post)  
94.     mysign = build\_mysign(prestr, settings.ALIPAY\_KEY, settings.ALIPAY\_SIGN\_TYPE)  
95.   
96.     **if** mysign != post.get('sign'):  
97.         **return** False  
98.       
99.     \# 二级验证--查询支付宝服务器此条信息是否有效  
100.     params = \{\}  
101.     params\['partner'\] = settings.ALIPAY\_PARTNER  
102.     params\['notify\_id'\] = post.get('notify\_id')  
103.   
104.     gateway = 'https://mapi.alipay.com/gateway.do?service=notify\_verify&'  
105.     verify\_result = urlopen(gateway, urlencode(params)).read()  
106.     **if** verify\_result.lower().strip() == 'true':  
107.         **return** True  
108.     **return** False

hashcompact.py

**\[python\]**  [view plain][]   [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  """ 
2.  The md5 and sha modules are deprecated since Python 2.5, replaced by the 
3.  hashlib module containing both hash algorithms. Here, we provide a common 
4.  interface to the md5 and sha constructors, preferring the hashlib module when 
5.  available. 
6.  """  
7.    
8.  **try**:  
9.      **import** hashlib  
10.     md5\_constructor = hashlib.md5  
11.     md5\_hmac = md5\_constructor  
12.     sha\_constructor = hashlib.sha1  
13.     sha\_hmac = sha\_constructor  
14. **except** ImportError:  
15.     **import** md5  
16.     md5\_constructor = md5.new  
17.     md5\_hmac = md5  
18.     **import** sha  
19.     sha\_constructor = sha.new  
20.     sha\_hmac = sha

config.py

**\[python\]**  [view plain][]   [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \#-\*- coding:utf-8 -\*-  
2.    
3.  **class** settings:  
4.    \# 安全检验码，以数字和字母组成的32位字符  
5.    ALIPAY\_KEY = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'  
6.    
7.    ALIPAY\_INPUT\_CHARSET = 'utf-8'  
8.    
9.    \# 合作身份者ID，以2088开头的16位纯数字  
10.   ALIPAY\_PARTNER = 'xxxxxxxxxxxxxxxx'  
11.   
12.   \# 签约支付宝账号或卖家支付宝帐户  
13.   ALIPAY\_SELLER\_EMAIL = 'ls@abc.com'  
14.   
15.   ALIPAY\_SIGN\_TYPE = 'MD5'  
16.   
17.   \# 付完款后跳转的页面（同步通知） 要用 http://格式的完整路径，不允许加?id=123这类自定义参数  
18.   ALIPAY\_RETURN\_URL='http://www.xxx.com/alipay/return/'  
19.   
20.   \# 交易过程中服务器异步通知的页面 要用 http://格式的完整路径，不允许加?id=123这类自定义参数  
21.   ALIPAY\_NOTIFY\_URL='http://www.xxx.com/alipay/notify/'

view.py

**\[python\]**  [view plain][]   [copy][view plain]

[![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]

1.  \#确认支付  
2.  **def** pay(request):  
3.      cbid=request.POST.get('id')  
4.      **try**:  
5.          cb=cBill.objects.get(id=cbid)  
6.      **except** ObjectDoesNotExist:  
7.          **return** HttpResponseRedirect("/err/no\_object")  
8.        
9.      \#如果网关是支付宝  
10.     **if** cb.cbank.gateway=='alipay':  
11.             tn=cb.id  
12.             subject=''  
13.             body=''  
14.             bank=cb.cbank.id  
15.             tf='%.2f' % cb.amount  
16.             url=create\_direct\_pay\_by\_user (tn,subject,body,bank,tf)  
17.   
18.     \#如果网关是财付通  
19.     **elif** cb.cbank.gateway=='tenpay':  
20.         **pass**  
21.       
22.     \#去支付页面  
23.     **return** HttpResponseRedirect (url)  
24.   
25. \#alipay异步通知  
26.  
27. @csrf\_exempt  
28. **def** alipay\_notify\_url (request):  
29.     **if** request.method == 'POST':  
30.         **if** notify\_verify (request.POST):  
31.             \#商户网站订单号  
32.             tn = request.POST.get('out\_trade\_no')  
33.             \#支付宝单号  
34.             trade\_no=request.POST.get('trade\_no')  
35.             \#返回支付状态  
36.             trade\_status = request.POST.get('trade\_status')  
37.             cb = cBill.objects.get(pk=tn)  
38.               
39.             **if** trade\_status == 'TRADE\_SUCCESS':  
40.                 cb.exe()  
41.                 log=Log(operation='notify1\_'\+trade\_status+'\_'\+trade\_no)  
42.                 log.save()  
43.                 **return** HttpResponse("success")  
44.             **else**:  
45.                 \#写入日志  
46.                 log=Log(operation='notify2\_'\+trade\_status+'\_'\+trade\_no)  
47.                 log.save()  
48.                 **return** HttpResponse ("success")  
49.         **else**:  
50.             \#黑客攻击  
51.             log=Log(operation='hack\_notify\_'\+trade\_status+'\_'\+trade\_no+'\_'\+'out\_trade\_no')  
52.             log.save()  
53.     **return** HttpResponse ("fail")  
54.   
55. \#同步通知  
56.   
57. **def** alipay\_return\_url (request):  
58.     **if** notify\_verify (request.GET):  
59.         tn = request.GET.get('out\_trade\_no')  
60.         trade\_no = request.GET.get('trade\_no')  
61.         trade\_status = request.GET.get('trade\_status')  
62.             
63.         cb = cBill.objects.get(pk=tn)  
64.         log=Log(operation='return\_'\+trade\_status+'\_'\+trade\_no)  
65.         log.save()  
66.         **return** HttpResponseRedirect ("/public/verify/"\+tn)  
67.     **else**:  
68.         \#错误或者黑客攻击  
69.         log=Log(operation='err\_return\_'\+trade\_status+'\_'\+trade\_no)  
70.         log.save()  
71.         **return** HttpResponseRedirect ("/")  
72.   
73.   
74. \#外部跳转回来的链接session可能丢失，无法再进入系统。  
75. \#客户可能通过xxx.com操作，但是支付宝只能返回www.xxx.com，域名不同，session丢失。  
76. **def** verify(request,cbid):  
77.     **try**:  
78.         cb=cBill.objects.get(id=cbid)  
79.         \#如果订单时间距现在超过1天，跳转到错误页面！  
80.         \#避免网站信息流失  
81.           
82.         **return** render\_to\_response('public\_verify.html',\{ 'cb':cb\},RequestContext(request))  
83.     **except** ObjectDoesNotExist:  
84.         **return** HttpResponseRedirect("/err/no\_object")

![save_snippets.png][]

view.py中的代码仅供参考！

[Java]: http://lib.csdn.net/base/javaee
[PHP]: http://lib.csdn.net/base/php
[Python]: http://lib.csdn.net/base/python
[view plain]: http://blog.csdn.net/hornbills/article/details/40338949#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/513613
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/513613/fork
[save_snippets.png]: /images/20220715/064f09b4391f4f59a52fc475ebb9963d.png