评估用户分层

更新时间:2024.10.29

接口说明

支持商户:【普通商户】

请求方式:【POST】/v3/payscore/permissions/assess-user-risk-level

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json


Content-Type  必填 string

请设置为application/json


body 包体参数

service_id  必填 string(32)

【服务ID】 该服务ID有本接口对应产品的权限。


appid  必填 string(32)

【公众号ID】 微信公众平台分配的与传入的商户号建立了支付绑定关系的AppID,可在公众平台查看绑定关系,此参数需在本系统先进行配置。


authorization_code  选填 string(32)

【授权协议号】 预授权成功时的授权协议号,authorization_code、openid二选一


openid  选填 string(128)

【用户标识】 AppID下的用户标识,authorization_code、openid二选一


shopping_info  选填 object

【先用后付商品信息】

属性

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/payscore/permissions/assess-user-risk-level \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "service_id" : "500001",
8    "appid" : "wxd678efh567hg6787",
9    "authorization_code" : "1234323JKHDFE1243252",
10    "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
11    "shopping_info" : {
12      "goods" : [
13        {
14          "name" : "森海塞尔 MOMENTUM 4 无线耳机大馒头4 头戴式蓝牙音乐耳机自适应降噪",
15          "picture" : "http://mmbiz.qpic.cn/mmbiz_png/ldTw9dg46zkjOrzyTkbQAvQkysliaiblZhdthZWewgQMyqLZwStaNEsJrYmjwh2MlK7G4wibAFOEuISQKplSnxMWA/640?wx_fmt=png&wxfrom=200",
16          "amount" : 550,
17          "count" : 1,
18          "category_id" : [
19            "6032"
20          ]
21        }
22      ]
23    }
24  }'
25

应答参数

200 OK

service_id  必填 string(32)

【服务ID】 该服务ID有本接口对应产品的权限。


appid  必填 string(32)

【公众号ID】 微信公众平台分配的与传入的商户号建立了支付绑定关系的AppID,可在公众平台查看绑定关系,此参数需在本系统先进行配置。


mchid  必填 string(32)

【商户号】 调用接口提交的商户号


openid  选填 string(128)

【用户标识】 AppID下的用户标识


authorization_code  选填 string(32)

【授权协议号】 预授权成功时的授权协议号


authorization_state  必填 string(16)

【授权状态】 标识用户授权服务情况. UNAVAILABLE: 用户未授权服务, AVAILABLE: 用户已授权服务, UNBINDUSER: 未绑定用户


notify_url  选填 string(255)

【授权通知地址】 授权通知地址


cancel_authorization_time  选填 string(64)

【最近一次解除授权时间】 最近一次解除授权时间,遵循Rfc399标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日 13点29分35秒。


authorization_success_time  选填 string(64)

【最近一次授权成功时间】 最近一次授权成功时间,遵循Rfc399标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日 13点29分35秒。


sub_mchid  选填 string(32)

【子商户商户号】 子商户商户号


sub_appid  选填 string(32)

【子商户的公众号ID】 微信公众平台分配的与传入的子商户商户号建立了支付绑定关系的AppID,可在公众平台查看绑定关系,此参数需在本系统先进行配置。


sub_openid  选填 string(128)

【子商户的用户标识】 子商户的AppID下的用户标识


user_label  选填 string(32)

【用户标签】 用户标签,仅授权成功时返回(并且不保证一定返回) 枚举值:A、B、C(其中A>B>C)


channel_id  选填 string(32)

【渠道商商户号】 渠道商商户号


user_risk_level  选填 integer

【用户分层】 用户分层,仅授权成功时返回,数值越高,用户风险越低


risk_level_version  选填 integer

【分层版本】 表示返回的“用户分层”归属于的数据版本

应答示例

200 OK

1{
2  "service_id" : "2002000000000558128851361561536",
3  "appid" : "wxd678efh567hg6787",
4  "mchid" : "1230000109",
5  "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
6  "authorization_code" : "1275342195190894594",
7  "authorization_state" : "UNAVAILABLE",
8  "notify_url" : "https://www.weixin.com",
9  "cancel_authorization_time" : "2015-05-20T13:29:35+08:00",
10  "authorization_success_time" : "2015-05-20T13:29:35+08:00",
11  "sub_mchid" : "1230000109",
12  "sub_appid" : "wxd678efh567hg6787",
13  "sub_openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
14  "user_label" : "A",
15  "channel_id" : "1230000109",
16  "user_risk_level" : 1,
17  "risk_level_version" : 1
18}
19

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

 

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