2024年4月29日发(作者：)
中国工商银行网上银行C2C在线支付接口说明
一、C2C流程说明：
1、客户在商户网站浏览商品信息，签订订单；
2、商户按照工行C2C订单数据标准形成提交数据，并使用工行提供API和商户证书对订单
数据签名，形成form表单返回客户浏览器，表单action地址指向工行接收商户C2C订单信
息的servlet；
3、客户确认使用工行支付后，提交此表单到工行；
4、工行网银系统接收此笔C2C订单，对订单信息和商户信息进行检查，通过检查那么显示
工行C2C支付页面；
5、客户在此页面可以查询客户在银行的预留信息；也可以输入支付卡号、支付密码、验证
码进行C2C支付；
6、工行检查客户信息，通过检查后显示确认页面；客户确认提交后工行进行支付指令处理；
7、工行进行支付指令处理后，如果商户需要工行实时通知，那么工行将处理结果使用 协
议post方式将通知消息数据提交到商户网站〔这个接收银行通知消息的商户端地址是随商
户订单数据提交银行的merURL字段〕，商户返回取货地址或关闭这个银行与其建立的连接
后，银行才显示交易结果页面给客户。〔注意1、发送通知和显示结果页面是串行的，所以
商户端接收银行通知处理时间太长可能导致客户等待超时，造成银行不能将交易结果页面显
示给客户。2、此连接是银行效劳器自动和商户进行的连接，商户返回也是直接返回给银行，
商户端不能对银行的这个请求进行重定向。〕
8、工行进行支付指令处理后，如果商户不需要工行实时通知，那么工行直接显示交易结果
给客户。
二、C2C接口数据说明：
接口数据格式定义通过接口名称和接口版本号来标识，以便将来的扩展；以下数据格式为
“1.0.0.1”版的“
ICBC_PERBANK_C2C
〞接口定义。
C2C商户提交表单接口定义：
.1版本
变量名称
接口名称
接口版本号
变量命名
interfaceName
长度定义〔以字
节为单位〕
MAX(30)
说明
必输，签名，
取值：“
ICBC_PERBANK_C2C
〞
必输，签名，
interfaceVersion
MAX(15)
取值：“1.0.0.1”
订单号
orderID
MAX(30) 必输，签名，
客户支付后商户网站产生的一个唯一
的定单号，该订单号应该在相当长的
时间内不重复。工行通过订单号加订
单日期来唯一确认一笔订单的重复
性。
必输，签名，
客户支付订单的总金额，一笔订单一
个，以分为单位。不可以为零，必需
符合金额标准。
必输，签名，
可为零，必需符合金额标准。
必输，签名，
用来区分一笔支付的币种，目前工行
只支持使用人民币〔001〕支付。
取值： “001〞
必输，签名，
唯一确定一个商户的代码，由商户在
工行开户时，由工行告知商户。
必输，签名，
商城收费入账账号 〔只能交易时指
定〕。
必输，签名，
支持工行灵通卡、E时代卡、理财金
卡、信用卡、贷记卡；不支持国际卡
必输，签名。
必输，签名。
取值“1〞：客户支付时，网银判断该
客户是否与商户联名，是那么按上送
金额扣帐，否那么展现未联名错误；
取值“0〞：不检验客户是否与商户联
名，按上送金额扣帐。
必输，签名，
在交易转账处理完成后把交易结果通
知商户的处理模式。
取值“HS〞：在交易完成后实时将通
知信息以 协议POST方式，主动发
送给商户，发送地址为商户端随订单
数据提交的接收工行支付结果的URL
即表单中的merURL字段；
取值“AG〞：在交易完成后不通知商
户。商户需使用浏览器登录工行的
C2C商户效劳网站，或者使用工行提
订单金额
amount
MAX(10)
商城收费金额
支付币种
merFeeAmt
curType
MAX(10)
= 3
商户代码
merID
MAX(20)
商城账号
merAcct
MAX(19)
卖家收款卡号
venderCardNu
m
MAX(19)
venderName
检验联名标志
verifyJoinFlag
卖家收款名称 MAX(40)
=1
通知类型
notifyType
= 2
发布评论