查询与用户授权记录(openid)

查询与用户授权记录(openid)API

通过openid查询用户授权信息

接口说明

请求URL:https://api.mch.weixin.payyj.cn/v3/payscore/permissions/openid/{openid}

请求方式:GET

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path 指该参数为路径参数

query 指该参数需在请求URL传参

body 指该参数需在请求JSON传参


请求参数

参数名变量类型[长度限制]必填描述
服务IDservice_idstring[1, 32]query该服务ID有本接口对应产品的权限 ,使用默认值0000 . 
示例值:2002000000000558128851361561536
公众号idappidstring[1, 32]query微信公众平台分配的与传入的商户号建立了支付绑定关系的appid,可在公众平台查看绑定关系,此参数需在本系统先进行配置。 
示例值:wxd678efh567hg6787
用户标识openidstring[1, 128]path微信用户在商户对应appid下的唯一标识 
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o

请求示例


https://api.mch.weixin.qq.com/v3/payscore/permissions/openid/oUpF8uMuAJO_M2pxb1Q9zNjWeS6o?appid=wxd678efh567hg6787&service_id=2002000000000558128851361561536

返回参数

微信用户在商户对应appid下的唯一标识。
参数名变量类型[长度限制]必填描述
服务idservice_idstring[1, 32]该服务ID有本接口对应产品的权限。 
示例值:2002000000000558128851361561536
公众号idappidstring[1, 32]微信公众平台分配的与传入的商户号建立了支付绑定关系的appid,可在公众平台查看绑定关系,此参数需在本系统先进行配置。 
示例值:wxd678efh567hg6787
商户号mchidstring[1, 32]调用接口提交的商户号 
示例值:1230000109
用户标识openidstring[1, 128]微信用户在商户对应appid下的唯一标识。  
示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o
授权协议号authorization_codestring[1,32]预授权成功时的授权协议号 。 
示例值:1275342195190894594
授权状态authorization_statestring[1, 16]标识用户授权服务情况。
UNAVAILABLE:用户未授权服务
AVAILABLE:用户已授权服务
UNBINDUSER:未绑定用户(已经预授权但未完成正式授权)
示例值:UNAVAILABLE
最近一次解除授权时间cancel_authorization_timestring[1,32]最近一次解除授权时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss.sss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒
示例值:2015-05-20T13:29:35.120+08:00
最近一次授权成功时间authorization_success_timestring[1,32]最近一次授权成功时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss.sss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss.sss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒
示例值:2015-05-20T13:29:35.120+08:00

返回示例


{
  "service_id": "2002000000000558128851361561536",
  "appid": "wxd678efh567hg6787",
  "mchid": "1230000109",
  "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
  "authorization_code": "1275342195190894594",
  "authorization_state": "UNAVAILABLE",
  "notify_url": "https://www.weixin.com",
  "cancel_authorization_time": "2015-05-20T13:29:35.120+08:00",
  "authorization_success_time": "2015-05-20T13:29:35.120+08:00"
}
                    

错误码公共错误码

状态码错误码描述解决方案
500SYSTEM_ERROR系统错误5开头的状态码都为系统问题,请使用相同参数稍后重新调用
400PARAM_ERROR参数错误根据错误提示,传入正确参数
403NO_AUTH商户信息不合法登录商户平台核对,传入正确信息
429FREQUENCY_LIMITED频率超限请求量不要超过接口调用频率限制
400INVALID_REQUEST请求参数符合参数格式,但不符合业务规则请确认相同单号是否使用了不同的参数
404ORDER_NOT_ EXIST订单不存在确认入参,传入正确单据
400INVALID_ORDER_STATE单据状态错误确认操作是否符合流程
400ORDER_CANCELED单据已取消当前状态无需操作
400ORDER_DONE订单已完成当前状态无需操作