宝易互通支付平台商户和支付平台交互接口开发规范2.00版.docVIP

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