网上银行系统商户b2b信用支付接口手册

《网上银行系统商户b2b信用支付接口手册》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、中国工商银行网上银行系统—b2b信用支付接口商户手册中国工商银行软件开发中心CopyrightReserved2007年5月网上银行商户手册1.文档属性文档属性内容文档名称：网上银行系统商户b2b信用支付接口手册文档版本号：1.0文档状态：正式稿文档编写完成日期2007-5-232.文档变更历史清单文档版本号变更日期修改人变更内容简述©CopyrightICBCSDC2005.8-60-网上银行商户手册前言该文档说明了商户使用工行提供的API接口进行b2b信用支付一些相关交易时的通信方式，需要上送的数据和工行返回信息的格式。©CopyrightICBCSDC

2、2005.8-60-网上银行商户手册目录前言2目录31．商户端的接口41.1参数名及其内容列表4B2B信用支付-提前确认付款接口15请求数据格式15返回数据格式16B2B信用支付-商城提交仲裁请求接口19请求数据格式19返回数据格式21B2B信用支付-商城提交仲裁撤销接口24请求数据格式24返回数据格式25B2B信用支付-仲裁通知接口28请求数据格式28返回数据格式30B2B信用支付-查询接口33请求数据格式33返回数据格式34商户延长支付到期日37请求数据格式37返回数据格式39B2B信用支付-商城提交退款请求接口42请求数据格式42返回数据格式43B2B

3、信用支付-商城提交退款撤销接口46请求数据格式46返回数据格式48B2B信用支付-退款通知接口51请求数据格式51返回数据格式531.2一个链接例子561.3签名部分的说明561.4银行反馈信息的接口571.4.1通知消息接口数据格式581.4.2通知消息处理过程601.5注意事项621.6错误代码含义631.7指令状态含义631.8商户端开发的例子64©CopyrightICBCSDC2005.8-60-网上银行商户手册1．商户端的接口商户端接口分为两种，一种是非api接口，这类接口的入口是/servlet/ICBCINBSCreditPayCustReq

4、Servlet；一种是api接口，这类接口的入口是/servlet/ICBCINBSCreditPayReqServlet。非api接口比较少，已经在交易中标明，未标明的都是api接口，请根据标注选择对应的入口地址。对于非api接口，商户将请求数据提交到指定地址即可。对于api接口，商户需要实现双向的ssl与工行服务器建立连接，发送请求数据并接收银行的返回数据。建立ssl连接时使用商户的api证书（文件名类似****.e.****的软证书）。指定url的格式：https://*.*.*.*/入口servlet，（注意使用工行企业网银的地址，请联系所在地分行确

5、认投产环境和测试环境的IP地址）。1.1参数名及其内容列表B2B信用支付-交易请求接口(非api)请求数据格式使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXXXXXX表示base64编码的xml格式的字符串请求数据中的xml包格式：Xml格式字段说明：变量名称变量命名长度定义（以字节为单位）说明接口名称interfaceName=26必输，取值：“ICBC_CORPORBANK_CREDIT_PREPARE_PAY”接口版本号interfaceVersion=7必输，取值：“1.0.0.0”订单号orderIDMAX(30)必输，

6、客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。©CopyrightICBCSDC2005.8-60-网上银行商户手册商户代码merIDMAX(20)必输，唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。订单日期时间merTranTime=14必输，格式为：YYYYMMDDHHmmss要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。其他商户接口中都需要上送此时间检验联名标志verifyJoinFlag=1必输，固定上送2卖家账号selle

7、rAcctMAX(19)必输，卖家户名sellerNameMAX(60)必输，注意是60字节商户手续费入账账号merAcctNumMAX(19)必输，手续费入账账户户名merAcctNameMAX(60)必输，订单金额AmountMAX(10)必输，客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。币种currTypeMAX(3)默认人民币“001”有效期长度orderPeriodMAX(4)由于商户和银行存在时间差，要求商户提交有效期长度，银行根据自己时间计算到期日单位小时最小值：24小时最大值：360小时，即15天已含运费金额

8、carriageAmtMAX(18)选输以分为单位商