WAP支付开发指南
版本1.02 修订历史
版权信息
本手册中所有的信息为支付宝公司提供。未经过支付宝公司书面同意,接收本手册的人不能复制,公开,泄露手册的部分或全部的内容
目录
1.前言 (3)
2.接口介绍 (3)
3.接口详细说明 (4)
3.1.交易创建(ate.direct) (4)
3.2.授权并执行(alipay.wap.auth.authAndExecute) (5)
3.3.处理支付宝系统通知。(notify_url) (6)
4.附录 (8)
4.1.所有参数查询列表 (8)
4.2.错误代码列表 (11)
4.3.签名规范 (11)
1.前言
1.目标
该文档目的是帮助商户WAP应用开发人员准确、快速完成支付宝接口集成。
2.面向读者
本文档主要面向接入支付宝WAP支付的外部商户的开发人员。
3.术语
4.操作流程
●从商户签约平台中获取:合作伙伴ID(partnerId) 和密钥信息。
●根据开发指南集成支付宝接口。(可参考已发布官方Demo)
5.商户交流平台
商户如果在接入过程中碰到疑问,可以通过以下形式进行咨询,支付宝工作人员会给予答复。
●支付宝官方论坛:club.alipay/thread.php?fid=747
2.接口介绍
1.商户开发内容描述
步骤一:调用接口ate.direct,提交订单信息,获取token串。
步骤二:调用接口alipay.wap.auth.authAndExecute,提交token串,跳转到支付宝收银台。
步骤三:处理支付宝系统通知。详见
2.交互模式(调用形式)
基于http/https 的请求/响应模式。建议使用http请求已适配更多机型。
http请求地址: wappaygw.alipay/service/rest.htm
https请求地址: wappaygw.alipay:443/service/rest.htm
3.接口详细说明
3.1.交易创建(ate.direct)
该接口由支付宝提供给商户调用。
3.2.1.请求样例(request)
为方便展示故写成GET形式,正式请求时必须使用POST形式,以避免请求内容过长而丢失信息。
以下样例分为三类参数(下划线参数为最外层参数,共8个。只有req_data参数值中包含内层xml标签参数。):蓝参数---- 表示该参数为必传,值可自定义。(详见参数列表)
红参数---- 表示该参数非必传。(详见参数列表)
3.2.2.成功返回样例(response)
返回response参数中只要包含res_data参数即可认为成功返回。
当商户使用RSA签名方式时,实际返回的内容如下(其中res_data参数值为加密内容,商户需用商户RSA私钥先进行解密后再验签):
当商户使用MD5签名方式时,实际返回的内容如下(其中res_data参数值为明文内容,无需解密)
3.2.3.失败返回样例(response)
失败返回无论哪种签名方式,内容都是明文无需解密。
3.2.授权并执行(alipay.wap.auth.authAndExecute)
该接口由支付宝提供给商户调用。
yymc3.2.
4.请求样例(request)
Get/Post形式都可以。
以下样例分为三类参数(下划线参数为最外层参数,共8个。只有req_data参数值中包含内层xml标签参数。):蓝参数---- 表示该参数为必传,值可自定义。(详见参数列表)
红参数---- 表示该参数非必传。(详见参数列表)
3.2.5.成功返回页面(response)
3.2.6.失败返回页面(response)
3.3.处理支付宝系统通知。(notify_url)
商户需要提供一个http的URL(例:www.partnertest/servlet/NotifyReceiver)来接受支付宝后台请求。当交易状态发生变化,支付宝后台都会用POST方式主动调用该接口。商户必须在收到trade_status=TRADE_FINISHED的请求后才可判定交易成功(其它trade_status状态请求可以不作处理),并返回success(注意:支付宝需精确匹配该字样,不能包含任何其他的HTML脚本语言)表示通知处理完毕,反之支付宝系统会对同一笔订单进行周期性的通知重发(间隔时间为:2分钟,10分钟,10
分钟,1小时,2小时,6小时,15小时共7次)。