1 / 11
文档名称:

中国工商银行网上银行新B2C在线支付接口说明.doc

格式:doc   大小:79KB   页数:11页
下载后只包含 1 个 DOC 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

中国工商银行网上银行新B2C在线支付接口说明.doc

上传人:rdwiirh 2021/2/22 文件大小:79 KB

下载得到文件列表

中国工商银行网上银行新B2C在线支付接口说明.doc

相关文档

文档介绍

文档介绍:中国工商银行网上银行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接口数据说明:
接口数据格式定义通过接口名称和接口版本号来标识,以便将来的扩展;以下数据格式为 “”版的“ICBC_PERBANK_B2C”接口定义。
B2C商户提交表单接口定义:

变量名称
变量命名
长度定义
说明
接口名称
interfaceName
MAX(30)
必输,签名,
取值:“ICBC_PERBANK_B2C”
接口版本号
interfaceVersion
MAX(15)
必输,签名,
取值:“”
订单号
orderid
MAX(30)
必输,签名,
客户支付后商户网站产生的一个唯一的定单号,该订单号应该在相当长的时间内不重复。工行通过订单号加订单日期来唯一确认一笔订单的重复性。
订单金额
amount
MAX(10)
必输,签名,
客户支付订单的总金额,一笔订单一个,以分为单位。不可以为零,必需符合金额标准。
支付币种
curType
= 3
必输,签名,
用来区分一笔支付的币种,目前工行只支持使用人民币(001)支付。
取值: “001”
商户代码
merID
MAX(20)
必输,签名,
唯一确定一个商户的代码,由商户在工行开户时,由工行告知商户。
商城账号
merAcct
MAX(19)
必输,签名,
商城收费入账账号 (只能交易时指定)。
检验联名标志
verifyJoinFlag
=1
必输,签名。
取值“1”:客户支付时,网银判断该客户是否与商户联名,是则按上送金额扣帐,否则展现未联名错误;
取值“0”:不检验客户是否与商户联名,按上送金额扣帐。
通知类型
notifyType
= 2
必输,签名,
在交易转账处理完成后把交易结果通知商户的处理模式。
取值“HS”:在交易完成后实时将通知信息以HTTP协议POST方式,主动发送给商户,发送地址为商户端随订单数据提交的接收工行支付结果的URL即表单中的merURL字段;
取值“AG”:在交易完成后不通知商户。商户需使用浏览器登录工行的B2C商户服务网站,或者使用工行提供的客户端程序API主动获取通知信息。
接收支付结果信息通知程序地址
merURL
MAX (200)
选输,签名,
使用HS通知类型的商户用来接收工行订单支付结果的URL;银行使用HTTP协议POST方式向此地址发送通知信息;目前只支持80端口。
使用“AG”通知类型的商户,该字段可以为空或者不上送该字段;但在签名数据中必须包含此项,取值可为空。
取值举例:
结果发送类型
resultType
=1
选输,签名。
取值“0”:无论支付成功或者失败,银行都向商户发送交易通知信息;
取值“1”,银行只向商户发送交易成功的通知信息。
只有通知方式为HS时此值有效,如果使用AG方式,可不上送此项,但签名数据中必须包含此项,取值可为空。
商品编号
goodsID
MAX(30)
选输
商品名称
goodsName
MAX(60