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

宝易互通支付平台商户与支付平台交互接口开发规范2.00版宝易互通支付平台项目组2010年3月4日修改记录编号日期描述版本作者审核发布日期12010.3.4初稿V2.0王金昭2010.322010.5.14修改V2.0王金昭2010.532010.07.07修改V2.0谢朝停2010.71. 支付接口宝易互通支付平台为商户提供数据交换的标准接口，商户与支付平台签约后，支付平台开通签约商户，签约商户根据本接口规范开发支付程序，按规定的格式传送数据到支付平台，完成支付。商户端根据本接口规范开发接收程序，支付完成后，程序接收支付平台发送给商户系统的订单数据，并按接口规范进行数据验证和数据解析。 支付平台标准接口说明如下：1.1. 商户提交表单接口定义：名称物理字段类型及范围传送字段加密连接顺序描述商户编号merchantid字符串，最大长度201商户编号订单编号merorderid字符串，最大长度302商户发送订单编号（该订单号不允许重复，请确认您的订单号在您的系统中对应的只有一条订单记录，否则会造成与宝易互通对账时，出现账务混乱）订单金额amountsum金额类型，最大长度16,精确位23例 22.00商品种类subjectNumber型4规则由商户制定,如果没有分类填写empty,若在宝易互通商户管理端已做了分类，请按分类填写，最大长度30币种currencytype字符串，最大长度25缺省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字符串，最大长度214默认值0 （后期开发所用，现商户只需填写默认值0即可）接口版本interface字符串，最大长度5,精确位215接口版本号，默认填写2.00编码加密时需要加入新增字段key加密串mac字符串，长度不限商户提交的信息加密后的字符串备注remarkMAX（50）备注信息，该字段可为空，但需要传送字段名给宝易互通注：1) 上述所有字段均需要传送，可为空的字段，值可不设置，但需要传送字段名称。2) 支付密钥merkey参与加密，加密顺序第16位。由商户与支付平台签约时由平台分配，商户可登陆平台修改。为了保证数据安全，在传送数据时不能将此字段作为明文传送。3) 商户要保证定单号的唯一性。4) 字符串中变量名大小写按接口规定，可选参数也要参加运算，只提交参数名即可。5) 站点间接口的参数传送采用普通的URL方式，商户将以上信息包含在FORM中，以POST方式提交。6) 发送地址：/pay2_1_/paymentImplAction.do例如：/pay2_1_/paymentImplAction.do?merchantid=1001&merorderid=A1000testwjz&amountsum=0.01&subject=s001¤cytype=01&remark=%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE&autojump=1&waittime=10&merurl=http%3A%2F%2F6%3A8081%2Fumback%2FjhtpayReceveTestAction.do&informmer=1&informurl=http%3A%2F%2F6%3A8081%2Fumback%2FjhtpaySendTestAction.do&confirm=1&merbank=empty&tradetype=0&bankInput=0&interface=2.00&mac=8efee8f42d971afb9c082b1ba0265b61参与MAC运算的字符及其顺序如下：merchantid、merorderid、amountsum、subject、currencytype、autojump、waittime、merurl、informmer、informurl、confirm、merbank、tradetype、bankInput、interface、merkey例如，参与MAC计算的源字符串为：merchantid=1001&merorderid=A1000testwjz&amountsum=0.01&subject=s001¤cytype=01&autojump=1&waittime=10&merurl=6:8081/umback/jhtpayReceveTestAction.do&informmer=1&informurl=6:8081/umback/jhtpaySendTestAction.do&confirm=1&merbank=empty&tradetype=0&bankInput=0&interface=2.00&merkey=111111经过MD5加密后的mac串为：mac=8efee8f42d971afb9c082b1ba0265b611.2. 支付平台生成以下信息，传送到商户：宝易互通通知商户支付结果分为两种方式：1 页面通知：页面通知地址随订单数据传送给宝易互通（订单数据字段：merurl），采用页面通知时，请配置页面通知开关autojump=1通知信息如下；2 服务器通知：服务器地址随订单数据传送给宝易互通（订单数据字段：informurl），商户使用服务器通知时，请配置服务器通知开关informmer=1；商户接受到宝易互通通知数据后，若选择确认（既confirm=1 确认信息见2.3章节），宝易互通在商户确认后将会停止通知信息的发送，商户选择确认但未发送确认信息或发送错误的确认信息给宝易互通，宝易互通将会继续通知商户，知道商户确认或是通知次数满6次，才会停止服务器通知。若商户选择不通知（既confirm=0），宝易互通将会以http通讯所返回的200响应码作为商户已接收到通知信息的标示，结束服务器通知。通知信息如下：名称物理字段类型及范围必要字段加密连接顺序输入来源描述商户编号merchantid字符串，最大长度201平台商户编号订单编号merorderid字符串，最大长度302平台商户发送订单编号订单金额amountsum金额类型，最大长度16,精确位23平台订单金额币种currencytypeNumber型4平台01代表人民币商品种类subjectNumber型5平台规则由商户制定,如果没有分类可不填(可选),最大长度30支付状态state字符串，长度16平台状态： 0未付款(默认值)； 1成功相符； 2成功不符； 3失败；担保交易状态（开展担保交易才会这些状态）4已付款，未发货；5已发货，未确认收货；6已发货,退款中；7未发货,退款中；8交易关闭；支付银行paybank字符串，最大长度307平台用户支付时选择的银行发送到银行时间banksendtime时间类型DATE8平台平台提交支付数据到银行的时间(格式: yyyy-MM-dd HH:mm:ss)返回到商户时间merrecvtime时间类型DATE9平台平台给商户返回支付结果的时间(格式: yyyy-MM-dd HH:mm:ss)接口版本interface数字，最大长度5,精确位210商户网站接口版本号为2.00 key加密串mac字符串，长度不限平台提交给商户的信息加密后的字符串站点间接口的参数传送仍然采用普通的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注：?前的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 11: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商户登录地址：/mer商户登录用户：umpay密码：111111宝易互通生产提交地址：https:/ww