当前位置：文档之家 › 中国工商银行网上银行C2C在线支付接口说明V1.0.0.1

中国工商银行网上银行C2C在线支付接口说明V1.0.0.1

  • 格式：doc
  • 大小：135.50 KB
  • 文档页数：11

中国工商银行网上银行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商户提交表单接口定义：（注意数据值中不能包含“&”“=”，此字符为银行端程序保留字符；中文变量使用GBK编码）商户提交表单签名merSignMsg格式：根据订单中各数据项，使用&符进行连接成签名明文，各字段顺序固定；每个数据项由变量名称加等号加变量值组成；如果变量值为空仍需保留字段位置；格式说明如下：接口名称&接口版本号&订单号&订单金额&商城收费金额&支付币种&商城代码&商城账号&卖家收款卡号&卖家收款名称&校验联名标志&通知类型&通知地址&结果发送类型&交易日期时间interfaceName=值&interfaceVersion=值&orderID=值&amount=值&merFeeAmt=值&curType=值&merID=值&merAcct=值&venderCardNum=值& venderName =值&verifyJoinFlag=值&n o t i f y T y p e=值&m e r U R L=值&r e s u l t T y p e=值&o r d e r D a t e=值举例：i n t e r f a c e N a m e=I C B C_P E R B A N K_C2 C &interfaceVersion=1.0.0.0&orderID=001&amount=99999999&merFeeAmt=10000&curType=001&m erID=ABC001&merAcct=0200029109000018831&venderCardNum=955880*************&张三&verifyJoinFlag=0&notifyType=AG&merURL=&resultType=&orderDate=20050713100334C2C通知商户交易结果接口定义：通知消息银行签名数据bankSignMsg格式：根据消息中各数据项，使用&符进行连接成银行端签名明文，各字段顺序固定；每个数据项由变量名称加等号加变量值组成；如果变量值为空仍保留字段位置；格式说明：接口名称&接口版本号&订单号&指令序号&订单金额&商城收费金额&支付币种&商城代码&商城账号&卖家收款卡号&卖家收款名称&买家收款卡号&买家付款名称&校验联名标志&客户联名标志&联名会员号&结果发送类型&交易日期时间&返回通知日期时间&订单处理状态&错误描述&备注1&备注2interfaceName=值&interfaceVersion=值&orderID=值& TranSerialNo =值&amount=值&merFeeAmt=值&curType=值&merID=值&merAcct=值&venderCardNum=值&venderName =值&customCardNum=值&customName=值&verifyJoinFlag=值&JoinFlag=值&UserNum=值&r e s u l t Ty p e=值&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=值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">订单号商户端产生，一天内不能重复。

合集下载

工商银行手机银行使用指南

工商银行手机银行使用指南

工商银行手机银行使用指南(附资费表)
工商银行服务费标准：
一、企业业务
（一）服务费
（二）交易费
*柜面资金汇划业务收费标准
（三）工本费
（四）协议费
指由我行为特定客户提供电子银行个性化服务而收取的通过协商确定的费用。

（五）其他
二、个人业务
（一）服务费
（二）交易费
（三）工本费
注释：
1、遇新增或调整收费标准时，中国工商银行将于执行前10个工作日通过本栏目予以公告；
2、以上收费标准最终解释执行权归中国工商银行所有。

三、电子商务
（一）服务费
（二）交易费。

网银在线被动对帐接口

网银在线被动对帐接口

网银在线被动对帐接口一、使用对象所有使用网银在线支付平台的签约商户。

二、接口程序开发说明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'，即可随时随地享受工商银行提供的各种金融服务。

★手机银行方面，为了给客户提供更加方便、快捷、多渠道、贴身的金融服务，中国工商银行与中国移动共同推出基于短信的新型手机银行。

E支付电商接口V1.0

E支付电商接口V1.0

E支付接口表接口表总体说明文件存放路径：ECTIP服务器。

初始数据为全量。

文件在ECTIP保留时间15天（暂定，ECTIP 未确认）。

1.商城订单流水表描述：登记电子商务平台订单信息。

表名：E_LOG_ORDER主键：ORDER_ID外键：索引：BUYERID、BRANCH_CODE增量区分字段：update_time字段desc e_log_order;Name Type Nullable------------------------- -------------- -------- ------- --------ORDER_ID V ARCHAR2(30)TRAN_DATE DATECREATETIME DATETRANSID V ARCHAR2(30)MERCHANTID V ARCHAR2(10)POSID V ARCHAR2(10) YBRANCHID V ARCHAR2(9)SELLERNAME V ARCHAR2(100)SELLERID V ARCHAR2(100) SELLEREPAYID V ARCHAR2(50) BUYERNAME V ARCHAR2(100) BUYERID V ARCHAR2(100) BUYEREPAYID V ARCHAR2(50)IP_ADD V ARCHAR2(20) INTERFACE V ARCHAR2(2)ORDER_NUM V ARCHAR2(30)CUR_TYPE V ARCHAR2(3) PROQUANTITY NUMBER(12) ORDERDESC V ARCHAR2(400) Y FEE NUMBER(13,2) YFEE_RATIO NUMBER(13,2) Y ORDERURL V ARCHAR2(256) RTURL V ARCHAR2(256)MALL_ORDER_TYPE VARCHAR2(2) PAYPROPERTY V ARCHAR2(2) AMOUNT NUMBER(13,2) Y LOAD_AMT NUMBER(13,2) Y PAY_MUTL_INFO V ARCHAR2(1024) Y TOTAL_TIMES NUMBER(2) Y CUR_TIME NUMBER(2) Y CUR_AMT NUMBER(13,2) Y PART_PAY_FLAG V ARCHAR2(1) REMARK V ARCHAR2(200) YC_MERCHANTID V ARCHAR2(15) YC_POSID V ARCHAR2(9) YC_BRANCHID V ARCHAR2(9) YC_MAC V ARCHAR2(32) YC_INSTALLNUM V ARCHAR2(2) Y PAY_SELF_AMT NUMBER(13,2) Y PAY_DEBT_AMT NUMBER(13,2) Y PAY_CREDIT_AMT NUMBER(13,2) Y PAY_NOORDER_LOAN_AMT NUMBER(13,2) Y PAY_ORDER_LOAN_AMT NUMBER(13,2) Y CONSUME_AMT_BANK V ARCHAR2(30) Y PAYW AY V ARCHAR2(2) Y PAYED_AMT NUMBER(13,2) Y CONFIRM_AMT NUMBER(13,2) Y CONFIRM_FLOWNO V ARCHAR2(25) Y SUCCESS_PAY_TIMES NUMBER(2) Y REFUNDEMENT NUMBER(13,2) Y STA TUS V ARCHAR2(2)C_MERCHANTNAME V ARCHAR2(300) YC_FEE NUMBER(13,2) Y EXPAND V ARCHAR2(200) Y REFUNDED_TIME NUMBER(13,2) Y CHARGE_TYPE CHAR(2) Y BALANCE_RATIO V ARCHAR2(10) Y DEBIT_RATIO V ARCHAR2(10) Y CREDIT_RATIO V ARCHAR2(10) Y CREDIT_INSTALL_RATIO V ARCHAR2(10) Y PSN_FINANC_RATIO V ARCHAR2(10) Y FSN_TRAN_FEE NUMBER(13,2) Y FSN_INTEREST_FEE NUMBER(13,2) Y FSN_TRAN_FEE_REFUND NUMBER(13,2) Y FEE_INTEREST_FEE_AMAI NUMBER(13,2) Y FEE_INTEREST_FEE_REFUND NUMBER(13,2) Y FSN_INTEREST_FEE_AMAI NUMBER(13,2) Y FSN_INTEREST_FEE_REFUND NUMBER(13,2) Y LOAD_AMT_REFUND NUMBER(13,2) Y PAY_ORDER_LOAN_AMT_REFUND NUMBER(13,2) Y LOAN_POFF_AMT NUMBER(13,2) Y MIDDLE_HELD_ACCT V ARCHAR2(30) Y RETURN_ACCT V ARCHAR2(30) Y LOAD_TYPE CHAR(1) Y LOAD_ACCT V ARCHAR2(30) Y MAKE_LOAN_TYPE V ARCHAR2(1) Y DISCOUNT_TYPE V ARCHAR2(1) Y UPDATETIME DATE Y LOAD_BRANCHID V ARCHAR2(12) Y FINANC_CHARG_TYPE CHAR(1) Y2.入金流水表(充值+网上支付)描述：记录E支付会员充值任务登记表。