支付结果异步通知API

请求地址

商户预留的通知接收地址,即通过transactionInfo参数传入的payNoticeUrl值。

通知报文

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

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

参数名称 JSON键值 类型(长度) 必填 描述 示例
接口版本号 version String(3) M 固定为”1.0” 1.0
参数编码 charset String(8) M 固定为UTF-8 UTF-8
报文签名 sign String M
签名算法 signType String M 固定为”RSA”
应答数据 noticeData
时间戳 dateTime String(14) M

格式:

yyyyMMddHHmmss

含义:

银行返回该数据的时间

返回商户地址 noticeUrl String(256) M http://www.merchant.com/path/WAPProcResult.dll
请求方式 httpMethod String(10) M 固定为POST
分行号 branchNo String(4) M 支付商户开户分行号, 0755
商户号 merchantNo String(6) M 支付商户号 000054
通知类型 noticeType String(8) M APPLEPAY:ApplePay支付结果通知 BKPAYRTN
银行通知序号 noticeSerialNo String(30) M 商户日期+订单号+发送时间 201610249999000001121212
商户交易日期 date String(8) M

商户交易日期

格式:YYYYMMDD

20161024
订单号 orderNo String(10) M 商户订单号 9999000001
金额 amount String(13) M 支付金额,格式:XXXX.XX 0.01
银行受理日期 bankDate String(8) M 银行受理日期
银行交易流水号 bankSerialNo String(20) M 银行交易流水号
商户自定义参数 merchantPara String(256) O 商户自定义参数(支付接口中payNoticePara送来)

响应报文

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

示例

通知示例:

{
  "version":"1.0",
  "charset":"UTF-8",
  "sign":"…",
  "signType":"RSA",
  "noticeData":{                   
       "dateTime":"20161024120100",
       "noticeUrl":"http://www.merchant.com/path/WAPProcResult.dll",
       "httpMethod":"POST",
       "branchNo":"0755",
       "merchantNo":"000054",
       "noticeType":"APPLEPAY",
       "noticeSerialNo":"201610249999000001121212",
       "date":"20161024",
       "orderNo":"9999000001",
       "amount":"0.01",
       "bankDate":"20161024",
       "bankSerialNo":"20161024121201000001",
       "merchantPara":"12345678|ABCDEFG|HIJKLM"
       }
 }

待验证签名字符串strToSign为:
amount=0.01&bankDate=20161024&bankSerialNo=20161024121201000001&branchNo=0755&dateTime=20161024182921&httpMethod=POST&merchantNo=000054&merchantPara=12345678|ABCDEFG|HIJKLM&noPwdPay=N&noticeSerialNo=201610249999000001121212&noticeType=APPLEPAY&noticeUrl=http://www.merchant.com/path/WAPProcResult.dll&orderNo=9999000001

关于网站迁移公告


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

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


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

2019年8月12日