成功支付结果通知API

请求地址

一网通支付请求中商户传送的成功支付结果通知地址。
例如:一网通支付API中的payNoticeUrl参数。

请求报文

适用于银行主动回调商户,报文需通过招行证书私钥进行签名,商户通过招行证书公钥验证通知来源于招行。由银行作为发起方发起请求,商户接收请求后返回响应信息。

报文的参数名:jsonRequestData,参数值JSON格式见下表

JSON键值 类型(长度) 必填 描述 示例
version String(3) M 接口版本号,固定为”1.0” 1.0
charset String(8) M 参数编码,固定为”UTF-8” UTF-8
sign String M 报文签名,使用招行私钥对noticeData内的数据进行签名;
商户需使用招行公钥验签。
signType String M 签名算法,固定为”RSA” RSA
noticeData 应答数据
dateTime String(14) M 请求时间,银行返回该数据的时间,精确到秒
格式:yyyyMMddHHmmss
20161216140241
noticeUrl String(256) M 回调HTTP地址,支付请求时填写的支付结果通知地址 http://www.merchant.com/path/WAPProcResult.dll
httpMethod String(10) M 回调HTTP方法,固定为“POST” POST
branchNo String(4) M 商户分行号,4位数字 0755
merchantNo String(6) M 商户号,6位数字 000054
noticeType String(8) M 通知类型,本接口固定为:“BKPAYRTN” BKPAYRTN
noticeSerialNo String(40) M 银行通知序号,订单日期+订单号 20180506201612169999153784
date String(8) M 商户订单日期
格式:yyyyMMdd
20160624
orderNo String(10) M 商户订单号 9999000001
amount String(14) M 订单金额,格式:XXXX.XX 0.01
bankDate String(8) M 银行受理日期 20160624
bankSerialNo String(20) M 银行订单流水号 20160624121201000001
discountFlag String(1) M 优惠标志,Y:有优惠 N:无优惠 Y
discountAmount String(14) M 优惠金额,单位为元,精确到小数点后两位。格式为:xxxx.xx元 30.00
merchantPara String(256) O 商户附加参数,原样返回商户在一网通支付请求报文中传送的成功支付结果通知附加参数 12345678|ABCDEFG|HIJKLM
cardType String M 支付卡类型 ,02本行借记卡、03本行贷记卡、08本行他记卡、09他行贷记卡 02

请求示例

1.json报文组织:

{
    "version":"1.0",
    "charset":"UTF-8",
    "sign":"…",
    "signType":"RSA",
    "noticeData":{
        "dateTime":"20160622182921",
        "noticeUrl":"http://www.merchant.com/path/WAPProcResult.dll",
        "httpMethod":"POST",
        "branchNo":"0755",
        "merchantNo":"000054",
        "noticeType":"BKPAYRTN",
        "noticeSerialNo":"201606249999000001121212",
        "date":"20160624",
        "orderNo":"9999000001",
        "amount":"40.01",
        "bankDate":"20160624",
        "bankSerialNo":"20160624121201000001",
        "discountFlag":"Y",
        "discountAmount":"30.00",
        "merchantPara":"12345678|ABCDEFG|HIJKLM",
        "cardType":"02"
    }
}

2.待验证签名字符串为:

amount=40.01&bankDate=20160624&bankSerialNo=20160624121201000001&branchNo=0755&cardType=02&date=20160624&dateTime=20160622182921&discountAmount=30.00&discountFlag=Y&httpMethod=POST&merchantNo=000054&merchantPara=12345678|ABCDEFG|HIJKLM&noticeSerialNo=201606249999000001121212&noticeType=BKPAYRTN&noticeUrl=http://www.merchant.com/path/WAPProcResult.dll&orderNo=9999000001 

响应报文

返回 HTTP Status Code 200 ,表示成功接收。否则表示未成功,未成功则银行会进行重发,重发直至响应成功或重发次数达到上限9次后停止重发。

错误码

关于网站迁移公告


为提供更优质的开发技术支持,本网站已于2019年8月12日正式迁移至新域名http://openhome.cmbchina.com/paynew/pay/Home,敬请访问并收藏。原网站域名已停止更新维护,请以新网站提供的文档信息为准。

由此给您带来的不便,敬请谅解。


招商银行一网通支付技术支持小组

2019年8月12日