# 获取交易保障标状态
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
GetGuaranteeStatus
# 功能描述
获取交易保障标状态
# 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxaapi/wxamptrade/get_guarantee_status?access_token=ACCESS_TOKEN%20
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:30、128、151
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
isActived | boolean | 是否激活交易保障标 |
msg | string | 保障标状态相关信息 |
reasons | array<string> | 未能开通保障标的原因 |
# 调用示例
示例说明: 已开通示例
# 请求数据示例
GET https://api.weixin.qq.com/wxaapi/wxamptrade/get_guarantee_status?access_token=xxx
# 返回数据示例
{
errcode: 0,
isActived: true,
msg: "已开通但未引入展示组件",
reasons: []
}
示例说明: 未开通示例
# 请求数据示例
GET https://api.weixin.qq.com/wxaapi/wxamptrade/get_guarantee_status?access_token=xxx
# 返回数据示例
{
errcode: 0,
isActived: false,
msg: "暂未达标「交易健康标准」,已达标「交易风险评级」,可通过缴纳保证金开通",
reasons: ["经营时长小于3年", "保证金余额不足"]
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
200002 | 参数错误 |