风险商户异步通知
1、修订记录
| 修订记录 | 日期 | 说明 |
|---|---|---|
| 1.0 | 2024.12.09 | 初版 |
2、业务说明
2.1、接口说明
支付机构上游渠道方（支付宝/微信）判定交易商户为风险商户时，会通知支付机构，支付机构再将风险信息通知商户所属的服务商/代理商。
服务商/代理商系统 <= 支付机构(银盛)系统 <= 渠道方(支付宝/微信)系统
注意：
1、接入方接受异步通知结果后，返回success表示该次异步通知成功，银盛将会按成功处理该次异步通知。
2、接入方接收到异步通知后，同步返回非success，银盛认为该次异步通知失败了，银盛将会再通知（次数取决业务配置），间隔频率为1分钟。凡是其中一次返回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 | 异步通知来源，固定"alipaywxRiskNotify" |
| reqId | String | Y | 请求流水号 |
| charset | String(10) | Y | 编码格式 固定为UTF-8 |
| sign | String | Y | 签名，需要银盛公钥验签,详见demo |
| bizContent | String | Y | 业务响应数据 json字符串 |
3.2、业务请求参数
（bizContent加密前的json数据明文字符串）
| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| mercId | String(32) | Y | 商户号 |
| mercName | String(32) | Y | 商户名称 |
| agtMercId | String(32) | Y | 代理商编号 |
| agtMercNm | String(32) | Y | 代理商名称 |
| channelType | String(2) | Y | 推送渠道： 01-微信 02-支付宝 |
| thirdMercId | String(68) | Y | 第三方商户号 |
| riskType | String(128) | Y | 风险类型，见"附件-风险类型"定义 |
| riskDesc | String(...) | Y | 风险描述 推送渠道为微信时，从“处罚方案”中取值 推送渠道为支付宝时，从“风险等级”中取值 |
| notifyDatetime | String(19) | Y | 风险商户通知时间，格式"yyyy-MM-dd HH:mm:ss" 示例值：2014-07-24 03:07:50 |
| alipayTradeNo | String(32) | Y | 支付宝流水号 推送渠道为支付宝时，存在(支付宝通知唯一ID) |
| weixinRecordId | String(32) | Y | 商户违约处理通知ID 推送渠道为微信时，存在(微信通知唯一ID) |
| weixinCompanyName | String(32) | Y | 微信通知子商户公司名称 推送渠道为微信时，存在 |
| weixinPunishTime | String(32) | Y | 处罚时间 推送渠道为微信时，存在 |
3.2.1、风险类型-微信
| 枚举值 | 说明 |
|---|---|
| CROSS_BORDER | 涉嫌境内支付接口跨境使用(CROSS_BORDER_USE_OF_DOMESTIC_PAYMENT_API) |
| IRREGULAR_TRANSACTION | 风险异常商户处置(IRREGULAR_TRANSACTION) |
| INVOLVED_IN_A | 涉嫌司法案件(INVOLVED_IN_A_JUDICIAL_CASE) |
| INCORRECT_INFORMATION | 涉嫌资料异常(INCORRECT_INFORMATION_SUBMITTED) |
| APPEAL_SUCCESSFUL | 申诉成功(APPEAL_SUCCESSFUL) |
| REPORTED_BY_OTHERS | 涉嫌他人投诉举报(REPORTED_BY_OTHERS) |
| VIOLATING_SMART | 涉嫌智慧餐饮活动违规(VIOLATING_SMART_CATERING_ACTIVITIES) |
| MORE_THAN_ONE | 涉嫌同一商户号下挂多个商户(MORE_THAN_ONE_MERCHANT_UNDER_A_SINGLE_MERCHANT_ID) |
| ALL_MERCHANTS_HAVE | 无交易商户未确认开户意愿(ALL_MERCHANTS_HAVE_CONFIRMED_THE_WILLINGNESS_TO_OPEN_AN_ACCOUNT) |
| UNCONFIRMED_WILLINGNESS | 未确认开户意愿(UNCONFIRMED_WILLINGNESS_TO_OPEN_AN_ACCOUNT) |
| INACTIVE_TRANSACTION | 交易停滞(INACTIVE_TRANSACTION) |
| CROSS_REGION_USE | 涉嫌境外支付接口跨区域(CROSS_REGION_USE_OF_INTERNATIONAL_PAYMENT_API) |
| UNUSUAL_REAL_TIME | 涉嫌实时交易异常(UNUSUAL_REAL_TIME_TRANSACTION) |
| UNACCEPTABLE_DOCUMENTS | 涉嫌资料不合格(UNACCEPTABLE_DOCUMENTS) |
| LARGE_AMOUNT_TRANSACTION | 涉嫌大额交易(LARGE_AMOUNT_TRANSACTION) |
| ONE_YUAN_PURCHASES | 涉嫌一元购(ONE_YUAN_PURCHASES) |
| VIOLATION | 涉嫌账号违规使用(VIOLATION_OF_ACCOUNT_TERMS) |
| TIMETRANSACTIONRISK | 涉嫌实时交易风险(UNUSUALREALTIMETRANSACTIONRISK) |
| OTHER_UNUSUAL | 涉嫌其它异常(OTHER_UNUSUAL_ACTIVITIES) |
| MULTI_LEVEL | 涉嫌多级分销返利(MULTI_LEVEL_DISTRIBUTION_REBATE) |
3.2.2、风险类型-支付宝
| 枚举值 | 说明 |
|---|---|
| 02 | 欺诈(02) |
| 01 | 赌博(01) |
| 03 | 色情(03) |
| 05 | 违禁(05) |
| 06 | 非法投融资(06) |
| 11 | 费率风险(11) |
| 08 | 投诉(08) |
| 04 | 套现(04) |
| 09 | 混合套现(09) |
| 10 | 作弊商户(10) |
| 12 | 信用卡交易异常(12) |
| 07 | 其他(07) |
4、接入方返回值定义
接入方返回参数为String，不返回和非success都为失败，如果接入方处理失败，可以返回处理失败原因，以供查找问题
注：返回内容不要带""引号
| 返回值 | 类型(长度) | 必填 | 说明 |
|---|---|---|---|
| success | String(...) | Y | 成功 |