事中-风险交易通知接口
更新时间:2024.11.18应用场景
推送涉及高风险诈骗(尤其是来源订单/客服电话投诉)的风险订单给银行.
接口规则
URL路径 | 事件通知,url由商户通过接口(设置风险通知回调链接)提供 |
是否需要证书 | 否 |
通知参数
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回状态码 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL |
返回信息 | return_msg | 否 | String(128) |
| 返回信息,如非空,为错误原因 |
以下字段在return_code为SUCCESS的时候有返回
名称 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
有风险交易的服务商号 | mch_id | 是 | String(32) | 1900000109 | 微信支付分配的服务商号 |
有风险交易的商户号 | sub_mch_id | 是 | String(32) | 1900000109 | 微信支付分配的商户号 |
风险交易的微信订单号列表 | transaction_id_list | 否 | String(512) | {"data": ["42000xxx01","42000xxxx02"]} | Json对象格式, data里存放风险交易的微信订单列表。每次最多推送10个订单 |
事件单号 | event_code | 是 | String(32) | 123456123 | 标识本次回调事件的单号,接口4同步处理结果时需要传过来 |
风险级别 | risk_level | 是 | String(32) | LOW | LOW:低风险 |
风险描述 | risk_level_desc | 是 | String(1024) | 低风险 | 风险交易相关的投诉信息 |
随机字符串 | nonce_str | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 随机字符串,不长于32位。 |
签名 | sign | 是 | String(32) | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | 通过签名算法计算得出的签名值,详见签名生成算法 |
签名类型 | sign_type | 是 | String(32) | HMAC-SHA256 | 签名类型,目前支持HMAC-SHA256 ,该字段需要参与签名sign计算。 |
返回参数
商户处理后同步返回给微信参数:
字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
---|---|---|---|---|---|
返回状态码 | return_code | 是 | String(16) | SUCCESS | SUCCESS/FAIL SUCCESS表示商户接收通知成功并校验成功 |
返回信息 | return_msg | 否 | String(128) | OK | 返回信息,如非空,为错误原因,例如: 签名失败、参数格式校验错误 |
举例如下: