APP支付

成功支付结果通知API

请求地址

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

注意,测试环境端口号需要为:80、8081、443,生产环境需要为:80、443。

请求报文

适用于银行主动回调商户,由银行作为发起方发起请求,商户接收请求后返回响应信息,此版本中采用企业网银的渠道进行通知。

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

参数名称JSON键值类型(长度)必填描述示例
接口版本号versionString(3)M接口版本号,固定为”1.0”1.0
参数编码charsetString(8)M参数编码,固定为”UTF-8”UTF-8
报文签名signStringM报文签名,使用招行私钥对noticeData内的数据进行签名;商户需使用招行公钥验签。
签名算法signTypeStringM签名算法,固定为”RSA”RSA
应答数据noticeData

请求时间dateTimeString(14)M商户发起支付请求的时间,精确到秒
格式:yyyyMMddHHmmss
20161216140241

回调HTTP地址noticeUrlString(256)M回调HTTP地址,支付请求时填写的支付结果通知地址http://www.merchant.com/path/payNotice.do

回调HTTP方法httpMethodString(10)M固定为“POST”POST

商户分行号branchNoString(4)M商户分行号,4位数字0755

商户号merchantNoString(6)M商户号,6位数字000054

通知类型noticeTypeString(8)M本接口固定为:“BKPAYRTN”BKPAYRTN

银行通知序号noticeSerialNoString(40)M银行通知序号,订单日期+订单号20180506201612169999153784

订单日期dateString(8)M商户订单日期
格式:yyyyMMdd
20161216

订单号orderNoString(32)M商户订单号9999153784

金额amountString(14)M订单金额,格式:XXXX.XX0.01

银行受理日期bankDateString(8)M银行受理日期20161216

银行订单流水号bankSerialNoString(20)M银行订单流水号16321686300000000010

优惠标志discountFlagString(1)M优惠标志,Y:有优惠 N:无优惠Y

优惠金额discountAmountString(14)M单位为元,精确到小数点后两位。格式为:xxxx.xx元0.00

商户附加参数merchantParaString(256)O原样返回商户在一网通支付请求报文中传送的成功支付结果通知附加参数aaa

支付卡类型cardTypeString(2)O卡类型,02:本行借记卡;
03:本行贷记卡;
08:他行借记卡;
09:他行贷记卡
02

以下字段联系招行配置控制参数后返回(默认不返回):

支付用户标识uniqueUserIDString(30)C支付用户ID,由身份证+姓名生成(推荐使用)UQwanCunLbp6cl1RbDFODrhLrAa48=

一网通用户标识expandUserIDString(30)C一网通用户ID,由一网通ID生成(招行一网通用户的身份标识)EUfirwdVQVKhffJmjQhMod0dS6GYY=


请求示例

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次后停止重发。

错误码