成功支付结果通知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
回调HTTP地址 noticeUrl String(256) M 回调HTTP地址,支付请求时填写的支付结果通知地址 http://www.merchant.com/path/payNotice.do
回调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
20161216
订单号 orderNo String(10) M 商户订单号 9999153784
金额 amount String(14) M 订单金额,格式:XXXX.XX 0.01
银行受理日期 bankDate String(8) M 银行受理日期 20161216
银行订单流水号 bankSerialNo String(20) M 银行订单流水号 16321686300000000010
优惠标志 discountFlag String(1) M 优惠标志,Y:有优惠 N:无优惠 Y
优惠金额 discountAmount String(14) M 单位为元,精确到小数点后两位。格式为:xxxx.xx元 0.00
商户附加参数 merchantPara String(256) O 原样返回商户在一网通支付请求报文中传送的成功支付结果通知附加参数 aaa
支付卡类型 cardType String(2) O 03:信用卡,02:借记卡 02

请求示例

1.json报文组织:

{
    "charset":"UTF-8",
    "sign":"…",
    "signType":"RSA",
    "version":"1.0",
    "noticeData":{
        "dateTime":"20161216140241",
        "date":"20161216",
        "amount":"0.01",
        "bankDate":"20161216",
        "orderNo":"9999153784",
        "discountAmount":"0.00",
        "noticeType":"BKPAYRTN",
        "httpMethod":"POST",
        "cardType":"02",
        "noticeSerialNo":"0755000054201612169999153784",
        "merchantPara":"aaa",
        "discountFlag":"N",
        "bankSerialNo":"16321686300000000010",
        "noticeUrl":"http://www.merchant.com/path/payNotice.do",
        "branchNo":"0755",
        "merchantNo":"000054"
    }

}

响应报文

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

错误码

关于网站迁移公告


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

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


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

2019年8月12日