第1页共6页编号:时间:2021年x月x日书山有路勤为径,学海无涯苦作舟页码:第1页共6页商银宝安全电子合同交易平台支付接口说明1.概述商银宝网上支付主要用于解决网上交易的付费问题。商银宝安全电子合同交易平台网上支付系统定义了一个和商户系统的开放接口,商户系统通过这一接口就可以和商银宝网上支付系统联通,完成网上交易的资金结算。商银宝网上支付系统接口简单,使用方便;对商户系统没有任何附加要求。2.安全控制网上交易的传输安全控制手段采用电子证书的签名验证。商银宝的WEBSERVER将安装一个证书(Certificate),客户端的浏览器发送CGI请求时使用http协议。所有用http发送的请求以及WebServer返回的结果都会自动使用证书签名加密。3.支付方式在用户完成支付过程后控制能够从商银宝WEB系统自动转回商户WEB系统,并且商户WEB系统能够知道用户的付款情况。比如,出售信息产品的商户,在支付成功的情况下,商户的结果页除包含支付成功通知信息外,还可以包含用户购买的信息产品。要求商户WEB系统必须提供一个支付结果通知命令。商银宝WEB系统在收到支付网页发出的支付命令后,先执行扣款操作,然后返回结果通知商户WEB系统,并根据指定的通知结果命令将结果页返回用户的浏览器。第2页共6页第1页共6页编号:时间:2021年x月x日书山有路勤为径,学海无涯苦作舟页码:第2页共6页4.接口方式说明支付提交命令形如:通知结果命令(请求响应结果返回到商户指定的URL)形如:http://returnURL?commandID=0001&version=1.0.0.0&orderID=XXXXXX....表一:交易请求接口参数说明:变量名称变量命名长度定义说明命令号commandIDMAX(4)取值:“0001”–提交订单接口版本号versionMAX(8)取值:“1.0.0.0”商户WEB用户浏览器商银保WEB4.支付结果页1.生成支付5.返回结果页3.支付结果通知2.支付命令第3页共6页第2页共6页编号:时间:2021年x月x日书山有路勤为径,学海无涯苦作舟页码:第3页共6页订单请求方式reqTypeMAX(2)02-网站集成订单号orderIDMAX(30)必输,签名,客户决定支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。电子合同平台通过【订单提交时间】为起始,检查此时间之前一段时间内是否已经存在同样商户代码和订单号的指令记录,如果有则认为指令重复;订单提交时间orderDate=14必输,签名,格式为:YYYYMMDDHHmmss为提交订单时商户系统时间,此时间应在系统当前时间的加、减一小时范围内;取值举例:20080808200101商户代码merIDMAX(20)必输,签名,唯一确定一个商户的代码,由商户在系统注册时,由系统告知商户订单金额amountMAX(10)必输,签名,客户支付订单的总金额,一笔订单一个,以分为单位。不可以为零,必须符合金额标准。支付币种curType=3必输,签名,用来区分一笔支付的币种,目前系统只支持使用人民币(001)支付。取值:“001”商品名称goodsNameMAX(60)必输,签名,(用于语音播报)商品数量goodsNumMAX(10)必输,签名,(用于语音播报)订单过期时间orderExpireTimeMax(14)可选项:YYYYMMDDHHMMSS商户返回URLreturnURLMax(100)必输,签名.(当商银宝支付平台处理完商户WEB的支付请求后,将处理结果返回至此U...