《省号百平台支付接口技术规范-V10》由会员分享，可在线阅读，更多相关《省号百平台支付接口技术规范-V10（19页珍藏版）》请在金锄头文库上搜索。
1、【WEBB网上号号百技术术接口规规范】V1.0020111年6月湖北公众众目 录1. 文文档说明明31.1 文档目目标31.2 阅读对对象31.3 相关约定定31.4 业务及及技术支支持32. 业业务描述述及接口口开发332.1 功能说说明及流流程32.2 商户接接入前提提42.3 参数说说明52.3.1HTTTP订订单支付付请求接接口52.3.2退款款接口552.4 开发提提示52.4.1 商商户对支支付结果果的处理理53. 参参考资料料53.1出出参类型型说明551. 文文档说明明1.1 文档目目标本文档的的目的是是为WEEB网上上支付定定义一个个标准接接口规范范，以帮帮助各省省号百及及合
2、作商商户技术术人员接接入号百百网上支付付，并快速掌掌握号百百网上支支付相关关功能，为为业务开开展提供供支付服服务。1.2 阅读对对象对号百网网上支付付存在需需求的公公司、机机构及合合作商户户的网上上应用开开发人员员、维护护人员和和业务管理理人员。1.3 相关约约定商户：指指已注册册成为号号百用户户、并使使用号百百产品实实现其收收付费功功能需求求、为其其用户提提供各类类产品或或者相关关服务的的个人。用户：指指在商户户网站等等系统购购物的个个人。购物：指指用户在在商户网网站购买买相关产产品或服服务。1.4 业务及及技术支支持如果您有有任何业业务及技技术上的的疑问，可可联系省省号百技技术人员员。2.
3、 业业务描述述及接口口开发2.1 功能说说明及流流程WEB网网上支付付方式是是指利用用网银账账户，通通过互联联网Weeb网页页操作完完成支付付过程的的方式。此此种方式式下，客客户利用用PC终终端，通通过登陆陆号百或或合作方方网站，进行商商品或服服务选购购，生成成并确认认订单信息息，根据本本人使用用借记卡卡或贷记记卡付款款的要求求，选择择相应银银行通过过银行网网银界面面实现支支付的功功能。用户向交交易网站站购物时时，需要要通过一一定方式式向商户户支付相相关费用用。商户户网站系系统如果果集成号号百网上上支付功功能，则则可以让让用户安安全、方方便、快快捷地向向商户支支付选购购商品及及服务款款项，并并
4、且商户户也可以以很容易易了解到到款项的的到帐情情况及用用户购买买的产品品或服务务。整体流程程如下：用户在商商户交易易网站选选择产品品或服务务，在下下订单支支付完成成后，商商户网站站会将该该订单号号及对应应订单金金额等相相关信息息提交到到号百，然然后跳转转到号百百页面进进行支付付。当支支付完成成后，号号百将支支付结果果返回商商户，并并且根据据商户指指定的地地址跳转转到商户户指定页页面。商商户系统统后台接接收到支支付结果果之后，对对数据库库进行相相应更新新，然后后在显示示给用户户的页面面中作出出相应提提示。2.2 商户接接入前提提商户接入入号百平平台网上上支付，须须准备好好指定网网站供客客户上网网
5、浏览，并并为用户户提供商商品查询询、选购购，直至至下单的的功能及及页面展展示。以以下页面面须由商商户预先先实现方方能进行行号百网网上支付付接入，参参考图示示如下：2.3 参数说说明2.3.1HTTTP订单单支付请请求接口口httpp订单支支付请求求地址：htttp:/wwww.hhb11181114.ccn/serrvicceInnterrfacce/do.asppx2.3.1.11接口描描述接口名称称重定向跳跳转订单单支付请请求接口口接口描述述通过调用用支付接接口向号号百平台台发出支支付请求求,平台台通过支支付Poortaal与用用户进行行交互，完完成支付付处理后后，重定定向回应应用系统统（
6、SPP）接口提供供者号百平台台接口使用用者应用系统统（SPP）2.3.1.22接口定定义应用系统统的请求求参数定定义：字段名称长度是否必填填说明BSTMMERCCHANNTIDDSP身份份标识CHARR(300)是由号百平平台统一一分配ORDEERSEEQ订单号CHARR(300)是由SP提提供，在在sp处处不能重重复，用用于标识识一个唯唯一的订订单，订订单号可可以在没没有支付付成功的的情况下下，再次次进行交交易，但但每次交交易时的的订单请请求交易易流水号号不能重重复数字或字字母组成成ORDEERREEQTRRANSSEQ订单请求求交易流流水号CHARR(300)是订单支付付请求的的交易流流水
7、号每次订单单支付时时，不要要重复以日期时时间yyyyyMMMdddHHmmmsssff+号百平平台商户户代码（由由号百平平台提供供），如如：20066101121332422535500001200661011213324225355为日期期时间00011为号百百给定的的商户代代码数字或字字母组成成ORDEERDAATE订单日期期CHARR(8)是由SP提提供，长长度8yyyyy-MMM-ddd格式ORDEERAMMOUNNT订单总金金额NUMBBER(10)是单位：分分订单总金金额 = 产品品金额+附加金金额PRODDUCTTAMOOUNTT产品金额额NUMBBER(10)是单位：分分ATT
8、AACHAAMOUUNT附加金额额NUMBBER(10)是单位：分分VIEWWURLL前台返回回地址CHARR(2556)是SP提供供的用于于接收交交易返回回的前台台urll，不做做业务处处理，仅仅仅用于于前台页页面显示示结果DEALLURLL后台返回回地址CHARR(2556)是SP提供供的用于于接收交交易返回回的后台台urll，用于于实际的的业务处处理USERRIDSP用户户IDCHARR(400)是SP平台台用户IID，为为SP平平台用户户体系的的唯一标标识。REMAARK备注CHARR(2556)是SP平台台提供对对本次订订单的描描述如：“充充值”或“购买了了一张电电影票”ATTAAC
9、H附加信息息CHARR(50)否SP附加加信息MACMAC校校验域CHARR(2556)是采用标准准的MDD5算法法，由SSP实现现说明：1）商户户要保证证订单号号的唯一一性。2）在商商户提交交订单的页页面上，提提交按钮钮应该是是点击一一次后，马马上不可可用，防防止用户户多次提提交。3） 接接口方式式采用表表单方式式，商户户将以上上信息包包含在表表单中，直直接SUUBMIIT 到到号百平平台urrl上4）MAAC校验验，保证证了交易易信息到到支付平平台的完完整性，参参与MAAC运算算的字符符及其顺顺序如下下：BSTMMERCCHANNTIDD=122345567889&OORDEERSEEQ=
10、2200660311400000001&OORDEERDAATE=2000603314&ORDDERAAMOUUNT=100000将上述固固定顺序序组织的的字符串串，参数数名均为为大写，使使用标准准md55算法进进行摘要要，然后后将摘要要果转成成16进进制字符符串，就就是校验验域MAAC的值值，并在在提交订订单时，将将MACC值和订订单信息息一起提提交到号号百平台台号百平台台的响应应参数定定义：字段名称类型是否必填填说明BSTUUPTRRANSSEQ号百平台台交易流流水号CHARR(500)是由号百平平台提供供，SPP必须保保存该信信息，作作为对帐帐依据BSTTTRANNDATTE号百平台台交
11、易日日期CHARR(8)是由号百平平台提供供，SPP必须保保存该信信息，格格式：yyyyyy-MMM-ddd,商户对对账、清清算报表表以此日日期为准准RETNNCODDE处理结果果码CHARR(4)是由号百平平台统一一定义，SSP需保保存，作作为对帐帐数据。结结果码为为“00000” 表示示支付成成功，其其他值则则表示支支付失败败RETNNINFFO处理结果果解释码码CHARR(100)是由号百平平台统一一定义，对对支付结结果的说说明码ORDEERREEQTRRANSSEQ订单请求求交易流流水号CHARR(322)是从SP发发送的订订单的信信息中获获得，号百平平台原值值传回ORDEERSEEQ
12、订单号CHARR(322)是从SP发发送的订订单的信信息中获获得，号百平平台原值值传回ORDEERAMMOUNNT订单总金金额NUMBBER(10)是从SP发发送的订订单的信信息中获获得，号百平平台原值值传回，单单位：分分订单总金金额 = 产品品金额+附加金金额PRODDUCTTAMOOUNTT产品金额额NUMBBER(10)是从SP发发送的订订单的信信息中获获得，号百平平台原值值传回，单单位：分分ATTAACHAAMOUUNT附加金额额NUMBBER(10)是从SP发发送的订订单的信信息中获获得，号百平平台原值值传回，单单位：分分USERRIDSP用户户IDCHARR(400)是SP平台台用
13、户IID，为为SP平平台用户户体系的的唯一标标识。号号百平台台原值传传回ATTAACHSP附加加信息CHARR(322)否从SP发发送的订订单的信信息中获获得，号百平平台原值值传回SIGNN数字签名名CHARR(2556)是数字签名名算法由由号百平平台统一一提供，作作为核查查依据说明：1、 商户提供供的后台台urll，号百百平台是是以poost方方式将支支付结果果提交到到该urrl上2、 商户平台台在收到到后台支支付结果果后，请请直接在在应答时时写入格格式为UUPTRRANSSEQ_XXXXXXXX的字符符串，其其中UPPTRAANSEEQ_ 为固定定写死，XXXXXX为号百平台发送过去的号百
14、平台交易流水号3、 号百平台台，如果果在600秒钟没没有收到到应答，则则会重复复发送，重重复次数数是3次次，如果果还没有有应答会会每隔半半小时发发送一次次截止到到第二天天凌晨。4、 号百平台台如果收收到应答答，则不不再发送送支付结结果。5、 当商户收收到号百百平台发发回来的的支付结结果信息息后，获获取支付付结果和和签名的的信息，然然后对数数字签名名进行校校验，步步骤如下下：1）商户户将支付付结果的的明文和和密钥组成成一个固固定顺序序的串，如如下：BSTUUPTRRANSSEQ=200080110100000001&BSTTMERRCHAANTIID=00250000000011&ORDDERSSEQ=2000605501112566493315556&ORDDERAAMOUUNT=100000&RETTNCOODE=00000&RRETNNINFFO=000000&BSTTTRAANDAATE=2000601101&KEYY=12234556串的顺序序不能改改变，参参数名一一定要用用大写；KEY的的值由号号百平台台统一提提供。2）将11）获得得的结果果使用标标
