用户绑定微信帐号作为在Feat站上的收款帐号。
Request
HTTP request
POST https://www.featapi.com/api/user/profile/wechat-binding/
Authorization
本接口需要当前用户登录认证并授权以下scopes访问权限:
Scopes |
---|
user_profile |
Parameters
无需添加参数。
Request body
参数名称 | 是否必填 | 类型 | 描述 | NOTE |
app_id | 是 | string | 前端获取用户微信账号授权时,使用的微信app id | 当前Web前端应该默认使用公众号app id调用本接口 |
code | 是 | string | 用户的微信账号授权code |
*关于如何获取用户的微信帐号授权code,前端应查看相关微信开发的文档,以下提供的是微信公众号的网页授权文档链接
Response
HTTP状态码:200
绑定成功后,返回以下结果
参数名称 | 类型 | 描述 | NOTE |
id | integer | Pay account ID。绑定成功后,为用户创建并返回Pay account数据 | 当前Web前端应该默认使用公众号app id调用本接口 |
user | integer | 当前用户的User UID | |
pay_method | integer | Pay account 绑定的支付平台。在本接口下绑定的是微信账号,必然为200 | 0:银联,100:支付宝,200:微信 |
account_no | string | Pay account 展示的账号名,用于给用户标识他所绑定的账号,根据不同的支付平台有不同的表现形式,在本接口下展示的是微信账号的昵称 | |
expires | datetime | 过期时间。微信账号没有过期时间,在本接口下必然为null | |
phone | datetime | 手机号码。暂时没获取该信息,默认为null | |
default_receipt | boolean | 是否为默认收款账号,默认为false | |
default_payment | boolean | 是否为默认支付账号,默认为false | 微信账号设为默认支付账号没有实质作用 |
user_info | dict | 被绑定的微信账号的用户信息:nickname为用户的微信昵称;avatar_url和headimgurl均是用户的微信头像 |
{
"id": 153,
"user": 7815769374283,
"pay_method": 200,
"account_no": "这是我的微信昵称",
"status": 100,
"expires": null,
"phone": null,
"default_receipt": true,
"default_payment": false,
"user_info": {
"app_id": "wxdbc4dc62a6f17bb7",
"nickname": "这是我的微信昵称",
"avatar_url": "https://10.0.10.117:8004/media/weixin/7815769374283/avatars/img_1650424671_358496.jpeg",
"headimgurl": "https://10.0.10.117:8004/media/weixin/7815769374283/avatars/img_1650424671_358496.jpeg"
}
}
HTTP状态码:400
1.code: WX_ALREADY_BIND
已绑定了微信账号,目前仅支持绑一个微信收款账号,无须重复绑定
2.code: WX_INVALID_APP_ID
不合法或不可用的app id,请联系运维工程师。也可以调用“check app id” API提前检查app_id是否可用