宝易互通支付平台商户与支付平台交互接口开发规范版

上传人:宝路 文档编号:5903325 上传时间:2017-09-08 格式:DOC 页数:9 大小:94KB
返回 下载 相关 举报
宝易互通支付平台商户与支付平台交互接口开发规范版_第1页
第1页 / 共9页
宝易互通支付平台商户与支付平台交互接口开发规范版_第2页
第2页 / 共9页
宝易互通支付平台商户与支付平台交互接口开发规范版_第3页
第3页 / 共9页
宝易互通支付平台商户与支付平台交互接口开发规范版_第4页
第4页 / 共9页
宝易互通支付平台商户与支付平台交互接口开发规范版_第5页
第5页 / 共9页
点击查看更多>>
资源描述

《宝易互通支付平台商户与支付平台交互接口开发规范版》由会员分享,可在线阅读,更多相关《宝易互通支付平台商户与支付平台交互接口开发规范版(9页珍藏版)》请在金锄头文库上搜索。

1、宝易互通支付平台商户与支付平台交互接口开发规范 2.00 版宝易互通支付平台项目组2010 年 3 月 4 日修改记录编号 日期 描述 版本 作者 审核 发布日期1 2010.3.4 初稿 V2.0 王金昭 2010.32 2010.5.14 修改 V2.0 王金昭 2010.53 2010.07.07 修改 V2.0 谢朝停 2010.71. 支付接口宝易互通支付平台为商户提供数据交换的标准接口,商户与支付平台签约后,支付平台开通签约商户,签约商户根据本接口规范开发支付程序,按规定的格式传送数据到支付平台,完成支付。商户端根据本接口规范开发接收程序,支付完成后,程序接收支付平台发送给商户系统

2、的订单数据,并按接口规范进行数据验证和数据解析。支付平台标准接口说明如下:1.1. 商户提交表单接口定义:名称 物理字段 类型及范围 传送字段 加密连接顺序 描述商户编号 merchantid 字符串,最大长度 20 1 商户编号订单编号 merorderid 字符串,最大长度 30 2商户发送订单编号(该订单号不允许重复,请确认您的订单号在您的系统中对应的只有一条订单记录,否则会造成与宝易互通对账时,出现账务混乱)订单金额 amountsum金额类型,最大长度16,精确位 2 3 例 22.00商品种类 subject Number 型 4规则由商户制定,如果没有分类填写 empty,若在宝

3、易互通商户管理端已做了分类,请按分类填写,最大长度 30币种 currencytype 字符串,最大长度 2 5 缺省 01 代表人民币自动调转取货页面 autojump字符串,最大长度 2 位 6银行付款成功后是否自动跳转到取货页面:0不跳转;1跳转;跳转等待时间 waittime字符串,最大长度 2 位 7跳转到取货页面的等待时间,以秒为单位,默认 5秒。商户取货URL merurl字符串,最大长度 255位 8需要跳转时必输,支付成功后,客户 URL 浏览器自动跳转到该 URL,如果autojump 为空或者0,waittime 不为空,则允许用户手动跳转到取货页面(请加入 https:

4、/或http:/) 通知商户 informmer 字符串,最大长度 2 位 9将订单的状态通知给商户的 URL:0不通知;1通知;商户通知URL informurl字符串,最大长度 255位 10将订单的状态通知给商户的 URL(请加入 https:/或 http:/) 商户返回确认 confirm字符串,最大长度 2 位 11商户是否响应平台的确认信息:0不返回;1返回;参考 2.2 节扩展字段 1 merbank 字符串,最大长度 10 位 12值填写 empty;(后期开发所用,现商户只需填写默认值 empty 即可)支付类型 tradetype 字符串,最大长度 2 位 13 交易类型

5、: 0即时到账;1担保交易扩展字段 2bankInput字符串,最大长度 2 14默认值 0 (后期开发所用,现商户只需填写默认值 0 即可)接口版本 interface字符串,最大长度 5,精确位 2 15接口版本号,默认填写2.00编码加密时需要加入新增字段key 加密串 mac 字符串,长度不限 商户提交的信息加密后的字符串备注 remark MAX(50) 备注信息,该字段可为空,但需要传送字段名给宝易互通注:1) 上述所有字段均需要传送,可为空的字段,值可不设置,但需要传送字段名称。2) 支付密钥 merkey 参与加密,加密顺序第 16 位。由商户与支付平台签约时由平台分配,商户可

6、登陆平台修改。为了保证数据安全,在传送数据时不能将此字段作为明文传送。3) 商户要保证定单号的唯一性。4) 字符串中变量名大小写按接口规定,可选参数也要参加运算,只提交参数名即可。5) 站点间接口的参数传送采用普通的 URL 方式,商户将以上信息包含在FORM 中,以 POST 方式提交。6) 发送地址:https:/ MAC 运算的字符及其顺序如下:merchantid、merorderid、amountsum、subject、currencytype、autojump、waittime、merurl、informmer、informurl、confirm、merbank、tradetype

7、、bankInput、interface、merkey例如,参与 MAC 计算的源字符串为:merchantid=1001&merorderid=A1000testwjz&amountsum=0.01&subject=s001¤cytype=01&autojump=1&waittime=10&merurl=http:/70.216.160.16:8081/umback/jhtpayReceveTestAction.do&informmer=1&informurl=http:/70.216.160.16:8081/umback/jhtpaySendTestAction.do&conf

8、irm=1&merbank=empty&tradetype=0&bankInput=0&interface=2.00&merkey=111111经过 MD5 加密后的 mac 串为:mac=8efee8f42d971afb9c082b1ba0265b611.2. 支付平台生成以下信息,传送到商户:宝易互通通知商户支付结果分为两种方式:1 页面通知:页面通知地址随订单数据传送给宝易互通(订单数据字段:merurl),采用页面通知时,请配置页面通知开关autojump=1 通知信息如下;2 服务器通知:服务器地址随订单数据传送给宝易互通(订单数据字段:informurl) ,商户使用服务器通知时,

9、请配置服务器通知开关 informmer=1;商户接受到宝易互通通知数据后,若选择确认(既 confirm=1 确认信息见 2.3 章节) ,宝易互通在商户确认后将会停止通知信息的发送,商户选择确认但未发送确认信息或发送错误的确认信息给宝易互通,宝易互通将会继续通知商户,知道商户确认或是通知次数满 6 次,才会停止服务器通知。若商户选择不通知(既 confirm=0),宝易互通将会以 http 通讯所返回的 200 响应码作为商户已接收到通知信息的标示,结束服务器通知。通知信息如下:名称 物理字段 类型及范围 必要字段 加密连接顺序 输入来源 描述商户编号 merchantid 字符串,最大长

10、度 20 1 平台 商户编号订单编号 merorderid 字符串,最大长度 30 2 平台 商户发送订单编号订单金额 amountsum 金额类型,最大长度 16,精确位 2 3 平台 订单金额币种 currencytype Number 型 4 平台 01 代表人民币商品种类 subject Number 型 5 平台规则由商户制定,如果没有分类可不填(可选),最大长度 30支付状态 state 字符串,长度 1 6 平台状态: 0未付款(默认值); 1成功相符;2成功不符; 3失败;担保交易状态(开展担保交易才会这些状态)4已付款,未发货;5已发货,未确认收货;6已发货,退款中;7未发货

11、,退款中;8交易关闭;支付银行 paybank 字符串,最大长度 30 7 平台 用户支付时选择的银行发送到银行时间 banksendtime 时间类型 DATE 8 平台平台提交支付数据到银行的时间(格式: yyyy-MM-dd HH:mm:ss)返回到商户时间 merrecvtime 时间类型 DATE 9 平台平台给商户返回支付结果的时间(格式: yyyy-MM-dd HH:mm:ss)接口版本 interface 数字,最大长度5,精确位 2 10 商户网站 接口版本号为 2.00 key 加密串 mac 字符串,长度不限 平台 提交给商户的信息加密后的字符串站点间接口的参数传送仍然采

12、用普通的 URL 方式,信息包含在商户响应程序参数中,具体如下所示:https:/merchant.web.site/merchant_recv?merchantid=1001&merorderid=A10000100001&amountsum=0.01¤cytype=01&subject=s001&state=1&paybank=SZDB&banksendtime=2010-03-04 11:16:14.0&merrecvtime=2010-03-04 11:17:12&interface=2.00&mac=1fc0c8219afab4b13b94b93a4ed6d469注:?前

13、的 URL 由商户在签约时提供或后期在支付平台中修改。参与签名运算的字符及其顺序如下:Merchantid、merorderid、amountsum、currencytype、subject、state、paybank、banksendtime、merrecvtime、interface、merkey例如:参与 MAC 计算的源字符串为:merchantid=1001&merorderid=A10000100001&amountsum=0.01¤cytype=01&subject=s001&state=1&paybank=SZDB&banksendtime=2010-03-04 1

14、1:16:14.0&merrecvtime=2010-03-04 11:17:12&interface=2.00&merkey=111111经过 MD5 加密后的 MAC 串为:mac=1fc0c8219afab4b13b94b93a4ed6d469注:(1) 字符串中变量名大小写按接口规定。支付密钥 merkey 是在商户与支付平台签约时由平台分配,商户可登陆平台修改。(2) 商户接收到数据以后可以按照给定格式和加密方法进行 mac 校验。如果支付失败,平台不会向商户发送数据。流程: 买家付完款(state=1)-宝易互通通知商户-如果商户反馈给宝易互通的是 success=true(表示成功,这个状态下不再反馈,如果不是继续通知,一般第一次发送和第二次发送的时间间隔是 5 分钟)2. 其它说明2.1. 测试数据宝易互通测试商户商户编码:1001支付密钥:111111商户登录地址:http:/

展开阅读全文
相关资源
正为您匹配相似的精品文档
相关搜索

最新文档


当前位置:首页 > 行业资料 > 其它行业文档

电脑版 |金锄头文库版权所有
经营许可证:蜀ICP备13022795号 | 川公网安备 51140202000112号