b2c在线支付接口说明

B2C在线支付接口

中国工商银行网上银行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.0”版的“ICBC_PERBANK_B2C”接口定义。

2.1 B2C商户提交表单接口定义：

B2C在线支付接口

的定单号，该订单号应该在相当长的 时间内不重复。工行通过订单号加订 单日期来唯一确认一笔订单的重复 性。 订单金额

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在线支付接口

注：

1、数据中不能包含“|”“&”“=”，此字符为银行端程序保留字符；中文变量使用GBK编码，另请注意与C2C接口定义字段名称和大小写有区分

2、从商户Post过来的数据，参数名的名称必须与上表中完全相同，名称中的字母大小写均要相同，不能进行随意更改(在form中的提交按钮<input type=”submit” >中submit不能有Name属性)；此外，如果其他input 项的Name中使用了双引号，如：<input type=text name=" merURL " value="http://doc.guandang.net/ICBCPay/">，则一定注意在引号内不要包含空格，不要写成“mer URL ”，如果拼写错误或者多了空格，将造成数据无法识别，无法正常进行支付

B2C在线支付接口

3、接口名称和版本号一定要和上表中相同.。

4、商户提交数据中的空格将被认为是有效字符被接收，请商户开发时注意对多余空格的控制。

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

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

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

2、举例：

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

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

ICBC_PERBANK_B2C1.0.0.00200EC200000120200029109000030106http://doc.guandang.net/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通知商户交易结果接口定义：

B2C在线支付接口

接口版本号 订单号

interfaceVersion MAX(15) MAX(30) orderid

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

。 银行端指令流水号 客户支付订单的总金额，一笔订单一 个，以分为 …… 此处隐藏：9643字，全部文档内容请下载后查看。喜欢就下载吧 ……