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

中国工商银行网上银行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¬ifyType=AG&merURL=&resultType=&orderDate=20050713100334

C2C通知商户交易结果接口定义：

通知消息银行签名数据bankSignMsg格式：

根据消息中各数据项，使用&符进行连接成银行端签名明文，各字段顺序固定；每个数据项由变量名称加等号加变量值组成；如果变量值为空仍保留字段位置；

格式说明：

接口名称&接口版本号&订单号&指令序号&订单金额&商城收费金额&支付币种&商城代码&商城账号&卖家收款卡号&卖家收款名称&买家收款卡号&买家付款名称&校验联名标志&客户联名标志&联名会员号&结果发送类型&交易日期时间&返回通知日期时间&订单处理状态&错误描述&备注1&备注2

interfaceName=值&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 字段）。

商户可能收到的银行通知：

指令成功：

只能有一笔成功、且要验证银行签名、订单金额等信息是否与商户端记录一致。

指令失败：

注意可能收到多笔失败。客户支付失败时可以重提此笔订单到银行支付。

指令可疑：

由于网银系统与后台业务处理系统间通讯异常，造成网银不能确认支付指令结果，则此笔指令为可疑指令；可疑指令将被自动批复，商户、客户可于第二日查询指令状态。

没有收到银行通知：

由于银行、商户两端服务器或者互联网通讯等原因可能造成商户端接收不到银行通知。当没有收到银行通知时，可登录工行商户服务网站手工查询指令状态或者商户调用查询接口自动处理。