下载支付接口协议-商银宝安全电子合同交易平台.doc

商银宝安全电子合同交易平台 支付接口说明 概述 商银宝网上支付主要用于解决网上交易的付费问题。商银宝安全电子合同交易平台网上支付系统定义了一个和商户系统的开放接口，商户系统通过这一接口就可以和商银宝网上支付系统联通，完成网上交易的资金结算。商银宝网上支付系统接口简单，使用方便；对商户系统没有任何附加要求。 安全控制 网上交易的传输安全控制手段采用电子证书的签名验证。商银宝的WEB SERVER将安装一个证书(Certificate)，客户端的浏览器发送CGI请求时使用http协议。所有用http发送的请求以及Web Server返回的结果都会自动使用证书签名加密。 支付方式 在用户完成支付过程后控制能够从商银宝WEB系统自动转回商户WEB系统，并且商户WEB系统能够知道用户的付款情况。比如，出售信息产品的商户，在支付成功的情况下，商户的结果页除包含支付成功通知信息外，还可以包含用户购买的信息产品。 要求商户WEB系统必须提供一个支付结果通知命令。商银宝WEB系统在收到支付网页发出的支付命令后，先执行扣款操作，然后返回结果通知商户WEB系统，并根据指定的通知结果命令将结果页返回用户的浏览器。 接口方式说明 支付提交命令形如： form action=http://商银宝支付服务地址 method=post target=_blank input type=hidden name=commandID value=0002 input type=hidden name=reqType value=02 input type=hidden name=version value= input type=hidden name=returnURL value= input type=hidden name=orderID value=2008072936300 input type=hidden name=orderSubDate value=20080729112310 input type=hidden name=merID value=191 input type=hidden name=amount value=500 input type=hidden name=curType value=001 input type=hidden name=goodsName value= input type=hidden name=’goodNum’ value=’’ input type=hidden name=merSignMsg value=02 input type=’hidden’ name=’interfaceMode’ value=’1’ input type=submit value=立即使用商银宝支付/form 通知结果命令（请求响应结果返回到商户指定的URL）形如： HYPERLINK http://returnURL?commandID=0001version=orderID=XXXXXX http://returnURL?commandID=0001version=orderID=XXXXXX.... 表一：交易请求接口参数说明： 变量名称 变量命名 长度定义 说明 命令号 commandID MAX(4) 取值：“0001” –提交订单 接口版本号 version MAX(8) 取值：“1.0. 订单请求 方式 reqType MAX(2) 02-网站集成 订单号 orderID MAX(30) 必输，签名， 客户决定支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。电子合同平台通过【订单提交时间】为起始，检查此时间之前一段时间内是否已经存在同样商户代码和订单号的指令记录，如果有则认为指令重复； 订单提交时间 orderDate =14 必输，签名， 格式为：YYYYMMDDHHmmss 为提交订单时商户系统时间，此时间应在系统当前时间的加、减一小时范围内； 取值举例：20080808200101 商户代码 merID MAX(20) 必输，签名， 唯一确定一个商户的代码，由商户在系统注册时，由系统告知商户 订单金额 amount MAX(10) 必输，签名， 客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必须符合金额标准。 支付币种 curType = 3 必输，签名， 用来区分一笔支付的币种，目前系统只支持使用人民币（001）支付。 取值： “001” 商品名称 goodsName MAX(60) 必输，签名，（用于语音播报） 商品数量 goodsNum MAX(10) 必输，签名，（用于语音播报） 订单过期时间 orderExpireTime Max(14) 可选项