事中-风险交易通知接口

更新时间:2024.11.18

应用场景

  1. 推送涉及高风险诈骗(尤其是来源订单/客服电话投诉)的风险订单给银行.

接口规则

URL路径

事件通知,url由商户通过接口(设置风险通知回调链接)提供

是否需要证书

通知参数

名称

变量名

必填

类型

示例值

描述

返回状态码

return_code

String(16)

SUCCESS

SUCCESS/FAIL
此字段是通信标识,非交易标识,交易是否成功需要查看trade_state来判断

返回信息

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:低风险
MEDIUM:中风险
HIGH:高风险

风险描述

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

返回信息,如非空,为错误原因,例如:

签名失败、参数格式校验错误

举例如下:

1<xml>
2  <return_code><![CDATA[SUCCESS]]></return_code>
3  <return_msg><![CDATA[OK]]></return_msg>
4</xml>

 

更多技术问题
技术咨询
反馈
咨询
目录
置顶