查询用户授权状态
接口链接
| 接口url | https://api.mch.weixin.qq.com/v3/payscore/user-service-state |
|---|---|
请求方式 |
GET |
前置条件
无
请求参数
| 变量名 | 所处位置 | 数据类型 | 必填 | 描述 |
|---|---|---|---|---|
| service_id | path | String(32) | true | 该服务ID有本接口对应产品的权限 需要与创建订单时保持一致. |
| appid | path | string(32) | true | 微信公众平台分配的与传入的商户号建立了支付绑定关系的appid，可在公众平台查看绑定关系 需要在本系统先进行配置. 需要与创建订单时保持一致." |
| openid | path | String(128) | true | 用户在商户appid下的唯一标识。 |
请求包体样例：
curl “https://api.mch.weixin.qq.com/payscore/user-service-state?service_id=500001&appid=wxd678efh567hg6787&openid=oUpF8uMuAJO_M2pxb1Q9zNjWeS6o”
返回结果
状态码为 200 时 返回以下信息
| 变量名 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| service_id | string(32) | true | 调用该接口提交的服务ID | 500001 |
| appid | string(32) | true | 调用接口提交的公众账号ID | wxd678efh567hg6787 |
| openid | string(128) | true | 用户在商户appid下的唯一标识。 | oUpF8uMuAJO_M2pxb1Q9zNjWeS6o |
| use_service_state | string(16) | true | 标识用户授权服务情况： UNAVAILABLE - 用户未授权服务； AVAILABLE - 用户已授权服务 |
AVAILABLE |
应答样例：
200 Response{
"service_id": "500001",
"appid": "wxd678efh567hg6787",
"openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
"use_service_state": "AVAILABLE"
}
"service_id": "500001",
"appid": "wxd678efh567hg6787",
"openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
"use_service_state": "AVAILABLE"
}
错误码
| 名称 | 状态码 | 描述 | 原因 | 解决方案 |
|---|---|---|---|---|
| SYSTEMERROR | 500 | 系统错误 | 系统超时 | 系统异常，请使用相同参数稍后重新调用 |
| PARAM_ERROR | 400 | 参数错误 | 请求参数不合法 | 请使用正确的参数重新调用 |
| INVALID_REQUEST | 400 | 无效的请求 | 重入情况下参数不一致 | 请确认相同单号是否使用了不同的参数 |
| INVALID_ORDER_STATE | 400 | 单据状态错误 | 单据状态不允许进行当前操作 | 确认入参,传入正确单据 |
| CANCELED | 400 | 单据已撤销 | 已撤销单据不可以进行当前操作 | 确认入参,传入正确单据 |
| NO_AUTH | 403 | 商户权限异常 | 商户没有接口权限 | 请申请接口权限 |
| RATE_LIMITED | 429 | 频率限制 | 超过接口调用频率限制 | 请求量不要超过XX/XX |
| ORDERNOTEXIST | 404 | 单据不存在 | 查询单据不存在 | 确认入参,传入正确单据 |