成功支付结果通知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
20160622182921
回调HTTP地址 noticeUrl String(256) M 支付请求时填写的支付结果通知地址 http://www.merchant.com/path/WAPProcResult.dll
回调HTTP方法 httpMethod String(10) M 固定为“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(32) M 商户订单号,支持6-32位(含6和32)间任意位数的订单号,支持不固定位数,支持数字+字母(大小字母)随意组合。 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 03:信用卡,02:借记卡 ,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¬iceSerialNo=201606249999000001121212¬iceType=BKPAYRTN¬iceUrl=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日