第 1 页 共 20 页
批量付款接口
版本
1.0
接口名称:批量付款到帐号(batch_trans_notify )  修订历史
目  录
1
前言........................................................................................................................................... 3 1.1 目标用户 ........................................................................................................................ 3 1.2
术语 (3)
2 接口介绍 ...................................................................................................................................
3 2.1 定义................................................................................................................................ 3 2.2
操作流程 (3)
3 如何接入 ................................................................................................................................... 5 3.1 支付接口构造 ................................................................................................................ 5 3.2 支付部分 ........................................................................................................................ 5 3.3
返回部分 (6)
4 接口详细说明 ........................................................................................................................... 6 4.1
传递到支付宝的参数列表 (6)
第 2 页 共 20 页
4.2 从支付宝获取到的参数列表 ........................................................................................ 8 4.3 返回通知 . (10)
5
如何测试 ................................................................................................................................. 10 5.1 支付部分 ...................................................................................................................... 10 5.2
返回部分 (11)
6 注意事项 ................................................................................................................................. 11 6.1 安全方面CheckList  ................................................................................................... 11 6.2 签名方面 ...................................................................................................................... 11 6.3
其他方面 (12)
7 附录......................................................................................................................................... 13 7.1 错误代码列表 .............................................................................................................. 13 7.2
接口机制 ...................................................................................................................... 15 7.2.1 系统交互 .......................................................................................................... 15 7.2.2 系统调用 .......................................................................................................... 15 7.2.3 页面跳转 .......................................................................................................... 16 7.2.4 请求参数构造 .. (17)
7.3
FAQ (19)
第 3 页 共 20 页
1 前言
1.1 目标用户
拥有通过实名认证的支付宝帐号的用户
1.2 术语
2 接口介绍
2.1 定义
批量付款到帐号是指一个支付宝帐号帐号同一时间一次性把多个指定的金额发给指定的支付宝帐号里,例如代理保险、佣金、平台商要每月对代理商进行一次结算等。
2.2 操作流程
步骤一:
第 4 页 共 20 页
设置好付款人支付宝帐号、真实姓名或公司名、付款总金额、各收款人支付宝帐号及所对应的金额、流水号、原因等。 步骤二:
支付宝怎么开通商家收款
通过做好的接口功能,页面跳转到支付宝专门为批量付款设计的支付页面,如下图:
备注:如果开通手机护航,在上图中辉提示输入手机验证码。 步骤三:
确认各条记录里的流水号、收款人支付宝帐号、收款人真实姓名、收款金额、原因以及付款总笔数和总金额等,填写付款人的支付宝帐号与支付密码,点击“确认”执行付款操作。 步骤四:
完成支付,页面提示付款成功,如下图:
第 5 页 共 20 页
步骤五:
自身网站程序里根据支付宝服务器发送来的通知,来获取其信息并对这些信息进行处理。
3 如何接入
3.1 支付接口构造
支付接口一般分为两部分:支付部分、返回部分,批量付款的返回部分是由XML 组成。
3.2 支付部分
这里面包含了诸多参数,以一定规律排列组合,并参与加密运算后,拼接成一长串地址链接,之后程序自动跳转该链接到一窗口去,这个窗口就是支付宝的支付页面。
程序上需要做的事:
根据自身网站的情况,赋予这些参数的值,并让该程序接口自动运行起来。 这些参数主要有:订单号、金额等。 *不支持自定义参数。
*批量付款的数据不能包含空格,必须是支付宝帐户,否则会出现签名错误等
第 6 页 共 20 页
例如:
0315006^testture0002@126 (不能有空格)^常炜买家二(不能有空格)^20.00^hello|0315001^testture0002@126^常炜买家二^20.00^hello
3.3 返回部分
接收到支付宝服务器发送的订单信息,来处理自己的网站的订单。 ● 返回页
支付完成以后,从支付宝网站自动跳到一个XML 的页面,而这个页面就是返回页。 作用是:提示用户支付成功或是失败。因此该页面可美工处理,让该页美化,但需要对XML 进行解析。
● 通知页
订单的状态发生变更时,该页面就会被支付宝的服务器所调用,并运行起来,执行里面的程序,并发送success 的通知给支付宝服务器,表示已收到被调用的信息。
因为是异步的过程,所以该页面无法调试,只能通过数据库写入或写日志的方式来记录是否被调用。
也因此,想做到与支付宝的订单信息的同步,可以把订单的变更程序写在这个页面里。
4 接口详细说明
4.1 传递到支付宝的参数列表
A .注意总额和笔数要和详细数据匹配