中国工商银行网上银行B2C在线支付API 接口

中国工商银行网上银行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商户提交表单接口定义：

中国工商银行网上银行B2C在线支付API 接口

客户支付后商户网站产生的一个唯一 的定单号，该订单号应该在相当长的 时间内不重复。工行通过订单号加订 单日期来唯一确认一笔订单的重复 性。 订单金额

amount

MAX(10)

必输，签名， 客户支付订单的总金额，一笔订单一 个，以分为单位。不可以为零，必需 符合金额标准。 必输，签名， 用来区分一笔支付的币种，目前工行 只支持使用人民币(001)支付。 取值： “001” 必输，签名， 唯一确定一个商户的代码，由商户在 工行开户时，由工行告知

商户。 必输，签名， 商城收费入账账号 (只能交易时指 定) 。 必输，签名。 取值“1” :客户支付时，网银判断该 客户是否与商户联名，是则按上送金 额扣帐，否则展现未联名错误； 取值“0” :不检验客户是否与商户联 名，按上送金额扣帐。 必输，签名， 在交易转账处理完成后把交易结果通 知商户的处理模式。 取值“HS”:在交易完成后实时将通 知信息以 HTTP 协议 POST 方式，主动 发送给商户，发送地址为商户端随订 单数据提交的接收工行支付结果的 URL 即表单中的 merURL 字段； 取值“AG”:在交易完成后不通知商 户。商户需使用浏览器登录工行的 B2C 商户服务网站，或者使用工行提 供的客户端程序 API 主动获取通知信 息。 选输，签名， 使用 HS 通知类型的商户用来接收工 行订单支付结果的 URL;银行使用 HTTP 协议 POST 方式向此地址发送 通知信息；目前只支持 80 端口。 使用“AG”通知类型的商户,该字段

支付币种

curType

=3

商户代码

merID

MAX(20)

商城账号

merAcct

MAX(19)

检验联名标志

verifyJoinFlag

=1

通知类型

notifyType

=2

接收支付结果 信息通知程序 地址

merURL

MAX (200)

中国工商银行网上银行B2C在线支付API 接口

其他同1.0.0.0版本

中国工商银行网上银行B2C在线支付API 接口

2.2 商户提交表单签名merSignMsg格式：

1、组织要签名的数据串 (顺序固定；被商户签名的串为各输入项的值)：

接口名称的值+接口版本号的值+商城代码的值+商城账号的值+通知地址的值+通知类型的值+订单号的值+订单金额的值+支付币种的值+结果发送类型的值+交易日期时间的值+校验联名标志的值

2、举例：

以下是需要签名的数据名称及对应值 interfaceName=ICBC_PERBANK_B2C

&interfaceVersion=1.0.0.0&merID=0200EC20000012&merAcct=0200029109000030106&merURL=http://www.77cn.com.cn/servlet&notifyType=HS&orderid=000000001&amount=100&curType=001 &resultType=0&orderDate=20050801192556& verifyJoinFlag=0 需要签名的明文

ICBC_PERBANK_B2C1.0.0.00200EC200000120200029109000030106http://www.77cn.com.cn/servletHS0000000011000010200508011925560

签名后（用测试私钥user.key ） merSignMsg为

SFVdS3Kca6d/wetLFwynBl1q5nDIyxxEUXCzniIa47mhxs1BM9mPsnRc2lOqqrfwBdwBjSE82jS/iBHYKolf2sppjEyOImVZycv96321QPDgPA1yleO83K1XA1rmB3zxsIuwLKIICSWwdttn1XPYOQLJ/WAtZ5DFYFog7J8pXw0=

merCert为（用测试证书user.crt）

MIICVjCCAb+gAwIBAgIKI9fKEDP6AAAO3DANBgkqhkiG9w0BAQUFADA0MRgwFgYDVQQDEw9wYmouaWNiYy5jb20uY24xGDAWBgNVBAoTD3Biai5pY2JjLmNvbS5jbjAeFw0yMDA5MjAwOTI3NDFaFw0yMTA5MjAwOTI3NDFaMEMxGDAWBgNVBAMTD2JpYW5sdTIyLmUuMDIwMDENMAsGA1UECxMEMDIwMDEYMBYGA1UEChMPcGJqLmljYmMuY29tLmNuMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDG+u/C5pad0ZbwvAk9Gv1rr+SpknfFUsTMhJLcI2KiYa+XLSf5vCib0OclOoDDXKIWPt/hkMEz+ED8YukQpsstXHvnxVFxVtPh23dubQjB8/kJ7X5EbwngsHMLFEXqr3UvNfcGZHuAFqMRPtr8ys3YnL3UG43Xienc3cD8jXFdQQIDAQABo2AwXjBLBgNVHR8ERDBCMECgPqA8pDowODEOMAwGA1UEAxMFY3JsMTMxDDAKBgNVBAsTA2NybDEYMBYGA1UEChMPcGJqLmljYmMuY29tLmNuMA8GA1UdYwQIAwYA/wAAAAAwDQYJKoZIhvcNAQEFBQADgYEAQe6tLhKaNX8OPNT2XzH7dTXIFmTm37hSvmbEL/Q/pWV386KVrNSCnyN3fowanMt5TE9qZFn9enVvyDJw4nAUx38F2PFn2Tt7JUtzt/pNKC5FiebpFJH48AXIP1Xt5GjdcBx0oXM9QNBtYvY0189t357EH4UaBfO+c+L8fkOt37o=

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

1.0.0.1版本

中国工商银行网上银行B2C在线支付API 接口

（注意与C2C通知接口定义变量名区分）

中国工商银行网上银行B2C在线支付API 接口

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

1、组织要签名的数据串 (顺序固定；银行通知消息签名的串为以下格式，请注意与商户签名串的格式不同)：

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

interfaceName=值&interfaceVersion=值&orderid=值&TranSerialNo=值&amount=值&curType=值&merID=值&merAcct=值&verifyJoinFlag=值&JoinFlag=值&UserNum=值&resultType=值&orderDate=值&notifyDate=值&tranStat=值&comment=值&remark1=值 &remark2=值 举例：

以下是需 …… 此处隐藏：8673字，全部文档内容请下载后查看。喜欢就下载吧 ……