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

http://blog.csdn.net/hornbills/article/details/40338949

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

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

即时到帐只对企业客户服务，注册成功企业账号以后，申请签约即时到帐产品，大约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

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
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  
25. # 网关地址
26. _GATEWAY = 'https://mapi.alipay.com/gateway.do?'
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  
46. # 生成签名结果
47. def build_mysign(prestr, key, sign_type = 'MD5'):  
48. if sign_type == 'MD5':  
49. return md5(prestr + key).hexdigest()  
50. return ''
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' #商品购买，只能选这个
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  
68. # 从订单数据中动态获取到的必填参数
69.     params['out_trade_no']  = tn        # 请与贵网站订单系统中的唯一订单号匹配
70.     params['subject']       = subject   # 订单名称，显示在支付宝收银台里的“商品名称”里，显示在支付宝的交易管理的“商品名称”的列表里。
71.     params['body']          = body      # 订单描述、订单详细、订单备注，显示在支付宝收银台里的“商品描述”里，可以为空
72.     params['total_fee']     = total_fee # 订单总金额，显示在支付宝收银台里的“应付总额”里，精确到小数点后两位
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        
84.     params,prestr = params_filter(params)  
86.     params['sign'] = build_mysign(prestr, settings.ALIPAY_KEY, settings.ALIPAY_SIGN_TYPE)  
87.     params['sign_type'] = settings.ALIPAY_SIGN_TYPE  
89. return _GATEWAY + urlencode(params)  
91. def notify_verify(post):  
92. # 初级验证--签名
93.     _,prestr = params_filter(post)  
94.     mysign = build_mysign(prestr, settings.ALIPAY_KEY, settings.ALIPAY_SIGN_TYPE)  
96. if mysign != post.get('sign'):  
97. return False
99. # 二级验证--查询支付宝服务器此条信息是否有效
100.     params = {}  
101.     params['partner'] = settings.ALIPAY_PARTNER  
102.     params['notify_id'] = post.get('notify_id')  
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

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. """
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

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

view.py

[python] view plain copy

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")  
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)  
18. #如果网关是财付通
19. elif cb.cbank.gateway=='tenpay':  
20. pass
22. #去支付页面
23. return HttpResponseRedirect (url)  
25. #alipay异步通知
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)  
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")  
55. #同步通知
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')  
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 ("/")  
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. #避免网站信息流失
82. return render_to_response('public_verify.html',{'cb':cb},RequestContext(request))  
83. except ObjectDoesNotExist:  
84. return HttpResponseRedirect("/err/no_object")  

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