中国工商银行网上银行C2C在线支付接口说明V1001
- 格式:doc
- 大小:96.50 KB
- 文档页数:11
网银在线被动对帐接口一、使用对象所有使用网银在线支付平台的签约商户。
二、接口程序开发说明1.商户在使用此被动对帐接口之前需开发并测试通过网银在线支付接口。
2.此对帐接口由商户端自动发起,提交订单对帐接口参数有:v_oid 商户订单号v_mid 商户编号v_url 返回页面地址billNo_md5 md5数字签名拼凑串:v_oid+key(商户md5私钥)商户只需修改网银在线给出的模版程序中的key值即可。
3. 自动对帐接口返回参数有:v_oid 商户订单编号v_pmode 持卡人支付方式(即银行名称,如“工商银行”)v_pstatus 支付结果状态码,20表示支付成功,30表示支付失败,0 表示传递到网银的MD5校验码错误或者订单不存在,40表示订单是未支付订单,v_pstring 支付结果状态说明:“支付完成”(支付状态为20时);失败原因(支付状态30时)v_md5str MD5校验码v_amount 支付金额v_moneytype 支付币种remark1 支付金额remark2 支付币种其中md5校验的字符串是:v_oid+v_pstatus+v_amount+v_moneytype+key说明:1.当商户发起被动对帐时如果传递的md5数字签名不正确(即billNo_md5不正确),则返回V_oid为提交的订单号,v_pstring为“MD5校验码错误”,v_pstatus为“0”,其余参数均为空。
2.当商户提交的订单号不正确时,则返回V_oid为提交的订单号,v_pstring为“订单不存在”,v_pstatus为“0”,其余参数均为空。
3.当商户提交的订单未支付时,则返回V_oid为提交的订单号,v_pstring为未支付,v_pstatus为“0”。
中国工商银行电子银行产品简介目录金融e通道电子银行业务综述------------------- 2-3 企业电子银行业务简介------------------------ 4-10 个人电子银行业务系列知识------------------- 11-26 U盾介绍----------------------------------- 27-28电子银行口令卡业务介绍--------------------- 29-38 电话银行业务介绍--------------------------- 39-44“金融e通道”电子银行业务综述我行于2002年5月在国内率先推出了电子银行品牌——金融e 通道,并陆续推出了“理财e站通”企业网上银行、“金融@家”个人网上银行、“95588”电话银行、手机银行“随机而动的银行”、自助终端等金融e通道的系列子品牌。
★在企业服务方面,工商银行的“理财e站通”现金管理一站式服务平台,全面满足企业从收款、付款、账户管理、资金流动各个环节的现金管理需求。
“理财e站通”能够有效协助集团企业建立良好的资金运作模式,已经成为企业加强资金管理的首选平台。
★在个人服务方面,工商银行也不断推陈出新,并于2003年11月推出全新的集银行、投资、理财于一体的“金融@家”个人网上银行。
使个人客户可以足不出户地通过网上银行办理从查询、转账、汇款、缴费到证券、外汇、基金等一系列业务,享受更贴身、更值得信赖的金融服务。
★在95588电话银行服务方面,电话银行是使用计算机电话集成技术,采用电话自动语音和人工座席等服务方式为客户提供金融服务的一种业务系统,它集个人理财和企业理财于一身,是现代通讯技术与银行金融理财服务的完美结合。
客户拨打工商银行开设的全国统一电话银行号码'95588',即可随时随地享受工商银行提供的各种金融服务。
★手机银行方面,为了给客户提供更加方便、快捷、多渠道、贴身的金融服务,中国工商银行与中国移动共同推出基于短信的新型手机银行。
中国工商银行银企互联系统接口说明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)。
B2C 支付接口v1.0.0.6中国工商银行软件开发中心 Copyright Reserved商户手册目录第1 章业务说明 (3)第2 章商户接口 (4)2.1支付接口 (4)2.1.1支付接口表单定义 (4)2.1.2tranData数据定义 (5)2.1.3tranData格式定义 (7)2.1.4表单样例 (8)2.2通知接口 (9)2.2.1通知接口表单定义 (9)2.2.2notifyData数据定义 (10)2.2.3notifyData格式定义 (11)2.2.4表单样例 (12)2.3商户判断支付结果及返回商户取货 (13)2.4其他说明 (13)第3 章安全API说明 (14)第4 章开发步骤 (14)4.1通用步骤 (14)4.2移动生活商户改造方法 (15)4.3附件 (16)B2C在线支付接口版本说明:1.0.0.0(基本支付)1.0.0.1(支持商户主动分期付款模式,商户不分期的情况下支持客户自助分期,商户客户都不分期的情况下,流程同1.0.0.0)1.0.0.3(1.0.0.1版本基础上,支持后台自动给商户发送支付结果通知消息,通知消息发送方式为只有支付成功的情况下发送通知,其余情况不通知)1.0.0.4(1.0.0.3版本基础上,支持他人代付功能)1.0.0.6(基于1.0.0.3版本,支持启动工行手机银行客户端(iPhone、Android)进行支付,支持工行移动生活商户进行支付,支持HTML网页版本(只支持iPhone、Android的webkit核心浏览器,需要商户侧自行判断客户的浏览器是否可用)进行支付。
注:1.0.0.6接口的HTML网页版本暂未开放!以下简述处理流程:1.客户在商户WAP网站、商户客户端(iPhone、Andrid)、工行移动生活商户浏览商品信息,签订订单;2.商户按照工行手机银行B2C支付1.0.0.6接口形成提交数据,并使用工行提供API和商户证书对订单数据签名,形成form表单返回客户浏览器,表单action地址指向工行接收商户订单信息的servlet;3.客户确认使用工行支付后,提交此表单到工行;4.工行手机银行系统接收此笔订单,对订单信息和商户信息进行检查;5.通过检查则根据商户上送的启动类型,启动工行手机银行客户端程序(iPhone、Android)的支付页面或HTML网页版本(只支持iPhone、Android的webkit核心浏览器)的支付页面;6.客户输入后提交;7.银行查询客户相关信息;8.返回客户在银行的预留信息;9.客户确认;10.返回交易确认页面;11.不同类型客户使用各自认证方式进行交易确认,支持静态支付密码、动态口令卡、工银电子密码器、音频U盾(U盾只支持iPhone客户端版本)。
中国工商银行银企互联系统接口说明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)。
网银在线支付接口规范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值拼成一个无间隔的字符串(顺序不要改变)。
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、银行作为交易的一方,支持众多商户和客户时,存在一定的带宽和服务器处理压力,使用客户返回商户方式提供交易结果,可有效减少交易掉单现象,只要客户到了银行的结果页面,如果还出现掉单问题,则可能是客户和商户的通讯等方面的问题。
中国工商银行网上银行网上支付接口规范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通知方式)通知消息模式区不:原有模式:支付处理后,后台发送商户通知;新增模式:支付完成后或客户点击“返回商户”,利用客户扫瞄器跳转,完成商户通知的转发,后台不再单独发送商户通知。
如有你有帮助,请购买下载,谢谢!iQ/CUP互联网商户及收单机构接入接口规范中国银联股份有限公司 发布版本修订信息目次版本修订信息......................................................... 错误!未定义书签。
前言............................................................. 错误!未定义书签。
1 范围............................................................... 错误!未定义书签。
2 规范性引用文件..................................................... 错误!未定义书签。
3 术语和定义......................................................... 错误!未定义书签。
4 交易处理说明....................................................... 错误!未定义书签。
4.1交易分类说明..................................................... 错误!未定义书签。
4.2金融类业务流程介绍............................................... 错误!未定义书签。
4.3管理类业务流程介绍............................................... 错误!未定义书签。
5 消息结构........................................................... 错误!未定义书签。
6 消息域说明......................................................... 错误!未定义书签。
工商银行手机银行使用指南(附资费表)工商银行服务费标准:一、企业业务(一)服务费(二)交易费*柜面资金汇划业务收费标准(三)工本费(四)协议费指由我行为特定客户提供电子银行个性化服务而收取的通过协商确定的费用。
(五)其他二、个人业务(一)服务费(二)交易费(三)工本费注释:1、遇新增或调整收费标准时,中国工商银行将于执行前10个工作日通过本栏目予以公告;2、以上收费标准最终解释执行权归中国工商银行所有。
三、电子商务(一)服务费(二)交易费以下是附加文档,不需要的朋友下载后删除,谢谢顶岗实习总结专题13篇第一篇:顶岗实习总结为了进一步巩固理论知识,将理论与实践有机地结合起来,按照学校的计划要求,本人进行了为期个月的顶岗实习。
这个月里的时间里,经过我个人的实践和努力学习,在同事们的指导和帮助下,对村的概况和村委会有了一定的了解,对村村委会的日常工作及内部制度有了初步的认识,同时,在与其他工作人员交谈过程中学到了许多难能可贵经验和知识。
通过这次实践,使我对村委会实务有所了解,也为我今后的顺利工作打下了良好的基础。
一、实习工作情况村是一个(此处可添加一些你实习的那个村和村委会的介绍)我到村村委会后,先了解了村的发展史以及村委会各个机构的设置情况,村委会的规模、人员数量等,做一些力所能及的工作,帮忙清理卫生,做一些后勤工作;再了解村的文化历史,认识了一些同事,村委会给我安排了一个特定的指导人;然后在村委会学习了解其他人员工作情况,实习期间我努力将自己在学校所学的理论知识向实践方面转化,尽量做到理论与实践相结合。
在实习期间我遵守了工作纪律,不迟到、不早退,认真完成领导交办的工作。
我在村委会主要是负责管理日常信件的工作,这个工作看似轻松,却是责任重大,来不得办点马虎。
一封信件没有及时收发,很有可能造成工作的失误、严重的甚至会造成巨大的经济损失。
很感谢村委会对我这个实习生的信任,委派了如此重要的工作给我。
在实习过程中,在信件收发管理上,我一直亲力亲为,片刻都不敢马虎。
为保障您的交易安全,请仔细阅读以下信息并进行勾选确认。
1、IE地址栏应以https开头。
2、电子商务支付页面域名为或。
3、IE浏览器应在右下角或正上方显示安全挂锁。
4、如您为口令卡客户,在页面发生提示您口令输入超时或错误时,请您核对以上提示。
5、支付时请不要开启远程协助功能,避免他人操作您的计算机。
6、柜面申请的网上银行其对外转账功能、电子商务功能、缴费业务功能均为开通,如需关闭相关功能,请登录网上银行后通过“安全中心”进行修改。
当您设置“预留验证信息”后,可以在登录个人网银、网上购物、网上签订委托缴费协议时验证该信息,从而有效地确保交易安全。
(1)登录个人网银当您输入网银注册卡号(或登录别名)、登录密码、验证码后,将在登录的首页面展现您的“预留验证信息”。
(2)网上购物支付第一步:在我行特约网站选中商品放入购物车;第二步:确认订单,选择工行网上支付;第三步:输入支付卡号、验证码;第四步:确认页面显示的信息与您设置的“预留验证信息”是否一致;第五步:如果信息一致,点击“确定”,在下一交易页面输入支付密码(证书客户还需要使用证书签名)、验证码,完成网上支付。
如果信息不一致,请您立即停止交易,并尽快与我行客服电话95588联系。
(3)网上签订委托缴费协议第一步:在我行收费站合作网站确认签订委托缴费协议;第二步:输入支付卡号、验证码;第三步:确认页面显示的信息与您设置的“预留验证信息”是否一致;第四步:如果信息一致,点击“确定”,在下一交易页面输入支付密码、验证码,完成协议签订。
如果信息不一致,请您立即停止交易,并尽快与我行客服电话95588联系。
中国工商银行银企互联系统接口说明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)。
中国工商银行网上银行C2C在线支付接口说明一、C2C流程说明:1、客户在商户浏览商品信息,签订订单;2、商户按照工行C2C订单数据规形成提交数据,并使用工行提供API和商户证书对订单数据签名,形成form表单返回客户浏览器,表单action地址指向工行接收商户C2C订单信息的servlet;3、客户确认使用工行支付后,提交此表单到工行;4、工行网银系统接收此笔C2C订单,对订单信息和商户信息进行检查,通过检查则显示工行C2C支付页面;5、客户在此页面可以查询客户在银行的预留信息;也可以输入支付卡号、支付密码、验证码进行C2C支付;6、工行检查客户信息,通过检查后显示确认页面;客户确认提交后工行进行支付指令处理;7、工行进行支付指令处理后,如果商户需要工行实时通知,则工行将处理结果使用http 协议post方式将通知消息数据提交到商户(这个接收银行通知消息的商户端地址是随商户订单数据提交银行的merURL字段),商户返回取货地址或关闭这个银行与其建立的连接后,银行才显示交易结果页面给客户。
(注意1、发送通知和显示结果页面是串行的,所以商户端接收银行通知处理时间太长可能导致客户等待超时,造成银行不能将交易结果页面显示给客户。
2、此连接是银行服务器自动和商户进行的连接,商户返回也是直接返回给银行,商户端不能对银行的这个请求进行重定向。
)8、工行进行支付指令处理后,如果商户不需要工行实时通知,则工行直接显示交易结果给客户。
二、C2C接口数据说明:接口数据格式定义通过接口名称和接口版本号来标识,以便将来的扩展;以下数据格式为“1.0.0.1”版的“ICBC_PERBANK_C2C”接口定义。
C2C商户提交表单接口定义:编码)商户提交表单签名merSignMsg 格式:根据订单中各数据项,使用&符进行连接成签名明文,各字段顺序固定;每个数据项由变量名称加等号加变量值组成;如果变量值为空仍需保留字段位置;格式说明如下:接口名称&接口版本号&订单号&订单金额&商城收费金额&支付币种&商城代码&商城账号&卖家收款卡号&卖家收款名称&校验联名标志&通知类型&通知地址&结果发送类型&交易日期时间interfaceName=值&interfaceVersion=值&orderID=值&amount=值&merFeeAmt=值&curType=值&merID=值&merAcct=值&venderCardNum=值& venderName =值&verifyJoinFlag=值¬ifyType=值&merURL=值&resultType=值&orderDate=值举例:i n t e r fa c e N a m e =I C B C _P E R B A N K _C 2 C &interfaceVersion=1.0.0.0&orderID=001&amount=99999999&merFeeAmt=10000&c u r T y p e =001&m e r I D =A B C 001&m e r A c c t =31&v e n d e r C a r d N u m =20&三&verifyJoinFlag=0¬ifyType=AG&merURL=&resultType=&orderDate=334C2C 通知商户交易结果接口定义:通知消息银行签名数据bankSignMsg格式:根据消息中各数据项,使用&符进行连接成银行端签名明文,各字段顺序固定;每个数据项由变量名称加等号加变量值组成;如果变量值为空仍保留字段位置;格式说明:接口名称&接口版本号&订单号&指令序号&订单金额&商城收费金额&支付币种&商城代码&商城账号&卖家收款卡号&卖家收款名称&买家收款卡号&买家付款名称&校验联名标志&客户联名标志&联名会员号&结果发送类型&交易日期时间&返回通知日期时间&订单处理状态&错误描述&备注1&备注2interfaceName=值&interfaceVersion=值&orderID=值& TranSerialNo =值&a m o u n t=值&m e r F e e A m t=值&c u r T y p e=值&m e r I D=值&m e r A c c t=值&venderCardNum=值&venderName =值&customCardNum=值&customName=值&verifyJoinFlag=值&JoinFlag=值&UserNum=值&resultType=值&orderDate=值&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=值remark1=值& remark2=值提示:以上格式为银行端签名明文格式,对于银行签名字段bankSignMsg,得到密文后进行了BASE64编码,所有字段在发出前取值部分都经过urlEcode编码(包括bankSignMsg字段)。
商户可能收到的银行通知:指令成功:只能有一笔成功、且要验证银行签名、订单金额等信息是否与商户端记录一致。
指令失败:注意可能收到多笔失败。
客户支付失败时可以重提此笔订单到银行支付。
指令可疑:由于网银系统与后台业务处理系统间通讯异常,造成网银不能确认支付指令结果,则此笔指令为可疑指令;可疑指令将被自动批复,商户、客户可于第二日查询指令状态。
没有收到银行通知:由于银行、商户两端服务器或者互联网通讯等原因可能造成商户端接收不到银行通知。
当没有收到银行通知时,可登录工行商户服务手工查询指令状态或者商户调用查询接口自动处理。
商户返回取货地址:取货地址(也可称为商户收到银行成功支付后的商户端确认地址):如果有取货地址则及时返回取货地址,没有取货地址需及时关闭连接;因为银行端先进行订单支付清算,然后给商户发送通知,在商户返回取货地址或者关闭连接后,才显示交易结果给客户,整个过程是串行的;如果商户在收到银行通知后,不及时返回或关闭连接,将可能造成客户端等待超时,无法显示最终的交易结果页面。
如果商户端接收到银行通知消息,进行后续检查和处理时,商户自己程序出现异常,不应将错误信息返回给银行。
银行只接收取货地址的返回,商户程序异常时,应及时关闭和银行的连接。
如果商户返回其他非取货地址的信息,银行端将验证返回信息不是有效的URL 而记录错误日志,在给客户的交易结果页面不会有商户返回的容。
三、安全API说明:为了保证商户提交订单数据和银行通知信息数据的完整性,不可抵赖性,现提供一套用于信息签名、验签和BASE64编解码的函数。
商户开发时使用这套函数和工行颁发的商户证书进行商户订单信息签名;签名数据项和顺序均固定,具体格式可参见上一节的数据定义;同时使用这套API和银行公钥可以验证银行通知消息的有效性。
安全API的使用方法可参见【开发API接口】目录中不同开发语言的说明和demo程序;四、开发步骤商户程序需在银行模拟测试环境上进行联调后,再投产,以下说明联调开发步骤。
生成订单:1、商户和当地行联系,申请联调测试;由当地行在模拟测试环境录入商户信息,生成商户证书(pfx格式);并提供银行模拟测试环境的银行证书公钥文件(用于验证银行签名时使用);2、商户或者银行用证书拆分工具将pfx格式的商户证书拆分成扩展名为crt的公钥文件和扩展名为key的私钥文件;(这两个文件用于商户开发API调用来进行商户订单数据签名)3、商户进行开发,准备【C2C商户提交表单接口定义】一节中要求的订单数据;4、其中订单签名数据merSignMsg字段需要根据【商户提交表单签名merSignMsg格式】一节中规定数据项和顺序来拼接成明文串;然后使用提供的API函数和商户私钥进行签名,得到签名串,然后做BASE64编码;5、其中商城证书公钥merCert字段需要使用API函数做BASE64编码;6、准备好订单数据,即完成订单提交的开发;之后只要将订单提交银行接收入口“https://银行地址/servlet/ICBCINBSEBusinessServlet”,银行来处理C2C指令的资金支付;接收通知:如果商户需要银行实时发送交易结果,则需要在订单的通知类型notifyType设置成“HS”,并设置有效的接收银行通知的接收地址merURL字段,银行在支付处理完成后会向此地址post交易结果表单,表单数据项已在【C2C通知商户交易结果接口定义】中说明;商户接收到银行通知后,需使用开发API和银行公钥来验证银行签名,以确保通知消息的有效性,以下简要说明验证步骤:1、商户收到银行通知,即接收到【C2C通知商户交易结果接口定义】中说明的各字段;各字段使用URLencode,如果商户端web服务器没有自动将各字段进行URLdecode,则商户程序需手工进行URL解码;2、获得各字段取值后,根据【通知消息银行签名数据bankSignMsg格式】格式中说明的数据项和顺序,拼成银行端签名数据明文;3、使用商户开发API和银行公钥文件对表单中的银行签名bankSignMsg进行验签;4、验签成功后,为确保数据一致,建议商户比较一下通知消息中订单金额、卖家卡号等关键信息和自己记录的是否一致;5、商户根据交易结果tranStat来更新自己的指令状态和相关数据库信息;6、如果商户没有信息返回给银行则直接关闭此连接;如果商户需要提供客户取货地址或者希望客户到商户自己的确认页面,则需要返回取货地址或确认页面的URL给银行,银行将在显示给客户的交易结果页面显示此URL的供客户点击;五、样例:商户提交订单form<FORM name="order" METHOD=POSTACTION="https://银行地址/servlet/ICBCINBSEBusinessServlet">1、订单只能使用POST方式提交;使用https协议通讯;2、接收servlet名称固定为:/servlet/ICBCINBSEBusinessServlet3、银行地址:如果是生产则为“”,若为模拟测试环境则为“”<INPUT NAME="interfaceName" TYPE="text" value="ICBC_PERBANK_C2C" >接口名称固定为“ICBC_PERBANK_C2C”<INPUT NAME="interfaceVersion" TYPE="text" value="1.0.0.0">接口版本目前为“1.0.0.0”<INPUT NAME="orderID" TYPE="text" value="001">订单号商户端产生,一天不能重复。