宝易互通支付平台商户与支付平台交互接口开发规范2-00版.docVIP

宝易互通支付平台 商户与支付平台交互接口开发规范2.00版 宝易互通支付平台项目组 2010年3月4日 修改记录 编号 日期 描述 版本 作者 审核 发布日期 1 2010.3.4 初稿 V2.0 王金昭 2010.3 2 2010.5.14 修改 V2.0 王金昭 2010.5 3 2010.07.07 修改 V2.0 谢朝停 2010.7  支付接口 宝易互通支付平台为商户提供数据交换的标准接口，商户与支付平台签约后，支付平台开通签约商户，签约商户根据本接口规范开发支付程序，按规定的格式传送数据到支付平台，完成支付。商户端根据本接口规范开发接收程序，支付完成后，程序接收支付平台发送给商户系统的订单数据，并按接口规范进行数据验证和数据解析。 支付平台标准接口说明如下： 商户提交表单接口定义： 名称 物理字段 类型及范围 传送字段 加密连接顺序 描述 商户编号 merchantid 字符串，最大长度20 ◎ 1 商户编号 订单编号 merorderid 字符串，最大长度30 ◎ 2 商户发送订单编号 （该订单号不允许重复，请确认您的订单号在您的系统中对应的只有一条订单记录，否则会造成与宝易互通对账时，出现账务混乱） 订单金额 amountsum 金额类型，最大长度16,精确位2 ◎ 3 例 22.00 商品种类 subject Number型 ◎ 4 规则由商户制定,如果没有分类填写empty,若在宝易互通商户管理端已做了分类，请按分类填写，最大长度30 币种 currencytype 字符串，最大长度2 ◎ 5 缺省01代表人民币 自动调转取货页面 autojump 字符串，最大长度2位 ◎ 6 银行付款成功后是否自动跳转到取货页面：0→不跳转；1→跳转； 跳转等待时间 waittime 字符串，最大长度2位 ◎ 7 跳转到取货页面的等待时间，以秒为单位，默认5秒。 商户取货URL merurl 字符串，最大长度255位 ◎ 8 需要跳转时必输，支付成功后，客户URL浏览器自动跳转到该URL，如果autojump为空或者0，waittime不为空，则允许用户手动跳转到取货页面(请加入https://或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 交易类型： 0→即时到账；1→担保交易 扩展字段2 bankInput 字符串，最大长度2 ◎ 14 默认值0 （后期开发所用，现商户只需填写默认值0即可） 接口版本 interface 字符串，最大长度5,精确位2 ◎ 15 接口版本号，默认填写2.00 编码加密时需要加入新增字段 key加密串 mac 字符串，长度不限 ◎ 商户提交的信息加密后的字符串 备注 remark MAX（50） ◎ 备注信息，该字段可为空，但需要传送字段名给宝易互通 注： 上述所有字段均需要传送，可为空的字段，值可不设置，但需要传送字段名称。 支付密钥merkey参与加密，加密顺序第16位。由商户与支付平台签约时由平台分配，商户可登陆平台修改。为了保证数据安全，在传送数据时不能将此字段作为明文传送。 商户要保证定单号的唯一性。 字符串中变量名大小写按接口规定，可选参数也要参加运算，只提交参数名即可。 站点间接口的参数传送采用普通的URL方式，商户将以上信息包含在FORM中，以POST方式提交。 发送地址：/pay2_1_/paymentImplAction.do 例如： /pay2_1_/paymentImplAction.do?merchantid=1001merorderid=A1000testwjzamountsum=0.01subject=s001currencytype=01remark=%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AEautojump=1waittime=10merurl=http%3A%2F%2F6%3A8081%2Fumback%2FjhtpayReceveTestAc