2024年4月29日发(作者：)
中国工商银行网上银行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商户提交表单接口定义：
变量名称
接口名称
接口版本号
订单号
变量命名
interfaceName
长度定义
MAX(30)
说明
必输，签名，
取值：“
ICBC_PERBANK_B2C
”
必输，签名，
取值：“1.0.0.0”
必输，签名，
客户支付后商户网站产生的一个唯一
interfaceVersion
MAX(15)
orderid
MAX(30)
的定单号，该订单号应该在相当长的
时间内不重复。工行通过订单号加订
单日期来唯一确认一笔订单的重复
性。
订单金额
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)
发布评论