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

—b2b信用支付接口 中国工商银行软件开发中心 Copyright Reserved 2007年5月 文档属性 文档属性 内容 文档名称： 网上银行系统商户b2b信用支付接口手册 文档版本号： 1.0 文档状态： 正式稿 文档编写完成日期 2007-5-23 文档变更历史清单 文档版本号 变更日期 修改人 变更内容简述 前 言 该文档说明了商户使用工行提供的API接口进行b2b信用支付一些相关交易时的通信方式，需要上送的数据和工行返回信息的格式。 目 录 前 言 2 目 录 3 1．商户端的接口 4 1.1参数名及其内容列表 4 B2B信用支付-提前确认付款接口 15 请求数据格式 15 返回数据格式 16 B2B信用支付-商城提交仲裁请求接口 19 请求数据格式 19 返回数据格式 21 B2B信用支付-商城提交仲裁撤销接口 24 请求数据格式 24 返回数据格式 25 B2B信用支付-仲裁通知接口 28 请求数据格式 28 返回数据格式 30 B2B信用支付-查询接口 33 请求数据格式 33 返回数据格式 34 商户延长支付到期日 37 请求数据格式 37 返回数据格式 39 B2B信用支付-商城提交退款请求接口 42 请求数据格式 42 返回数据格式 43 B2B信用支付-商城提交退款撤销接口 46 请求数据格式 46 返回数据格式 48 B2B信用支付-退款通知接口 51 请求数据格式 51 返回数据格式 53 1.2一个链接例子 56 1.3签名部分的说明 56 1.4银行反馈信息的接口 57 1.4.1通知消息接口数据格式 58 1.4.2通知消息处理过程 60 1.5 注意事项 62 1.6 错误代码含义 63 1.7指令状态含义 63 1.8商户端开发的例子 64 1．商户端的接口 商户端接口分为两种，一种是非api接口，这类接口的入口是/servlet/ICBCINBSCreditPayCustReqServlet；一种是api接口，这类接口的入口是/servlet/ICBCINBSCreditPayReqServlet。非api接口比较少，已经在交易中标明，未标明的都是api接口，请根据标注选择对应的入口地址。 对于非api接口，商户将请求数据提交到指定地址即可。 对于api接口，商户需要实现双向的ssl与工行服务器建立连接，发送请求数据并接收银行的返回数据。建立ssl连接时使用商户的api证书（文件名类似****.e.****的软证书）。 指定url的格式：https://*.*.*.*/入口servlet，（注意使用工行企业网银的地址，请联系所在地分行确认投产环境和测试环境的IP地址）。 1.1参数名及其内容列表 B2B信用支付-交易请求接口(非api) 请求数据格式 使用form方式提交，提交数据名称是CREDIT_PAY_DATA=XXXX XXXX表示base64编码的xml格式的字符串 请求数据中的xml包格式： Xml格式字段说明： 变量名称 变量命名 长度定义（以字节为单位） 说明 接口名称 interfaceName =26 必输， 取值：“ICBC_CORPORBANK_CREDIT_PREPARE_PAY” 接口版本号 interfaceVersion =7 必输， 取值：“” 订单号 orderID MAX(30) 必输， 客户支付后商户网站产生的一个唯一的定单号，该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期时间来唯一确认一笔订单的重复性。 商户代码 merID MAX(20) 必输， 唯一确定一个商户的代码，由商户在工行开户时，由工行告知商户。 订单日期时间 merTranTime =14 必输， 格式为：YYYYMMDDHHmmss 要求在银行系统当前时间的前3小时和后3小时范围内，否则判定交易时间非法。 其他商户接口中都需要上送此时间 检验联名标志 verifyJoinFlag =1 必输， 固定上送2 卖家账号 sellerAcct MAX(19) 必输， 卖家户名 sellerName MAX(60) 必输， 注意是60字节 商户手续费入账账号 merAcctNum MAX(19) 必输， 手续费入账账户户名 merAcctName MAX(60) 必输， 订单金额 Amount MAX(10) 必输， 客户支付订单的总金额，一笔订单一个，以分为单位。不可以为零，必需符合金额标准。 币种 currType MAX(3) 默认人民币“001” 有效期长度 order