中国工商银行网上银行BC在线支付接口说明新版本精品文档23页
中国工商银行银企互联系统接口说明Version 4.3之欧阳家百创编
中国工商银行银企欧阳家百(2021.03.07)互联系统接口说明Version 4.2中国工商银行电子银行部中国工商银行北京软件研发部2005年07月目录1帐户查询11.1单帐户余额查询1提交包1返回包11.2多帐户余额查询2提交包2返回包31.3当日明细查询4提交包4返回包51.4历史明细查询6提交包6返回包71.5现金管理户当日明细查询8提交包8返回包91.6现金管理户历史明细查询10提交包10返回包112转帐支付(逐笔)13支付提交包13支付返回包15逐笔支付查询提交包16逐笔支付查询返回包163企业财务室173.1财务室批量指令17提交包18返回包193.2财务室批量指令查询20提交包20返回包214收费站224.1批量扣个人指令22提交包22返回包234.2批量扣个人指令查询24提交包24返回包254.3缴费个人信息查询26提交包26返回包274.4批量扣企业指令28提交包28返回包294.5批量扣企业指令查询30提交包30返回包304.6缴费企业信息查询(只查已签订协议的)32提交包32返回包325批量代理汇兑335.1代理汇兑指令提交33提交包33返回包355.2代理汇兑指令查询36提交包36返回包365.3网点信息下载38提交包386批量外汇汇款396.1集团内外汇资金调拨指令提交39提交包40返回包416.2集团内外汇资金调拨指令查询41提交包41返回包426.3B股资金清算指令提交43提交包43返回包456.4B股资金清算指令查询45提交包45返回包466.5国内外汇汇款指令提交47提交包47返回包496.6国内外汇汇款指令查询49提交包49返回包507电子商务517.1B2C订购指令查询51提交包517.2B2C退货、返还、转付指令查询54提交包54返回包557.3B2B订购指令查询57提交包57返回包587.4B2B退货、返还指令查询59提交包59返回包607.5C2C订购指令查询62提交包62返回包637.6B2B/B2C退货、返还、转付指令提交64提交包64返回包657.7个人联名卡签权指令66提交包67返回包678工资单688.1工资单文件上传68提交包68返回包708.2工资单文件查询71提交包71返回包718.3工资单文件删除72提交包72返回包739附录错误代码749.1明文返回的错误代码749.2xml中retCode的错误代码741帐户查询1.1 单帐户余额查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceOp</opName><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur> 例:RMB<retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>1.2 多帐户余额查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceListOp</opName><ReqParam><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam><ReqParamSet><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><ReqReserved3>请求包备用字段3</ReqReserved3><ReqReserved4>请求包备用字段4</ReqReserved4></ReqParam></ReqParamSet></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceListOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet><ErrSet><Err><Account_num>账号</Account_num><errMessage>出错信息</errMessage></Err></ErrSet></opRep></ICBCYH>1.3 当日明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_date>交易日期</Trans_date>(例:yyyy-MM-dd-HH:mm:ss:6位毫秒)共26位<Check_num>凭证号</Check_num><Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.4 历史明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项(例:yyyyMMdd)<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项(以分为单位,不带小数点)<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Trans_date>交易日期</Trans_date> (例:yyyyMMdd)<Check_num>凭证号</Check_num><Trans_abstr>摘要</Trans_abstr><Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Rec_Account_num>对方账号</Rec_Account_num><Bank_name>开户行名称</Bank_name><Bank1_name>对方行行名</Bank1_name><Unit1_name>对方单位名称</Unit1_name><Trans_type>业务种类</Trans_type> 中文<Yt>用途</Yt><Trans_time>交易时间</Trans_time>(例:yyyy-MM-dd-HH:mm:ss:6位毫秒)共26位其值与当日明细中“交易日期”字段值一致<sign>借贷标志</sign> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.5 现金管理户当日明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_time>交易时间</Trans_time> HH:mm:ss<Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.6 现金管理户历史明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项(例:yyyyMMdd)<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项(以分为单位,不带小数点)<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><TRXTYPE>交易类型</TRXTYPE> 中文<BUSIDATE>交易日期</BUSIDATE> yyyyMMdd<BUSITIME>交易时间</BUSITIME> HH:mm:ss<Account_num>交易帐号</Account_num><Bank_name>本方行名</Bank_name><Trans_type>业务种类</Trans_type> 中文<sign>借贷标志</sign> 中文<Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Yt>用途</Yt><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><RECIPACT>对方帐号</RECIPACT><RECIPNAME>对方户名</RECIPNAME><RECIPBNA>对方行名</RECIPBNA><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>2转帐支付(逐笔)支付提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCpaySubmitOp</opName><ReqParam><Pay_Dep_name>汇款单位</Pay_Dep_name><Pay_Dep_Acc>汇款帐号</Pay_Dep_Acc> (35位)---必输项<Area_code>地区代码</Area_code><Pay_Dep_branch>汇款单位开户行</Pay_Dep_branch><Rec_Dep_name>收款单位</Rec_Dep_name> (60位) ---必输项<Rec_Dep_Acc>收款帐号</Rec_Dep_Acc> (35位) ---必输项<Rec_Area_Code>收款人地区代码</Rec_Area_Code> 0:它行 1:工行<Rec_Dep_branch>收款单位开户行</Rec_Dep_branch>(60位)--必输项<Trans_time>交易时间</Trans_time><Serial_no>指令序号</Serial_no><PayAmt>金额</PayAmt> (18位) ---必输项以分为单位<Account_cur>币种</Account_cur><Pay_Use>用途</Pay_Use> (20位)<Pay_type>汇款速度</Pay_type> 0:普通1:加急<Author_log_id_1>授权人ID</Author_log_id_1><Author_log_id_2>二次授权人ID</Author_log_id_2> <Submit_Log_id>提交人ID</Submit_Log_id> ---必输项<Area_name>付款人账户地区名(付款人所在地) </Area_name><Rec_Area_name>收款人账户地区名(收款人所在地) </Rec_Area_name>---必输项收方如果是工行,以《信息对照表》中的地区代码对照表为准<Branch_code>账户分理处号</Branch_code><Pay_Password>支付密码</Pay_Password><User_Rem>备注栏(用户备注) </User_Rem><Pay_NetCode>付款行网点号</Pay_NetCode><Pay_BranchNo>付款行行号</Pay_BranchNo><Pay_BranchId>付款行行标识</Pay_BranchId><Pay_DispsNo>付款行分签号</Pay_DispsNo><Rec_BranchNo>对方行号</Rec_BranchNo><Rec_BranchId>对方行标识</Rec_BranchId><Rec_DispsNo>对方分签号</Rec_DispsNo><PostScript>附言</PostScript><PostScriptFlag>附言标志</PostScriptFlag><Transfer_Type>转帐类型</Transfer_Type><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID(15位)</PackageID> ---必输项<SignTime>签名时间(yyyyMMddhhmmssSSS)</SignTime> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>支付返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCpaySubmitOp</opName><opResult><retCode>返回码</retCode>0-成功1-可疑其他为失败,错误描述在errMsg 中<errMsg>错误描述</errMsg><TranFlag>成功描述</TranFlag><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>逐笔支付查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryPayOrderDetailOp</opName><ReqParam><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项(提交指令中的包ID)<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>逐笔支付查询返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryPayOrderDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode>此值只表示该交易是否执行成功,并不代表此笔支付是否成功或失败(非空表示交易执行失败,失败原因见errMsg)。
中国银行B2C商户端接口说明(ver 2.3)
X(13)
必填
格式:整数位不前补零,小数位补齐2位
即:不超过10位整数位+1位小数点+2位小数
无效格式如123,.10,1.1,有效格式如1.00,0.10
06
订单时间
orderTime
9(14)
必填
格式:YYYYMMDD24HHMMSS
其中时间为24小时格式,如下午3点15表示为151500
2.2.4
接口名称:无
接口说明:
为避免银行支付界面反馈支付结果失效,中行支付网关按此数据规格将B2C订单支付结果主动通过HTTP或HTTPS方式POST发往商户系统。参数的编码方式使用UTF-8编码后,再用application/x-www-form-urlencoded方式转译后发出。
数据项说明:
格式:n.n.n.n
其中n为0-255的数字
例如:192.168.0.1
09
客户浏览器Refer信息
orderRefer
X(200)
客户浏览器跳转至网银支付登录界面前所在页面的URL(urlEncode格式)
10
银行交易流水号
bankTranSeq
X(22)
银行交易流水号
银行交易日期(8位)+POS终端号(8位)+POS流水号(6位)
数据项说明:
序号
名称
字段
最大长度
说明
01
商户号
merchantNo
X(20)
BOC商户ID
02
商户订单号
orderNo
X(19)
商户系统产生的订单号
03
银行订单流水号
orderSeq
企业网银在线支付说明
企业网银在线支付 说明
XX,
汇报人:XX
时间:20XX-XX-XX
目录
01
添加标题
02
03
04
05
06
企业网银在线 支付概述
企业网银在线 支付的开通与 使用
企业网银在线 支付的常见问 题与解决方案
企业网银在线 支付的风险与 防范
企业网银在线 支付的发展趋 势与未来展望
PRT 1
问题:支付失败 解决方案:确认账户余额充足,检查 支付信息是否正确,联系银行客服解决 解决方案:确认账户余额充足,检查支付信息是否正确,联系银 行客服解决
问题:无法查询交易记录 解决方案:确认登录信息正 确,联系银行客服解决 解决方案:确认登录信息正确,联系银行客服解决
问题:无法下载电子回单 解决方案:确认登录信息正 确,联系银行客服解决 解决方案:确认登录信息正确,联系银行客服解决
企业网银在线支付的安全保障措施
密码保护:设置高强度的登录密码和支付密码 安全认证:通过短信验证码、U盾等安全工具进行身份验证 数据加密:采用SSL加密技术,确保数据传输的安全性 风险监控:实时监控账户异常行为,及时发现并处理风险事件 安全培训:定期对员工进行安全培训,提高安全意识和防范能力
企业网银在线支付的限额设置
政策法规变化:政府将加强对企业网银在线支付的监管,推动行业 规范发展,保障用户权益。
THNK YOU
汇报人:XX
汇报时间:20XX/01/01
限额设置目的:保障企业资金安全 限额类型:单笔限额、日累计限额、月累计限额 限额调整:企业可根据自身需求调整限额 限额提醒:系统会自动提醒用户限额情况,避免超限操作
P企R业T网银4 在线支付的常见问题
中国工商银行银企互联系统接口说明Version.3
中国工商银行银企互联系统接口说明Version中国工商银行电子银行部中国工商银行北京软件研发部2005年07月目录提交包...............................................................网点信息下载...................................................... 提交包...............................................................个人联名卡签权指令................................................1帐户查询1.1单帐户余额查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceOp</opName><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur> 例:RMB<retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>1.2多帐户余额查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceListOp</opName><ReqParam><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam><ReqParamSet><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><ReqReserved3>请求包备用字段3</ReqReserved3><ReqReserved4>请求包备用字段4</ReqReserved4></ReqParam></ReqParamSet></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceListOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4> </opResult></opResultSet><ErrSet><Err><Account_num>账号</Account_num><errMessage>出错信息</errMessage></Err></ErrSet></opRep></ICBCYH>1.3当日明细查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_date>交易日期</Trans_date>(例:yyyy-MM-dd-HH:mm:ss:6位毫秒)共26位<Check_num>凭证号</Check_num><Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4> </opResult></opResultSet></opRep></ICBCYH>1.4历史明细查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项(例:yyyyMMdd)<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项(以分为单位,不带小数点)<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Trans_date>交易日期</Trans_date> (例:yyyyMMdd)<Check_num>凭证号</Check_num><Trans_abstr>摘要</Trans_abstr><Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Rec_Account_num>对方账号</Rec_Account_num><Bank_name>开户行名称</Bank_name><Bank1_name>对方行行名</Bank1_name><Unit1_name>对方单位名称</Unit1_name><Trans_type>业务种类</Trans_type> 中文<Yt>用途</Yt><Trans_time>交易时间</Trans_time>(例:yyyy-MM-dd-HH:mm:ss:6位毫秒)共26位其值与当日明细中“交易日期”字段值一致<sign>借贷标志</sign> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.5现金管理户当日明细查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_time>交易时间</Trans_time> HH:mm:ss<Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4> </opResult></opResultSet></opRep></ICBCYH>1.6现金管理户历史明细查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项(例:yyyyMMdd)<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项(以分为单位,不带小数点)<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><TRXTYPE>交易类型</TRXTYPE> 中文<BUSIDATE>交易日期</BUSIDATE> yyyyMMdd<BUSITIME>交易时间</BUSITIME> HH:mm:ss<Account_num>交易帐号</Account_num><Bank_name>本方行名</Bank_name><Trans_type>业务种类</Trans_type> 中文<sign>借贷标志</sign> 中文<Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Yt>用途</Yt><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><RECIPACT>对方帐号</RECIPACT><RECIPNAME>对方户名</RECIPNAME><RECIPBNA>对方行名</RECIPBNA><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>2转帐支付(逐笔)支付提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCpaySubmitOp</opName><ReqParam><Pay_Dep_name>汇款单位</Pay_Dep_name><Pay_Dep_Acc>汇款帐号</Pay_Dep_Acc> (35位)---必输项<Area_code>地区代码</Area_code><Pay_Dep_branch>汇款单位开户行</Pay_Dep_branch><Rec_Dep_name>收款单位</Rec_Dep_name> (60位) ---必输项<Rec_Dep_Acc>收款帐号</Rec_Dep_Acc> (35位) ---必输项<Rec_Area_Code>收款人地区代码</Rec_Area_Code> 0:它行1:工行<Rec_Dep_branch>收款单位开户行</Rec_Dep_branch>(60位)--必输项<Trans_time>交易时间</Trans_time><Serial_no>指令序号</Serial_no><PayAmt>金额</PayAmt> (18位) ---必输项以分为单位<Account_cur>币种</Account_cur><Pay_Use>用途</Pay_Use> (20位)<Pay_type>汇款速度</Pay_type> 0:普通 1:加急<Author_log_id_1>授权人ID</Author_log_id_1><Author_log_id_2>二次授权人ID</Author_log_id_2> <Submit_Log_id>提交人ID</Submit_Log_id> ---必输项 <Area_name>付款人账户地区名(付款人所在地)</Area_name><Rec_Area_name>收款人账户地区名(收款人所在地)</Rec_Area_name>---必输项收方如果是工行,以《信息对照表》中的地区代码对照表为准<Branch_code>账户分理处号</Branch_code><Pay_Password>支付密码</Pay_Password><User_Rem>备注栏(用户备注) </User_Rem><Pay_NetCode>付款行网点号</Pay_NetCode><Pay_BranchNo>付款行行号</Pay_BranchNo><Pay_BranchId>付款行行标识</Pay_BranchId><Pay_DispsNo>付款行分签号</Pay_DispsNo><Rec_BranchNo>对方行号</Rec_BranchNo><Rec_BranchId>对方行标识</Rec_BranchId><Rec_DispsNo>对方分签号</Rec_DispsNo><PostScript>附言</PostScript><PostScriptFlag>附言标志</PostScriptFlag><Transfer_Type>转帐类型</Transfer_Type><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID(15位)</PackageID> ---必输项<SignTime>签名时间(yyyyMMddhhmmssSSS)</SignTime> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>支付返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCpaySubmitOp</opName><opResult><retCode>返回码</retCode>0-成功1-可疑其他为失败,错误描述在errMsg 中<errMsg>错误描述</errMsg><TranFlag>成功描述</TranFlag><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>逐笔支付查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryPayOrderDetailOp</opName><ReqParam><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项(提交指令中的包ID)<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>逐笔支付查询返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryPayOrderDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode>此值只表示该交易是否执行成功,并不代表此笔支付是否成功或失败(非空表示交易执行失败,失败原因见errMsg)。
中国工商银行银企互联系统接口说明V
中国工商银行银企互联系统接口说明Version 4.2中国工商银行电子银行部中国工商银行北京软件研发部2005年07月目录1 帐户查询 (1)1.1 单帐户余额查询 (1)提交包 (1)返回包 (1)1.2 多帐户余额查询 (2)提交包 (2)返回包 (3)1.3 当日明细查询 (4)提交包 (4)返回包 (5)1.4 历史明细查询 (6)提交包 (6)返回包 (7)1.5 现金管理户当日明细查询 (9)提交包 (9)返回包 (9)1.6 现金管理户历史明细查询 (11)提交包 (11)返回包 (12)2 转帐支付(逐笔) (13)支付提交包 (13)支付返回包 (15)逐笔支付查询提交包 (16)逐笔支付查询返回包 (16)3 企业财务室 (17)3.1 财务室批量指令 (17)提交包 (17)返回包 (19)3.2 财务室批量指令查询 (20)提交包 (20)返回包 (20)4 收费站 (22)4.1 批量扣个人指令 (22)提交包 (22)返回包 (23)4.2 批量扣个人指令查询 (24)提交包 (24)返回包 (24)4.3 缴费个人信息查询 (26)提交包 (26)返回包 (27)4.4 批量扣企业指令 (28)提交包 (28)返回包 (29)4.5 批量扣企业指令查询 (29)提交包 (30)返回包 (30)4.6 缴费企业信息查询(只查已签订协议的) (31)提交包 (32)返回包 (32)5 批量代理汇兑 (33)5.1 代理汇兑指令提交 (33)提交包 (33)返回包 (35)5.2 代理汇兑指令查询 (36)提交包 (36)返回包 (36)5.3 网点信息下载 (38)提交包 (38)返回包 (38)6 批量外汇汇款 (39)6.1 集团内外汇资金调拨指令提交 (39)提交包 (40)返回包 (41)6.2 集团内外汇资金调拨指令查询 (41)提交包 (41)返回包 (42)6.3 B股资金清算指令提交 (43)提交包 (43)返回包 (45)6.4 B股资金清算指令查询 (45)提交包 (45)返回包 (46)6.5 国内外汇汇款指令提交 (47)提交包 (47)返回包 (49)6.6 国内外汇汇款指令查询 (49)提交包 (49)返回包 (50)7 电子商务 (51)7.1 B2C订购指令查询 (51)提交包 (51)返回包 (52)7.2 B2C退货、返还、转付指令查询 (54)提交包 (54)返回包 (55)7.3 B2B订购指令查询 (57)提交包 (57)返回包 (58)7.4 B2B退货、返还指令查询 (59)提交包 (59)返回包 (60)7.5 C2C订购指令查询 (62)提交包 (62)返回包 (63)7.6 B2B/B2C退货、返还、转付指令提交 (64)提交包 (64)返回包 (65)7.7 个人联名卡签权指令 (67)提交包 (67)返回包 (67)8 工资单 (68)8.1 工资单文件上传 (68)提交包 (68)返回包 (70)8.2 工资单文件查询 (70)提交包 (71)返回包 (71)8.3 工资单文件删除 (72)提交包 (72)返回包 (73)9 附录错误代码 (74)9.1 明文返回的错误代码 (74)9.2 xml中retCode的错误代码 (74)1帐户查询1.1 单帐户余额查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceOp</opName><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur> 例:RMB<retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>1.2 多帐户余额查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceListOp</opName><ReqParam><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam><ReqParamSet><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><ReqReserved3>请求包备用字段3</ReqReserved3><ReqReserved4>请求包备用字段4</ReqReserved4></ReqParam></ReqParamSet></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceListOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4> </opResult></opResultSet><ErrSet><Err><Account_num>账号</Account_num><errMessage>出错信息</errMessage></Err></ErrSet></opRep></ICBCYH>1.3 当日明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_date>交易日期</Trans_date>(例:yyyy-MM-dd-HH:mm:ss:6位毫秒)共26位<Check_num>凭证号</Check_num><Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.4 历史明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项(例:yyyyMMdd)<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项(以分为单位,不带小数点)<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Trans_date>交易日期</Trans_date> (例:yyyyMMdd)<Check_num>凭证号</Check_num><Trans_abstr>摘要</Trans_abstr><Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Rec_Account_num>对方账号</Rec_Account_num><Bank_name>开户行名称</Bank_name><Bank1_name>对方行行名</Bank1_name><Unit1_name>对方单位名称</Unit1_name><Trans_type>业务种类</Trans_type> 中文<Yt>用途</Yt><Trans_time>交易时间</Trans_time>(例:yyyy-MM-dd-HH:mm:ss:6位毫秒)共26位其值与当日明细中“交易日期”字段值一致<sign>借贷标志</sign> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.5 现金管理户当日明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2> </opResult><opResultSet><opResult><Trans_time>交易时间</Trans_time> HH:mm:ss<Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4> </opResult></opResultSet></opRep></ICBCYH>1.6 现金管理户历史明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项(例:yyyyMMdd)<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项(以分为单位,不带小数点)<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode> <errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><TRXTYPE>交易类型</TRXTYPE> 中文<BUSIDATE>交易日期</BUSIDATE> yyyyMMdd<BUSITIME>交易时间</BUSITIME> HH:mm:ss<Account_num>交易帐号</Account_num><Bank_name>本方行名</Bank_name><Trans_type>业务种类</Trans_type> 中文<sign>借贷标志</sign> 中文<Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Yt>用途</Yt><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><RECIPACT>对方帐号</RECIPACT><RECIPNAME>对方户名</RECIPNAME><RECIPBNA>对方行名</RECIPBNA><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>2转帐支付(逐笔)支付提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCpaySubmitOp</opName><ReqParam><Pay_Dep_name>汇款单位</Pay_Dep_name><Pay_Dep_Acc>汇款帐号</Pay_Dep_Acc> (35位)---必输项<Area_code>地区代码</Area_code><Pay_Dep_branch>汇款单位开户行</Pay_Dep_branch><Rec_Dep_name>收款单位</Rec_Dep_name> (60位) ---必输项<Rec_Dep_Acc>收款帐号</Rec_Dep_Acc> (35位) ---必输项<Rec_Area_Code>收款人地区代码</Rec_Area_Code> 0:它行 1:工行<Rec_Dep_branch>收款单位开户行</Rec_Dep_branch>(60位)--必输项<Trans_time>交易时间</Trans_time><Serial_no>指令序号</Serial_no><PayAmt>金额</PayAmt> (18位) ---必输项以分为单位<Account_cur>币种</Account_cur><Pay_Use>用途</Pay_Use> (20位)<Pay_type>汇款速度</Pay_type> 0:普通 1:加急<Author_log_id_1>授权人ID</Author_log_id_1><Author_log_id_2>二次授权人ID</Author_log_id_2> <Submit_Log_id>提交人ID</Submit_Log_id> ---必输项 <Area_name>付款人账户地区名(付款人所在地) </Area_name><Rec_Area_name>收款人账户地区名(收款人所在地) </Rec_Area_name> ---必输项收方如果是工行,以《信息对照表》中的地区代码对照表为准<Branch_code>账户分理处号</Branch_code><Pay_Password>支付密码</Pay_Password><User_Rem>备注栏(用户备注) </User_Rem><Pay_NetCode>付款行网点号</Pay_NetCode><Pay_BranchNo>付款行行号</Pay_BranchNo><Pay_BranchId>付款行行标识</Pay_BranchId><Pay_DispsNo>付款行分签号</Pay_DispsNo><Rec_BranchNo>对方行号</Rec_BranchNo><Rec_BranchId>对方行标识</Rec_BranchId><Rec_DispsNo>对方分签号</Rec_DispsNo><PostScript>附言</PostScript><PostScriptFlag>附言标志</PostScriptFlag><Transfer_Type>转帐类型</Transfer_Type><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID(15位)</PackageID> ---必输项<SignTime>签名时间(yyyyMMddhhmmssSSS)</SignTime> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>支付返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCpaySubmitOp</opName><opResult><retCode>返回码</retCode>0-成功1-可疑其他为失败,错误描述在errMsg 中<errMsg>错误描述</errMsg><TranFlag>成功描述</TranFlag><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2> </opResult></opRep></ICBCYH>逐笔支付查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryPayOrderDetailOp</opName><ReqParam><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项(提交指令中的包ID)<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>逐笔支付查询返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryPayOrderDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode>此值只表示该交易是否执行成功,并不代表此笔支付是否成功或失败(非空表示交易执行失败,失败原因见errMsg)。
BC支付网关接入方案
B2C支付网关接入方案一、支付宝1、个人帐户接入A)申请支付宝。
B)实名认证和银行卡认证(需要身份证扫描件和银行卡)。
C)签署支付协议。
个人帐户需提供信息如下图:资费:你要和支付宝签订协议,才有交易安全校验码(key),有了这个,才可以使用,现在支付宝推出了免费集成的服务,手续费是1.5%2、企业帐户接入◆签约、开通流程第一步:确认合作套餐,并通知您的客户经理—吴伟军第二步:确认要用来收款的帐户,如没有帐户先新注册一个支付宝账户,注册地址:,注册完成后告知客户经理账户名称。
(企业注册实名认证需要营业执照,银行开户许可证)第三步:客户经理发起在线协议,然后您登录支付宝账户—商家服务—合同列表—特约商家服务协议—右侧“查看”点击后打开协议—右下角点“同意”—系统自动发起催款,在线支付预存款。
第四步:次日早上开始测试和安装接口。
支付宝免费提供技术支持。
快钱支付网关接入1)有自己的网站,网站需要通过ICP备案2)快钱帐户注册名称必须与ICP备案的名称一致,网站必须能打开。
3)在线注册(同时提交营业执照扫描件)4)银行账号待快钱审核后再绑定开通流程:登录快钱首页—点击注册企业用户—填写相关信息—上传营业执照副本—专人审核—审核通过发送帐户激活邮件—激活成功--登录快钱帐户—快钱工具—自助开通人民币网关—签定在线协议如资料都符合会发送产品支付密钥并在邮件中会有快钱的开发者平台下载代码范例使用我们提供的测试工具调试网关接口。
资费:快钱会收取每笔成功交易1%的标准费率(线下支付1元/笔)企业用户提现手续费为单笔0.1%最低5元,最高50元。
网银在线支付商户接口文档(B2C系统)
网银在线支付接口规范B2C系统商户接口平台版本号4.0网银在线(北京)科技有限公司目录1.文档介绍 (1)1.1. 读者对象 (1)1.2. 版权声明 (1)2.支付接口 (2)2.1. 商户>>> 网银在线支付 (2)2.2. 网银在线支付>>> 商户(页面返回) (5)2.3. 网银在线支付>>> 商户(服务器返回) (6)2.4. 网关错误编码表 (6)1.文档介绍1.1.读者对象商户系统设计人员、编程人员及测试人员1.2.版权声明此文档版权归网银在线(北京)科技有限公司所有。
作为本系统的最终用户,可以拥有该份文档的使用权,但未征得网银在线(北京)科技有限公司的书面批准,不得向第三方借阅、出让、出版该文档。
2.支付接口2.1.商户 >>> 网银在线支付示例程序:ChinaBank.html用途:收集信息并发送到数据发送页即Send页订单号://选填项,订单号收货人姓名://选填项,总长不超过80字符收货人地址://选填项,总长不超过200个字符收货人电话://选填项,总长不超过50个字符收货人邮编://选填项,总长不超过10个字符收货人邮件://选填项,总长不超过100个字符收货人手机号://选填项,总长不超过13个字符备注1://选填项,总长不超过150个字符订货人姓名://选填项,总长不超过80字符订货人地址://选填项,总长不超过200个字符订货人电话://选填项,总长不超过50个字符订货人邮编://选填项,总长不超过10个字符订货人邮件://选填项,总长不超过100个字符订货人手机号://选填项,总长不超过13个字符备注2://选填项,总长不超过150个字符订单总金额(元):*必填项,譬如:0.01示例程序:Send.asp、Send.aspx、Send.php、Send.jsp用途:接收ChinaBank.html发送过来的数据加密后发往网银在线电子支付平台的接口网关1、支付平台网关接口地址<form method=post action="https:///PayGate">2、FORM表单参数关,建议不用表1支付表单中的变量定义:—必填项—与网上支付货款无关项,建议不用表2MD5校验串生成方法:当消费者在商户端生成最终订单的时候,将订单中的v_amount v_moneytype v_oid v_mid v_url key六个参数的value值拼成一个无间隔的字符串(顺序不要改变)。
智付3.0网银支付接口文档
网银网关支付接口规范深圳市快汇宝信息技术有限公司版权所有侵权必究网银网关支付接口规范 (1)1. 概述 (3)1.1. 目的 (3)1.2. 术语与缩略语 (3)1.3. 适用范围 (3)1.4. 接口清单 (3)1.5. 典型业务流程 (4)1.6. 获取商户号和支付密钥 (4)2. 接口定义 (5)2.1. B2C支付交易接口 (5)2.1.1. 描述 (5)2.1.2. 接口参数定义 (5)2.1.3. 错误码定义 (7)2.2. 支付结果通知接口 (7)2.2.1. 描述 (7)2.2.2. 接口参数定义 (7)2.3. 单笔交易查询接口 (9)2.3.1. 描述 (9)2.3.2. 接口参数定义 (9)2.3.3. 响应参数定义 (9)2.4.附录 (11)2.4.1. 网关地址 (11)2.4.2. 签名规则定义 (11)2.4.3. 银行代码对照表 (11)2.4.4. 点卡直连代码对照表 (12)2.4.5. 错误码定义 (12)2.4.6. 常见问题 (15)1.概述1.1.目的本文档定义了如下接口:商户网站与智付支付平台间的B2C支付接口、商户网站与智付支付平台间的支付结果通知接口(包括:页面跳转同步通知接口、服务器后台异步通知接口)、商户网站与智付支付平台间的单笔交易查询接口。
1.2.术语与缩略语商户号:商户在智付平台注册的唯一标识账号。
商户密钥:商户与智付合作,商户可在商户后台(https://)自行设定的密钥,初始值为空。
密钥由数字、字母和下划线组成,不少于20位字符。
密钥是商家使用智付提供的加密控件对订单信息进行加密和签名、智付返回支付结果给商家的密文进行解密和验证签名的钥匙。
网银直连:用户在使用网银直连时,根据商户提交的银行代码直接跳转到对应的银行页面,省去了中间跳到第三方支付收银台选择银行这一步。
页面通知:智付获取数据处理完成之后,会在几秒之后(或者用户手动点击)从智付支付页面跳转至商户指定的页面,同时会携带处理完成之后的反馈信息,包含的信息和后台通知地址信息一致。
中国工商银行企业网银操作指南说明书
中国中国工商银行工商银行工商银行新加坡分行新加坡分行新加坡分行企业企业网银操作指南网银操作指南网银操作指南目录目录3 --......- 3......................................一、电子密码器激活................................5 --............- 5 ............................................二、网银登录................................9 --............- 9 三、功能概述............................................................................10 --...........- 10 ...........................................四、账户管理.......................................................................................... (10)A)账户信息查询................................ (11)..........................................................B)账户余额查询................................ (13)C)账户明细查询..........................................................................................15 --.......- 15.......................................五、公司内部转账................................17 --.....- 17 六、向公司外部转账.....................................................................19 --...........- 19 七、普通汇款......................................................................................- 2525 --...........................................八、工银速汇................................27 --...........- 27 ...........................................九、代发工资................................ (27)..........................................................A)工资明细文件................................ (30)..........................................................B)普通代发工资................................ (31)C)权限分离代发工资......................................................................................37 --..........- 37 十、工银信使..........................................................................定期存款十一、定期存款资金池管理十二、资金池管理一、 电子电子密码器激活密码器激活密码器激活首先确保您已经拿到电子密码器和激活码(内容如图)。
中国工商银行网上银行网上支付接口规范
中国工商银行网上银行网上支付接口规范B2C支付接口v1.0.0.3Copyright Reserved名目第1 章业务讲明2第2 章商户接口52.1 支付接口52.1.1 支付接口表单定义5 2.1.2 tranData数据定义6 2.1.3 tranData格式定义82.1.4 表单样例92.2 通知接口112.2.1 通知接口表单定义112.2.2 notifyData数据定义112.2.3 notifyData格式定义122.2.4 表单样例132.3 讲明14第3 章安全API讲明15第4 章开发步骤15业务讲明B2C在线支付接口实现工行个人网银客户在工行B2C商户网站进行消费支付的业务处理。
新的1.0.0.3版本同原先版本的要紧区不在于通知消息方式的改变。
原1.0.0.0版本和1.0.0.1版本(扩充语言字段以支持英文版)在订单中要求商户选择通知方式,即1、需要银行通知交易结果,2、不需要银行通知交易结果而是商户主动查询;当需要通知时,需要在订单中提供商户接收银行通知地址,当银行处理终止后,会在银行的后台服务器要求商户的此地址,将交易结果用http连接post表单形式提交给商户,然后返回客户交易结果页面。
新的1.0.0.3版本不再要求商户选择通知方式,和接收银行通知的地址;此版本要求商户在提交订单时,提供交易处理后返回商户的地址,即完成客户从商户转向到银行进行支付,处理后又从银行定向回商户网站的闭环。
在从银行交易页面返回商户时,将交易结果作为表单数据提交到商户此返回地址。
处理的优点:2、无需银行后台发送通知,客户不需要等待商户接收银行通知后才能看到交易结果页面,缩短响应时刻;143htt ps结果页面,如果还显现掉单咨询题,则可能是客户和商户的通讯等方面的以下简述处理流程:客户客户在商户网站扫瞄商品信息,签订订单;商户按照工行B2C支付1.0.0.3接口形成提交数据,并使用工行提供A PI和商户证书对订单数据签名,形成form表单返回客户扫瞄器,表单acti on地址指向工行接收商户订单信息的servlet;客户确认使用工行支付后,提交此表单到工行;工行网银系统接收此笔订单,对订单信息和商户信息进行检查;通过检查则显示工行支付页面,1.0.0.3版本会提示客户输入交易卡号;客户输入后提交;银行查询客户有关信息;返回客户在银行的预留信息;客户确认;返回交易确认页面;不同类型客户使用各自认证方式进行交易确认,支持静态支付密码、动态口令卡、证书签名;银行校验后进行支付处理;将结果形成通知消息并有银行端签名信息,返回客户端;引导客户返回商户网站,地址是订单中提供的商户url,此url支持htt p和https及自定义端口;B2C在线支付接口版本讲明:1.0.0.0(差不多支付)1.0.0.1(支持英文界面)1.0.0.2(内部保留)1.0.0.3(保留1.0.0.1功能,优化通知方式)1.0.0.4(商户订单中指定支付卡,不强制使用e卡支付,不承诺客户的支付卡透支支付,专门用于基金商户进行基金直销业务,同1.0.0.3通知方式)通知消息模式区不:原有模式:支付处理后,后台发送商户通知;新增模式:支付完成后或客户点击“返回商户”,利用客户扫瞄器跳转,完成商户通知的转发,后台不再单独发送商户通知。
网上银行系统商户API查询接口手册V1[1].1
中国工商银行网上银行系统——API查询接口(V6.0)中国工商银行软件开发中心Copyright Reserved2005年8月前言该文档说明了商户使用工行提供的API接口进行查询时的通信方式和需要上送的数据和工行返回信息的格式。
目录前言 (1)1.商户端的接口 (3)1.1参数名及其内容列表 (3)1.2一个链接例子 (7)2.银行反馈信息的接口 ...................................................................................... 错误!未定义书签。
1.商户端的接口商户实现双向的ssl与工行服务器建立连接。
建立ssl连接时使用商户的api 证书(文件名类似****.e.****的软证书)。
之后商户必须将查询上送数据用工行规定的格式以Form提交方式中的Post 方法,将数据提交到中国工商银行指定的API查询URL (https://*.*.*.*/servlet/ICBCINBSEBusinessServlet,严格区分大小写,请联系所在地分行确认投产环境和测试环境的IP地址)。
1.1参数名及其内容列表1.1.1 B2B订单交易状态查询的API接口1.1.1.1请求数据格式:请求数据中的xml包格式(注意:xml包中所有字段都是必输项):<?xml version="1.0" encoding="GBK" standalone="no" ?><ICBCAPI><in><orderNum>订单号</orderNum><tranDate>交易日期</ tranDate><ShopCode>商家号码</ShopCode><ShopAccount>商城账号</ShopAccount></in></ICBCAPI>1.1.1.2 返回数据格式注意:返回数据是经过了url编码的。
中国工商银行网上银行B2C在线支付API 接口
中国工商银行网上银行B2C在线支付接口说明一、B2C流程说明:1、客户在商户网站浏览商品信息,签订订单;2、商户按照工行B2C订单数据规范形成提交数据,并使用工行提供API和商户证书对订单数据签名,形成form表单返回客户浏览器,表单action地址指向工行接收商户B2C订单信息的servlet;3、客户确认使用工行支付后,提交此表单到工行;4、工行网银系统接收此笔B2C订单,对订单信息和商户信息进行检查,通过检查则显示工行B2C支付页面;5、客户在此页面可以查询客户在银行的预留信息;也可以输入支付卡号、支付密码、验证码进行B2C支付;6、工行检查客户信息,通过检查后显示确认页面;客户确认提交后工行进行支付指令处理;7、工行进行支付指令处理后,如果商户需要工行实时通知,则工行将处理结果使用http协议post方式将通知消息数据提交到商户网站(这个接收银行通知消息的商户端地址是随商户订单数据提交银行的merURL字段),商户返回取货地址或关闭这个银行与其建立的连接后,银行才显示交易结果页面给客户。
(注意1、发送通知和显示结果页面是串行的,所以商户端接收银行通知处理时间太长可能导致客户等待超时,造成银行不能将交易结果页面显示给客户。
2、此连接是银行服务器自动和商户进行的连接,商户返回也是直接返回给银行,商户端不能对银行的这个请求进行重定向。
)8、工行进行支付指令处理后,如果商户不需要工行实时通知,则工行直接显示交易结果给客户。
二、B2C接口数据说明:接口数据格式定义通过接口名称和接口版本号来标识,以便将来的扩展;以下数据格式为“1.0.0.1”版的“ICBC_PERBANK_B2C”接口定义。
2.1 B2C商户提交表单接口定义:其他同1.0.0.0版本2.2 商户提交表单签名merSignMsg格式:1、组织要签名的数据串(顺序固定;被商户签名的串为各输入项的值):接口名称的值+接口版本号的值+商城代码的值+商城账号的值+通知地址的值+通知类型的值+订单号的值+订单金额的值+支付币种的值+结果发送类型的值+交易日期时间的值+校验联名标志的值2、举例:以下是需要签名的数据名称及对应值interfaceName=ICBC_PERBANK_B2C&interfaceVersion=1.0.0.0&merID=0200EC20000012&merAcct=0200029109000030106&merU RL=/servlet¬ifyType=HS&orderid=000000001&amount=100 &curType=001 &resultType=0&orderDate=20050801192556& verifyJoinFlag=0需要签名的明文ICBC_PERBANK_B2C1.0.0.00200EC200000120200029109000030106.c n/servletHS0000000011000010200508011925560签名后(用测试私钥user.key )merSignMsg为SFVdS3Kca6d/wetLFwynBl1q5nDIyxxEUXCzniIa47mhxs1BM9mPsnRc2lOqqrfwBdwBjSE82jS/iBHYKol f2sppjEyOImVZycv96321QPDgPA1yleO83K1XA1rmB3zxsIuwLKIICSWwdttn1XPYOQLJ/WAtZ5DFYFog7J 8pXw0=merCert为(用测试证书user.crt)MIICVjCCAb+gAwIBAgIKI9fKEDP6AAAO3DANBgkqhkiG9w0BAQUFADA0MRgwFgYDVQQDEw9wYmouaWNiYy5 jb20uY24xGDAWBgNVBAoTD3Biai5pY2JjLmNvbS5jbjAeFw0yMDA5MjAwOTI3NDFaFw0yMTA5MjAwOTI3ND FaMEMxGDAWBgNVBAMTD2JpYW5sdTIyLmUuMDIwMDENMAsGA1UECxMEMDIwMDEYMBYGA1UEChMPcGJqLmljY mMuY29tLmNuMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDG+u/C5pad0ZbwvAk9Gv1rr+SpknfFUsTM hJLcI2KiYa+XLSf5vCib0OclOoDDXKIWPt/hkMEz+ED8YukQpsstXHvnxVFxVtPh23dubQjB8/kJ7X5Ebwn gsHMLFEXqr3UvNfcGZHuAFqMRPtr8ys3YnL3UG43Xienc3cD8jXFdQQIDAQABo2AwXjBLBgNVHR8ERDBCME CgPqA8pDowODEOMAwGA1UEAxMFY3JsMTMxDDAKBgNVBAsTA2NybDEYMBYGA1UEChMPcGJqLmljYmMuY29tL mNuMA8GA1UdYwQIAwYA/wAAAAAwDQYJKoZIhvcNAQEFBQADgYEAQe6tLhKaNX8OPNT2XzH7dTXIFmTm37hS vmbEL/Q/pWV386KVrNSCnyN3fowanMt5TE9qZFn9enVvyDJw4nAUx38F2PFn2Tt7JUtzt/pNKC5FiebpFJH 48AXIP1Xt5GjdcBx0oXM9QNBtYvY0189t357EH4UaBfO+c+L8fkOt37o=2.3 B2C通知商户交易结果接口定义:1.0.0.1版本(注意与C2C通知接口定义变量名区分)2.4 通知消息银行签名数据signMsg格式:1、组织要签名的数据串(顺序固定;银行通知消息签名的串为以下格式,请注意与商户签名串的格式不同):接口名称=值&接口版本号=值&订单号=值&指令序号=值&订单金额=值&支付币种=值&商城代码=值&商城账号=值&校验联名标志=值&客户联名标志=值&联名会员号=值&结果发送类型=值&交易日期时间=值&返回通知日期时间=值&订单处理状态=值&错误描述=值&备注1=值&备注2=值interfaceName=值&interfaceVersion=值&orderid=值&TranSerialNo=值&amount=值&curType=值&merID=值&merAcct=值&verifyJoinFlag=值&JoinFlag=值&UserNum=值&resultType=值&o r d e r D a t e=值&n o t i f y D a t e=值&t r a n S t a t=值&c o m m e n t=值&r e m a r k1=值&remark2=值举例:以下是需要验签的数据串明文interfaceName=ICBC_PERBANK_B2C&interfaceVersion=1.0.0.0&orderid=000000001&TranSeria lNo=&amount=100&curType=001&merID=0200EC20000012&merAcct=0200029109000030106&verify JoinFlag=0&JoinFlag=&UserNum=&resultType=0&orderDate=20050801192556¬ifyDate=2005 0824165910&tranStat=2&comment=failure,Error_code:32147ErrorMsg:提交支付表单时间数据不在有效时间范围。
接口文档说明示例
支付网关说明文档by:Q294500001目录##联盟支付网关说明文档........................................................................ 错误!未定义书签。
目录 .. (1)第一章文档描述.............................................................................................. 错误!未定义书签。
1、文档说明 (1)2、阅读对象 (1)第二章系统原理 (2)1、术语定义 (2)2、消费流程 (2)3、查询流程 (2)4、系统加密 (2)第三章网银接口定义 (3)1、同步过程接口定义(商户系统发起请求) (3)2、下行异步通知过程接口定义(##联盟接口发起请求) (5)3、下行同步通知过程接口定义(##联盟接口发起请求) (7)第四章查询流程接口定义 (8)第五章订单外部查询独立网址...................................................................... 错误!未定义书签。
附录1:##联盟支付网关银行类型说明. (9)第一章文档描述1、文档说明本说明文档用于指导##联盟商户实现与##联盟网银接口的顺利对接。
请相关技术人员详细阅读本文档。
2、阅读对象商户开发人员。
第二章系统原理1、术语定义商户:指已独立拥有在线销售系统,并成为##联盟网银接口系统会员,且已使用或者将使用##联盟网银接口实现收付费或其他相关功能需求的企业或者个人。
外部接入接口:指##联盟通过统一的方式接受外部请求的接口。
商户系统:指使用##联盟外部接入接口的计算机系统,一般指商户所拥有的在线销售系统。
用户:指在商户系统内进行消费的企业或者个人。
商户ID:指##联盟为使用外部接入接口的商户统一分配的唯一标识。
在线支付网关接口说明
在线支付网关接口说明(总8页)--本页仅作为文档封面,使用时请直接删除即可----内页可以根据需求调整合适字体及大小--南京网乐天下购支付网关接口说明Version:Public date: 2008-09-25All copyright reserved1. 文档描述文档说明此文档用来指导银行支付网关开发人员与天下购电子商务支付网关系统的顺利对接。
请相关技术人员详细阅读本文档。
文中黑粗的内容表示要重点注意的内容。
版本接口基于HTTP协议实现,各种平台,只要支持HTTP协议,各种语言均可实现。
阅读对象天下购开发人员银行支付网关相关技术人员术语约定2. 业务功能描述作业流程简述1)商户根据用户的支付行为生成订单,包括商户号、订单号、金额、等支付要素,并提交付款请求。
(订单付款状态为未付款)2)用户支付成功以后,银行支付网关使用后台调用方式将支付结果实时通知给商户系统。
3)商户接收到银行支付网关的支付通知请求后,输出反馈信息给银行支付网关,并完成相关业务逻辑。
(订单付款状态为已付款)4)银行支付网关接收到商户返回的成功信息并完成相关业务处理后,再将用户引导回商户网站。
(订单付款状态为已结束)作业流程详述1)用户在商户系统上选择商品,确认提交订单付款。
2)商户系统根据用户选择商品,生成付款订单,包括商户号、订单信息、订单明细及相关签名信息,并提交到银行支付网关。
3)银行支付网关验证签名数据有效后,检查商户订单号,并向导用户完成支付操作…此处由各银行支付网关自由实现(登录,付款)。
4)用户完成支付操作后(冻结金额),银行支付网关使用后台调用方式将用户付款信息通知给商户系统。
通知中包含商户号、付款订单信息、付款订单明细及相关签名信息。
其中付款订单允许和商户系统中的订单不一致,因为用户积分可能不足以支付此次订单中的所有商品,所以允许用户在银行支付网关中选择部分商品进行支付。
注意商品只能从商户订单中进行选择,且价格等商品信息不能变更。
中国工商银行银企互联系统接口说明Version
中国工商银行银企互联系统接口说明Version 4.2中国工商银行电子银行部中国工商银行北京软件研发部2005 年 07 月目录返回包 .....................................................................1.6现金管理户历史明细查询..................................................提交包 .....................................................................提交包 .....................................................................4.6缴费企业信息查询(只查已签订协议的)5.3 网点信息下载..................................................................6.2 集团内外汇资金调拨指令查询..............................................提交包 .....................................................................提交包 .....................................................................7.7个人联名卡签权指令......................................................8.2 工资单文件查询...........................................................9.1 明文返回的错误代码......................................................1 帐户查询1.1单帐户余额查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceOp</opName><ReqParam><Area_code>地区代码v/Area_code>vAccount_num>帐号</Account_num> --- 必输项<Account_cur> 币种</Account_cur>vuserID> 企业代码(和证书里的一致)v/userID> --- 必输项<PackagelD>fe序列ID</PackagelD> ---必输项vReqReservedl;请求包备用字段1</ReqReserved1> <ReqReserved2>#求包备用字段2</ReqReserved2> v/ReqParam>v/opReq>v/ICBCYH>返回包v?xml version="1.0" encoding = "GB2312"?>vICBCYH>vopRep>vopName>NCQueryBalanceOpv/opName><opResult>vAcco unt_num>帐号v/Acco unt_num>vAccount_cur> 币种v/Account_cur> 例:RMB<retCode>错误返回码错误描述在errMsg中</retCode> <errMsg>错误描述</errMsg>vAcc_balance> 昨日余额v/Acc_balance><Bala nce> 余额</Bala nce>vUsable_balance> 可用余额v/Usable_balance> vAcct_property> 帐户属性v/Acct_property> 中文<PackagelD>fe序列ID</PackagelD>vuserID> 企业代码v/userID>vRepReservedl:返回包备用字段1</RepReserved1><RepReserved2:返回包备用字段2</RepReserved2> v/opResult> v/opRep>v/ICBCYH>1.2多帐户余额查询提交包v?xml version="1.0" encoding = "GB2312"?>vICBCYH>vopReq>vopName>NCQueryBalanceListOpv/opName> vReqParam><userID>企业代码(和证书里的一致)</userID> ---必输项<PackageID>&序列ID</PackagelD> ---必输项vReqReservedl;请求包备用字段1</ReqReserved1> <ReqReserved2>#求包备用字段2</ReqReserved2></ReqParam><ReqParamSet><ReqParam><Area_code>地区代码v/Area_code>vAccount_num>帐号</Account_num> --- 必输项<Account_cur> 币种</Account_cur><ReqReserved3>W求包备用字段3</ReqReserved3><ReqReserved4>#求包备用字段4</ReqReserved4> v/ReqParam> v/ReqParamSet>v/opReq>v/ICBCYH>返回包v?xml version="1.0" encoding = "GB2312"?>vICBCYH>vopRep>vopName>NCQueryBalanceListOpv/opName> vopResult><retCode>错误返回码错误描述在errMsg中</retCode> <errMsg>错误描述</errMsg><PackageID>&序列ID</PackagelD><userlD> 企业代码</userID>vRepReservedl:返回包备用字段1</RepReserved1> <RepReserved2:返回包备用字段2</RepReserved2> v/opResult>vopResultSet>vopResult><Acco unt_num>帐号</Acco unt_num><Account_cur> 币种</Account_cur><Acc_balance> 昨日余额</Acc_balance> vBala nce> 余额v/Bala nce><Usable_balance> 可用余额</Usable_balance> vAcct_property>帐户属性v/Acct_property> 中文<RepReserved3>^回包备用字段3</RepReserved3><RepReserved4>^回包备用字段4</RepReserved4> v/opResult> v/opResultSet> vErrSet> vErr><Acco unt_num>账号</Acco unt_num> verrMessage> 出错信息v/errMessage> v/Err>v/ErrSet>v/opRep>v/ICBCYH>1.3当日明细查询提交包v?xml version="1.0" encoding = "GB2312"?>vICBCYH>vopReq>vopName>NCCurDetailOpv/opName>vReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> --- 必输项vAccount_cur> 币种v/Account_cur><userID> 企业代码(和证书里的一致)</userID> --- 必输项<PackagelD>fe序列ID</PackagelD> ---必输项vReqReservedl;请求包备用字段1</ReqReserved1> <ReqReserved2>#求包备用字段2</ReqReserved2> </ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg中</retCode> <errMsg>错误描述</errMsg>vAccount_num>^方帐号v/Account_num><PackageID>&序列ID</PackagelD><userID> 企业代码</userID>vRepReservedl:返回包备用字段1</RepReserved1><RepReserved2:返回包备用字段2</RepReserved2> v/opResult> vopResultSet> vopResult> vTrans_date> 交易日期v/Trans_date>(例:yyyy-MM-dd-HH:mm:ss:6 位毫秒)共26 位<Check_ num 凭证号</Check_ num><Bank1_code>对方行行号</Bank1_code><Rec_Account_num对方账号v/Rec_Account_num><Am ount>发生额</Amount><Yt> 用途</Yt><Trans_type> 业务种类</Trans_type> 中文<PostScript> 附言</PostScript><Rec_Account_name对方户名</Rec_Account_name><sign> 借贷标志</sign> 中文<Trans_abstr> 摘要</Trans_abstr><RepReserved3>£回包备用字段3</RepReserved3><RepReserved4>£回包备用字段4</RepReserved4> </opResult> </opResultSet></opRep></ICBCYH>1.4历史明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Acco unt_num>帐号</Acco unt_num><Begin_date> 起始日期</Begin_date> --- 必输项(例:yyyyMMdd)<End_date>终止日期</End_date> ---必输项<Max_amount最大金额v/Max_amount> ---必输项(以分为单位,不带小数点)<Min_amount>R小金额</Min_amount> ---必输项<userID> 企业代码(和证书里的一致)</userID> --- 必输项<PackagelD>fe序列ID</PackagelD> ---必输项vReqReservedl;请求包备用字段1</ReqReserved1> <ReqReserved2>#求包备用字段2</ReqReserved2> </ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg中</retCode><errMsg>错误描述</errMsg><PackageID>&序列ID</PackagelD><userID> 企业代码</userID>vRepReservedl:返回包备用字段1</RepReserved1><RepReserved2:返回包备用字段2</RepReserved2> v/opResult> vopResultSet>vopResult><Area_code>地区代码</Area_code><Acco unt_num>帐号</Acco unt_num><Trans_date> 交易日期</Trans_date> (例:yyyyMMdd)<Check_ num 凭证号v/Check_ num><Trans_abstr> 摘要</Trans_abstr><Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount> 贷方发生额</Crebit_Amount><Bala n ce >余额< /Bala n ce ><Rec_Account_num对方账号</Rec_Account_num><Bank_name开户行名称</Bank_name><Bank1_name对方行行名</Bank1_name><Unit1_name>对方单位名称</Unit1_name><Trans_type> 业务种类</Trans_type> 中文<Yt> 用途</Yt><Trans_time> 交易时间</Trans_time>(例:yyyy-MM-dd-HH:mm:ss:6 位毫秒)共26位其值与当日明细中“交易日期”字段值一致<sign> 借贷标志</sign> 中文<RepReserved3>^回包备用字段3</RepReserved3><RepReserved4>^回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.5现金管理户当日明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccCurDetailOp</opName> <ReqParam><Area_code>地区代码v/Area_code>vAccount_num>帐号</Account_num> --- 必输项<Account_cur> 币种</Account_cur>vuserID> 企业代码(和证书里的一致)v/userID> --- 必输项<PackagelD>fe序列ID</PackagelD> ---必输项vReqReservedl;请求包备用字段1</ReqReserved1> <ReqReserved2>#求包备用字段2</ReqReserved2> v/ReqParam>v/opReq>v/ICBCYH>返回包v?xml version="1.0" encoding = "GB2312"?>vICBCYH>vopRep>vopName>NCCashManageAccCurDetailOpv/opName> vopResult><retCode>错误返回码错误描述在errMsg中</retCode><errMsg>错误描述</errMsg><Account_num>^方帐号</Account_num><PackageID>&序列ID</PackagelD><userID> 企业代码</userID>vRepReservedl:返回包备用字段1</RepReserved1><RepReserved2:返回包备用字段2</RepReserved2>v/opResult> vopResultSet><opResult><Trans_time> 交易时间</Trans_time> HH:mm:ss<Bank1_code^方行行号</Bank1_code><Rec_Account_num对方账号</Rec_Account_num><Am ount>发生额</Amount><Yt> 用途</Yt><Trans_type> 业务种类</Trans_type> 中文<PostScript> 附言</PostScript><Rec_Account_name对方户名</Rec_Account_name> <sign> 借贷标志</sign> 中文<Trans_abstr> 摘要</Trans_abstr>vREF业务编号</REF>vOREF相关业务编号</OREF>vBUSCODE务代码</BUSCODE>vENSUMMRY文备注</ENSUMMRY>vCVOUHTYP凭证种类</CVOUHTYPE>vCVOUHN凭证号</CVOUHNO>vADDINFC附加信息</ADDINFO><RepReserved3>£回包备用字段3</RepReserved3><RepReserved4>£回包备用字段4</RepReserved4> v/opResult> v/opResultSet>v/opRep>v/ICBCYH>1.6现金管理户历史明细查询提交包v?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccHisDetailOp</opName> <ReqParam><Area_code>地区代码v/Area_code> vAcco unt_num>帐号</Account_num> <Begin_date> 起始日期</Begin_date> --- 必输项(例:yyyyMMdd)<End_date>终止日期</End_date> ---必输项<Max_amount最大金额</Max_amount> ---必输项(以分为单位,不带小数点)<Min_amount>R小金额</Min_amount> ---必输项vuserID> 企业代码(和证书里的一致)v/userID> --- 必输项<PackagelD>fe序列ID</PackagelD> ---必输项vReqReservedl;请求包备用字段1</ReqReserved1> <ReqReserved2>#求包备用字段2</ReqReserved2> v/ReqParam>v/opReq>v/ICBCYH>返回包v?xml version="1.0" encoding = "GB2312"?>vICBCYH>vopRep>vopName>NCCashManageAccHisDetailOpv/opName> vopResult><retCode>错误返回码错误描述在errMsg中</retCode><errMsg>错误描述</errMsg><PackageID>&序列ID</PackagelD><userlD> 企业代码v/userlD><RepReserved1>^ 回包备用字段1</RepReserved1> <RepReserved2:返回包备用字段2</RepReserved2> </opResult><opResultSet><opResult>vTRXTYPE交易类型</TRXTYPE> 中文vBUSIDATE交易日期v/BUSIDATE> yyyyMMdd vBUSITIME交易时间</BUSITIME> HH:mm:ss vAccount_num咬易帐号v/Account_num><Bank_name本方行名</Bank_name> vTrans_type> 业务种类v/Trans_type> 中文vsign> 借贷标志v/sign> 中文<Debit_Amount>借方发生额</Debit_Amount> vCrebit_Amount> 贷方发生额v/Crebit_Amount> <Bala nce> 余额</Bala nce><Yt> 用途</Yt>vCVOUHTYP凭证种类</CVOUHTYPE> vCVOUHN凭证号</CVOUHNO>vRECIPACT对方帐号</RECIPACT> vRECIPNAM对方户名</RECIPNAME> vRECIPBNA对方行名</RECIPBNA> vREF业务编号</REF> vOREF相关业务编号v/OREF> vBUSCODE务代码v/BUSCODE>vENSUMMRY文备注v/ENSUMMRY> vADDINFC附加信息v/ADDINFO>vRepReserved3>£回包备用字段3v/RepReserved3>vRepReserved4>£回包备用字段4v/RepReserved4></opResult></opResultSet></opRep></ICBCYH>2 转帐支付(逐笔)支付提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCpaySubmitOp</opName><ReqParam><Pay_Dep_name汇款单位</Pay_Dep_name><Pay_Dep_Acc汇款帐号v/Pay_Dep_Acc> (35 位)---必输项<Area_code>地区代码</Area_code><Pay_Dep_branch>U款单位开户行</Pay_Dep_branch><Rec_Dep_namd收款单位</Rec_Dep_name> (60 位)---必输项<Rec_Dep_Acc收款帐号v/Rec_Dep_Acc> (35 位)---必输项<Rec_Area_Code收款人地区代码</Rec_Area_Code> 0 :它行1:工行<Rec_Dep_branch收款单位开户行</Rec_Dep_branch> (60 位)-- 必输项<Trans_time> 交易时间</Trans_time><Serial_no> 指令序号</Serial_no>vPayAmt金额</PayAmt> 18 位)必输项以分为单位vAccount_cur> 币种v/Account_cur><Pay_Use用途</Pay_Use> (20 位)<Pay_type>汇款速度</Pay_type> 0 :普通 1 :加急vAuthor_log_id_1> 授权人IDv/Author_log_id_1> vAuthor_log_id_2> 二次授权人IDv/Author_log_id_2> vSubmit_Log_id> 提交人IDv/Submit_Log_id> --- 必输项vArea_name> 付款人账户地区名(付款人所在地) v/Area_name><Rec_Area_name收款人账户地区名(收款人所在地)v/Rec_Area_name>--- 必输项收方如果是工行,以《信息对照表》中的地区代码对照表为准<Branch_code>账户分理处号</Branch_code> <Pay_Password>£付密码</Pay_Password> <User_Rem备注栏(用户备注)</User_Rem><Pay_NetCode付款行网点号</Pay_NetCode> <Pay_BranchNo付款行行号</Pay_BranchNo> <Pay_Branchld>付款行行标识</Pay_Branchld><Pay_DispsNo>#款行分签号</Pay_DispsNo> <Rec_BranchNo对方行号</Rec_BranchNo> <Rec_Branchld>对方行标识</Rec_Branchld> vReC—DispsNo:对方分签号</Rec_DispsNo> vPostScript> 附言v/PostScript> vPostScriptFlag> 附言标志v/PostScriptFlag>vTransfer_Type> 转帐类型v/Transfer_Type><userID> 企业代码(和证书里的一致)</userID> --- 必输项<PackagelD>fe序列ID (15位)</PackagelD> ---必输项<SignTime>签名时间(yyyyMMddhhmmssS)S/SignTime> --- 必输项vReqReservedl;请求包备用字段1</ReqReserved1><ReqReserved2>#求包备用字段2</ReqReserved2> </ReqParam> </opReq></ICBCYH>支付返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCpaySubmitOp</opName><opResult><retCode> 返回码</retCode>0- 成功1- 可疑其他为失败,错误描述在errMsg 中<errMsg>错误描述</errMsg><TranFlag> 成功描述</TranFlag><PackageID>&序列ID</PackagelD><userID> 企业代码</userID><RepReserved1:返回包备用字段1</RepReserved1><RepReserved2:返回包备用字段2</RepReserved2> </opResult> </opRep></ICBCYH>逐笔支付查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryPayOrderDetailOp</opName> <ReqParam><userID> 企业代码(和证书里的一致)</userID> --- 必输项<PackagelD>fe序列ID</PackagelD> ---必输项(提交指令中的包ID)vReqReservedl;请求包备用字段1</ReqReserved1> <ReqReserved2>#求包备用字段2</ReqReserved2> </ReqParam></opReq></ICBCYH>逐笔支付查询返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryPayOrderDetailOp</opName> <opResult><retCode>错误返回码错误描述在errMsg中</retCode>此值只表示该交易是否执行成功,并不代表此笔支付是否成功或失败(非空表示交易执行失败,失败原因见errMsg)。
中国工商银行B2B网上支付操作手册
中国工商银行B2B网上支付操作手册版权声明:本文档的版权属于北京金科信安科技有限公司,任何人或组织未经许可,不得擅自修改、拷贝或以其它方式使用本文档中的内容。
如参考该文档仍不能完成支付或查询过程,请拨打工商银行客服热线95588咨询或登陆官网/查询。
B2B支付开通流程企业只要满足以下条件,即可使用B2B中的网上支付功能。
1.企业账户需要开通网上银行功能。
开通成功后,银行发放三个Usbkey,分别具有制单、复核、管理权限。
2.登录工商银行网站下载并安装Usbkey驱动程序和网银管理工具,正确设置网银登录环境。
B2B支付操作流程制单流程本操作流程由具有制单权限的财务操作员完成,操作流程如下:1.插入工商银行Usbkey,配置正确的浏览器设置。
2.在商户网站选择商品或者服务,确认用工商银行网银进行支付。
3.登录工商银行网站进行支付,确认订单金额、收款人名称等并选择付款账号支付。
4.再次确认订单信息、支付账户和收款账户。
5.输入Usbkey密码。
6.确认信息,点击确定支付。
7.显示如下信息,支付完成。
复核流程本操作流程由具有复核权限的财务操作员完成,操作流程如下:1.插入复核员Usbkey,输入密码,登录到工商银行企业网银。
2.进入“指令查询与处理”,选择“待处理指令”。
3.查询待审核的交易,点击“审批”。
4.选择要支付的证书。
5.输入Usbkey密码。
6.确认订单信息,点击确定。
7.点击“批准”,确认复核成功。
B2B支付交易银行订单号查询1.登录到工商银行网上银行。
2.进入“指令查询与处理”,点击“已处理指令”,按照日期进行查询。
选择支付成功的交易,点击进入。
3.查询到详细的订单信息,合同号即为银行订单号。
B2B在线支付
B2B在线支付一、产品简介B2B在线支付是工行专门为电子商务活动中的卖方和买方提供的安全、快捷、方便的在线支付中介服务,从而连接电子商务活动中的卖方和买方,保障资金流的畅通,加速卖方资金回笼,方便买方购物支付。
二、产品特点◆安全可靠技术上采用国际上安全性最强的1024位非对称密钥国产算法为基础的安全认证体系,客户、商户、银行三方间采用国际通行的128位SSL加密协议进行链路层的加密数据传输;业务上流程清晰,分工明确,客户消费行为在商户网站进行,支付时链接到工行网站,支付行为在且仅在工行网站封闭进行,全面保障客户账户信息安全。
◆功能全面、实时高效为商户提供交易查询、管理和对账等功能,资金实时到账,扣款结果信息立即反馈。
◆客户群体巨大中国内地最大的商业银行,拥有国内最多的企业客户群体。
三、产品功能◆特约商户服务开展B2B业务的电子商务企业,经过申请可以成为“工行财e通”企业网上银行的特约商户,并享有订单管理和账户管理的服务功能。
1. 订单管理(交易明细查询)商户可以查询所有网上交易情况,已经支付成功的订单,进而可以根据订单组织发货。
2. 账户管理(帐务服务)商户在我行开立的专门用于网上商店销售款资金结算的对公往来户,可以通过账户管理功能查询到销售款到帐情况,包括余额查询、当日收款明细查询、历史收款明细查询等。
◆B2B网上采购主要功能采购查询和采购授权B2B网上采购的主要功能包括采购、采购查询和采购授权。
1. 采购(提交指令)当客户在工商银行B2B特约网站上订货或购物,并且选择"确定由中国工商银行支付",或登录中国工商银行企业网上银行网页,选择"网上购物"时,提交在工商银行B2B 特约网站上订货或购物所产生的订单,也可以在此手工输入订单信息,以完成向卖方的在线支付。
2. 采购查询(查询指令)根据客户所选条件,如按交易起止时间、金额最小值和金额最大值或指令的状态(待处理,支付成功,支付失败三种)查询提交过的支付指令记录。
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
B2C支付接口v1.0.0.3第 1 章业务说明第 2 章商户接口2.1 支付接口2.1.1 支付接口表单定义2.1.2 tranData2.1.3 tranData格式定义 (10)2.1.4 表单样例 (11)2.2 通知接口 (14)2.2.1 通知接口表单定义 (14)2.2.2 notifyData数据定义 (15)2.2.3 notifyData格式定义 (17)2.2.4 表单样例 (18)2.3 说明 (20)第 3 章安全API说明 (21)第 4 章开发步骤 (21)第 1 章业务说明B2C在线支付接口实现工行个人网银客户在工行B2C商户网站进行消费支付的业务处理。
新的1.0.0.3版本同原先版本的主要区别在于通知消息方式的改变。
原1.0.0.0版本和1.0.0.1版本(扩充语言字段以支持英文版)在订单中要求商户选择通知方式,即1、需要银行通知交易结果,2、不需要银行通知交易结果而是商户主动查询;当需要通知时,需要在订单中提供商户接收银行通知地址,当银行处理结束后,会在银行的后台服务器请求商户的此地址,将交易结果用http连接post表单形式提交给商户,然后返回客户交易结果页面。
新的1.0.0.3版本不再要求商户选择通知方式,和接收银行通知的地址;此版本要求商户在提交订单时,提供交易处理后返回商户的地址,即完成客户从商户转向到银行进行支付,处理后又从银行定向回商户网站的闭环。
在从银行交易页面返回商户时,将交易结果作为表单数据提交到商户此返回地址。
处理的优点:1、强制完成交易闭环;2、无需银行后台发送通知,客户不需要等待商户接收银行通知后才能看到交易结果页面,缩短响应时间;3、通知方式不再局限于http连接和80端口,返回商户的地址可以使用https方式和其他商户支持的端口,提高安全性;4、银行作为交易的一方,支持众多商户和客户时,存在一定的带宽和服务器处理压力,使用客户返回商户方式提供交易结果,可有效减少交易掉单现象,只要客户到了银行的结果页面,如果还出现掉单问题,则可能是客户和商户的通讯等方面的问题。
以下简述处理流程:1.客户在商户网站浏览商品信息,签订订单;2.商户按照工行B2C支付1.0.0.3接口形成提交数据,并使用工行提供API和商户证书对订单数据签名,形成form表单返回客户浏览器,表单action地址指向工行接收商户订单信息的servlet;3.客户确认使用工行支付后,提交此表单到工行;4.工行网银系统接收此笔订单,对订单信息和商户信息进行检查;5.通过检查则显示工行支付页面,1.0.0.3版本会提示客户输入交易卡号;6.客户输入后提交;7.银行查询客户相关信息;8.返回客户在银行的预留信息;9.客户确认;10.返回交易确认页面;11.不同类型客户使用各自认证方式进行交易确认,支持静态支付密码、动态口令卡、证书签名;12.银行校验后进行支付处理;13.将结果形成通知消息并有银行端签名信息,返回客户端;14.引导客户返回商户网站,地址是订单中提供的商户url,此url支持http 和https及自定义端口;B2C在线支付接口版本说明:1.0.0.0(基本支付)1.0.0.1(支持英文界面)1.0.0.2(内部保留)1.0.0.3(保留1.0.0.1功能,优化通知方式)1.0.0.4(商户订单中指定支付卡,不强制使用e卡支付,不允许客户的支付卡透支支付,专门用于基金商户进行基金直销业务,同1.0.0.3通知方式)通知消息模式区别:原有模式:支付处理后,后台发送商户通知;新增模式:支付完成后或客户点击“返回商户”,利用客户浏览器跳转,完成商户通知的转发,后台不再单独发送商户通知。
对于不同类型商户接口区别:对于购物类型商城只支持使用1.0.0.0/1.0.0.1/1.0.0.3对于基金直销类型网站商城只支持使用1.0.0.4第 2 章商户接口接口定义通过接口名称和接口版本号来标识,以便将来的扩展;新通知方式的B2C接口称为新模式B2C接口;原有后台发送http通知的方式称为原模式接口;2.1支付接口2.1.1支付接口表单定义新模式接口的交易数据整合到一个xml格式串,作为表单的一项整体提交,不再同原来每个字段都是key-value形式;FORM表单数据如下:注:1、数据中不能包含“|”、“&”、“=”,这些字符为银行端程序保留字符;中文变量使用GBK编码。
2、从商户Post过来的数据,参数名的名称必须与上表中完全相同,名称中的字母大小写均要相同,不能进行随意更改(在form中的提交按钮<input type=”submit”……>中submit不能有Name属性);此外,如果其他input 项的Name中使用了双引号,如:<input type=text name=" merCert " value="xxxxxxx">,则一定注意在引号内不要包含空格,不要写成“mer URL ”,如果拼写错误或者多了空格,将造成数据无法识别,无法正常进行支付3、接口名称和版本号一定要和上表中相同.。
4、商户提交数据中的空格将被认为是有效字符被接收,请商户开发时注意对多余空格的控制。
5、tranData交易数据的xml串需要有xml的头,即<?xml version="1.0" encoding="GBK" standalone="no"?>2.1.2tranData数据定义2.1.3tranData格式定义tranData格式(xml格式固定,选输字段的取值可以为空,标签需保留) <?xml version="1.0" encoding="GBK" standalone="no"?><B2CReq><interfaceName></interfaceName><interfaceVersion></interfaceVersion><orderInfo><orderDate></orderDate><orderid></orderid><amount></amount><curType></curType><merID></merID><merAcct></merAcct></orderInfo><custom><verifyJoinFlag></verifyJoinFlag><Language></Language></custom><message><goodsID></goodsID><goodsName></goodsName><goodsNum></goodsNum><carriageAmt></carriageAmt><merHint></merHint><remark1></remark1><remark2></remark2><merURL></merURL><merVAR></merVAR></message></B2CReq>2.1.4表单样例表单数据:<INPUT NAME="interfaceName" TYPE="text" value="ICBC_PERBANK_B2C " ><INPUT NAME="interfaceVersion" TYPE="text" value="1.0.0.3"><INPUT NAME="tranData" TYPE="text" value="PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iR0JLIiBzdGFuZGFsb25lPSJubyI/PjxCMkNSZXE+PGlu dGVyZmFjZU5hbWU+SUNCQ19QRVJCQU5LX0IyQzwvaW50ZXJmYWNlTmFtZT48aW5 0ZXJmYWNlVmVyc2lvbj4xLjAuMC4zPC9pbnRlcmZhY2VWZXJzaW9uPjxvcmRlck luZm8+PG9yZGVyRGF0ZT4yMDA3MDcyNTEwNTAxNDwvb3JkZXJEYXRlPjxvcmRlc mlkPjIwMDcwNzI1MTA1MDE0LTIxMzQwNjI1NDg8L29yZGVyaWQ+PGFtb3VudD4y MDwvYW1vdW50PjxjdXJUeXBlPjAwMTwvY3VyVHlwZT48bWVySUQ+MDIwMEVDMjA wMDA4NzU8L21lcklEPjxtZXJBY2N0PjAyMDAwMjA0MDkwMTUwMjkxMzA8L21lck FjY3Q+PC9vcmRlckluZm8+PGN1c3RvbT48dmVyaWZ5Sm9pbkZsYWc+MDwvdmVya WZ5Sm9pbkZsYWc+PExhbmd1YWdlPlpIX0NOPC9MYW5ndWFnZT48L2N1c3RvbT48 bWVzc2FnZT48Z29vZHNJRD4wMDE8L2dvb2RzSUQ+PGdvb2RzTmFtZT7N/sTh0Nw 8L2dvb2RzTmFtZT48Z29vZHNOdW0+MjwvZ29vZHNOdW0+PGNhcnJpYWdlQW10Pj IwPC9jYXJyaWFnZUFtdD48bWVySGludD7H67GjwfSw/NewPC9tZXJIaW50PjxyZ W1hcmsxPjwvcmVtYXJrMT48cmVtYXJrMj48L3JlbWFyazI+PG1lclVSTD5odHRw Oi8vbG9jYWxob3N0OjkwODEvTmV3YjJjX1BheV9NZXIuanNwPC9tZXJVUkw+PG1 lclZBUj50ZXN0PC9tZXJWQVI+PC9tZXNzYWdlPjwvQjJDUmVxPg=="><INPUT NAME="merSignMsg" TYPE="text" value="DEIdSLqGvBJAcJFzg0B uhuM3gVVofOahFRFAOJ//kcjvZqUJ0GWcY3C/4qufgK+qsqbmQWV2rFdHwzvgJX g0AXpzPPlJ7JesO2iXCGXCWMchr7KaoVe10w20TojcyJxLbVciuA3C2YPoyY7/+ jv6lsnhS5GcR6GDe6vm86MZmv8="><INPUT NAME="merCert" TYPE="text" value="MIICUTCCAbqgAwIBAgIKI9 fKEDP6AAAXtjANBgkqhkiG9w0BAQUFADA0MRgwFgYDVQQDEw9wYmouaWNiYy5jb 20uY24xGDAWBgNVBAoTD3Biai5pY2JjLmNvbS5jbjAeFw0xNzAzMTAwNzI0MTdaFw0xODAzMTAwNzI0MTdaMD4xEzARBgNVBAMTCnBhbi5lLjAyMDAxDTALBgNVBAs TBDAyMDAxGDAWBgNVBAoTD3Biai5pY2JjLmNvbS5jbjCBnzANBgkqhkiG9w0BAQ EFAAOBjQAwgYkCgYEAqBdQrbNWE61+forNFMGI/MmXxKY58P39YO4vzLpHCTHNG RwJKIwILMEOND88vh7cXTBY8kbt3vt0N+4pJY3iwKQA0GfuLfv5EjrsstyUohho goxNAwxdbOLUTnn1ejNjwelZch4GqdkgmRzu6uTywRGW//foiUNgR/yL7Q2FcV0 CAwEAAaNgMF4wSwYDVR0fBEQwQjBAoD6gPKQ6MDgxDjAMBgNVBAMTBWNybDIxMQ wwCgYDVQQLEwNjcmwxGDAWBgNVBAoTD3Biai5pY2JjLmNvbS5jbjAPBgNVHWMEC AMGAP8AAAAAMA0GCSqGSIb3DQEBBQUAA4GBAOImQhTOiQxHABUefFShrD1u3N2G hVP6JnyNUOAfI40WqxszjyfmRmhYPQUQc+8fMf52mcYXiVaEM4BVuRLPkCaybBw I0ykS+xBNMhy72naQPCeR+NNyZ4xduv/E5UE+INJrjnOHR7UWRBzdxX9bjsFB16 beUVir7+S+adaXyQFT">tranData对应的xml明文:<?xml version="1.0" encoding="GBK" standalone="no"?><B2CReq><in terfaceName>ICBC_PERBANK_B2C</interfaceName><interfaceVersion>1.0.0.3</interfaceVersion><orderInfo><orderDate>20070725105014</o rderDate><orderid>20070725105014-2134062548</orderid><amount>20 </amount><curType>001</curType><merID>0200EC20000875</merID><me rAcct>0200020409015029130</merAcct></orderInfo><custom><verifyJ oinFlag>0</verifyJoinFlag><Language>ZH_CN</Language></custom><m essage><goodsID>001</goodsID><goodsName>威尼熊</goodsName><good sNum>2</goodsNum><carriageAmt>20</carriageAmt><merHint>请保留包装</merHint><remark1></remark1><remark2></remark2><merURL>http://localhost:9081/Newb2c_Pay_Mer.jsp</merURL><merVAR>test</merVA R></message></B2CReq>2.2通知接口2.2.1通知接口表单定义2.2.2notifyData数据定义2.2.3notifyData格式定义notifyData格式(xml格式固定,选输字段的取值可以为空,标签需保留) <?xml version="1.0" encoding="GBK" standalone="no"?><B2CRes><interfaceName></interfaceName><interfaceVersion></interfaceVersion><orderInfo><orderDate></orderDate><orderid></orderid><amount></amount><curType></curType><merID></merID><merAcct></merAcct></orderInfo><custom><verifyJoinFlag></verifyJoinFlag><JoinFlag></JoinFlag><UserNum></UserNum></custom><bank><TranSerialNo></TranSerialNo><notifyDate></notifyDate><tranStat></tranStat><comment></comment></bank></B2CRes>2.2.4表单样例表单数据:<INPUT TYPE="hidden" NAME="merVAR" VALUE="test"><INPUT TYPE="hidden" NAME="notifyData" VALUE="PD94bWwgIHZlcnNpb 249IjEuMCIgZW5jb2Rpbmc9IkdCSyIgc3RhbmRhbG9uZT0ibm8iID8+PEIyQ1Jl cz48aW50ZXJmYWNlTmFtZT5JQ0JDX1BFUkJBTktfQjJDPC9pbnRlcmZhY2VOYW1lPjxpbnRlcmZhY2VWZXJzaW9uPjEuMC4wLjM8L2ludGVyZmFjZVZlcnNpb24+PG 9yZGVySW5mbz48b3JkZXJEYXRlPjIwMDcwNzI1MTA1MDE0PC9vcmRlckRhdGU+P G9yZGVyaWQ+MjAwNzA3MjUxMDUwMTQtMjEzNDA2MjU0ODwvb3JkZXJpZD48YW1v dW50PjIwPC9hbW91bnQ+PGN1clR5cGU+MDAxPC9jdXJUeXBlPjxtZXJJRD4wMjA wRUMyMDAwMDg3NTwvbWVySUQ+PG1lckFjY3Q+MDIwMDAyMDQwOTAxNTAyOTEzMD wvbWVyQWNjdD48L29yZGVySW5mbz48Y3VzdG9tPjx2ZXJpZnlKb2luRmxhZz4wP C92ZXJpZnlKb2luRmxhZz48Sm9pbkZsYWc+PC9Kb2luRmxhZz48VXNlck51bT48 L1VzZXJOdW0+PC9jdXN0b20+PGJhbms+PFRyYW5TZXJpYWxObz48L1RyYW5TZXJ pYWxObz48bm90aWZ5RGF0ZT4yMDA3MDcyNTExMDQwMDwvbm90aWZ5RGF0ZT48dH JhblN0YXQ+MTwvdHJhblN0YXQ+PGNvbW1lbnQ+vbvS17PJuaajoTwvY29tbWVud D48L2Jhbms+PC9CMkNSZXM+"><INPUT TYPE="hidden" NAME="signMsg" VALUE="UYE6nBdgkaV1uxZPzyIG 5BYZmVvDl29tIvmp4XxWBsVxsw++yNwi86pYO/Wa8Kb7yMa8SueJA1Md8rDOlLG iSi/qSuJZ/lz/zM6lqpDvZgCjXSwFfcgoZJgZAFFxGOHjqBzOlp5k/WnG+9JJO2 0ROoF2a5lLhKXa509H6Mk4YUY=">notifyData对应的明文:<?xml version="1.0" encoding="GBK" standalone="no" ?><B2CRes>< interfaceName>ICBC_PERBANK_B2C</interfaceName><interfaceVersio n>1.0.0.3</interfaceVersion><orderInfo><orderDate>2007072510501 4</orderDate><orderid>20070725105014-2134062548</orderid><amoun t>20</amount><curType>001</curType><merID>0200EC20000875</merI D><merAcct>0200020409015029130</merAcct></orderInfo><custom><verifyJoinFlag>0</verifyJoinFlag><JoinFlag></JoinFlag><UserNum></ UserNum></custom><bank><TranSerialNo></TranSerialNo><notifyDat e>20070725110400</notifyDate><tranStat>1</tranStat><comment>交易成功!</comment></bank></B2CRes>2.3说明商户可能收到的银行通知指令成功:只能有一笔成功、且要验证银行签名、订单金额等信息是否与商户端记录一致。