报备异步通知

1、修订记录

修订记录 日期 说明
1.0 2022.04.19 初版

2、业务说明

2.1、接口说明

当费率权限开通扫码业务时,云商服将会第一次自动报备,异步通知返回报备状态和第三方商户号。

注意:
1、接入方接受异步通知结果后,返回success表示该次异步通知成功,银盛将会按成功处理该次异步通知。
2、接入方接收到异步通知后,同步返回非success,银盛认为该次异步通知失败了,银盛将会再通知5次,间隔频率分别为1分钟、5分钟、10分钟、30分钟、60分钟共5次通知。凡是其中一次返回success银盛将会终止通知。
3、同样的通知可能会多次发送给接入方(例如调用接入方超时,接入方返回失败等)。

2.2、接入方接受异步通知接口的要求:

1、接受方式:POST
2、接受主体类型:application/json
3、需要对通知的数据进行验签,验签使用公钥验签,详见demo
4、必须要有一个返回值 该值为String类型。
5、接入方必须能够正确处理重复的通知,以避免函数重入造成的数据混乱。

3、异步通知报文结构

3.1、公共请求参数

参数 类型(长度) 必填 参数说明
timeStamp String Y 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss"
src String Y 异步通知来源,固定"ysf"
reqId String Y 请求流水号
charset String(10) Y 编码格式 固定为UTF-8
sign String Y 签名,需要银盛公钥验签,详见demo
bizContent String Y 业务响应数据 json字符串

3.2、业务请求参数

(bizContent加密前的json数据明文字符串)
参数 类型(长度) 必填 参数说明
notifyType String(1) N 通知类型 固定为6(报备异步通知)
status String(2) N 状态 00 成功,仅表示进行了报备操作,报备结果以report.thridMercList.appstatus为准
report Object N 报备结果

3.3、report 具体参数

参数 类型(长度) 必填 参数说明
authId String(30) N 权限Id
mercId String(20) N 商户号
thridMercList Array N 各渠道报备返回信息

3.4、thridMercList 具体参数

参数 类型(长度) 必填 参数说明
apprSts String(2) Y 报备状态 00 成功,01 待审核,02 审核中,03 失败,04 交易关闭 99 失败
mercId String(20) Y 商户号
thridMercId String(30) Y 第三方商户号
remark String(200) Y 备注
reportChannel String(15) Y 报备渠道 NUCC_WECHAT:微信支付(网联)、CUPS_WECHAT:微信支付(银联总部)、CUPS_ALIPAY:支付宝(银联总部)、NUCC_ALIPAY:支付宝(网联)

4、接入方返回值定义

接入方返回参数为String,不返回和非success都为失败,如果接入方处理失败,可以返回处理失败原因,以供查找问题
返回值 说明
success 成功

results matching ""

    No results matching ""