# 查询补贴账户余额
# 接口描述
根据用户ID查询用户补贴余额,包括充值余额,补贴小钱包余额。
# 请求方法:
GET
# 请求地址:
https://open.wecard.qq.com/cgi-bin/pay/app/user-accounts?access_token=yW2skGpy8XXJHHkI5zbP3wP9SZqrzB0Q&sub_appid=1013957946_1941239759&user_id=18969187120
# 参数说明:
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| access_token | string | Y | 应用有效凭证,参考文档 |
| sub_appid | string | Y | 发起支付商户的sub_appid,sub_appid 为配置拉取接口中返回的商户 id,查询补贴账户余额接口会查出 指定了该 sub_appid 对应的商户的补贴账户集合。 |
| user_id | string | Y | 用户ID(电子卡号/学工号) |
# 响应说明:
{
"code": 0,
"data": {
"wallets": [
{
"acct_sub_appid": "1013957946_2101662",
"name": "餐补",
"logo": "//dldir1.qq.com/djt/midas/account_food.png",
"remark": "学生餐补",
"balance": 9904,
"range": "校园版应用测试大学",
"range_description": ""
},
{
"acct_sub_appid": "1013957946_2101664",
"name": "贫困补助",
"logo": "//dldir1.qq.com/djt/midas/account_food.png",
"remark": "贫困县补助",
"balance": 0,
"range": "校园版应用测试大学,北电测试,联创文印测试",
"range_description": ""
},
{
"acct_sub_appid": "1013957946_1941242414",
"name": "加班补贴",
"logo": "//dldir1.qq.com/djt/midas/account_sports.png",
"remark": "补贴",
"balance": 0,
"range": "校园版应用测试大学,北电测试",
"range_description": "仅支持食堂使用12"
}
],
"wallet_recharge": {
"acct_sub_appid": "1013957946_1941242412",
"name": "零钱包",
"logo": "https://dldir1.qq.com/djt/img/recharge/ling-qian-bao-icon.png",
"remark": "充值使用,已支持的POS机均可消费",
"balance": 100,
"range_description": ""
}
},
"message": "ok"
}
| 参数名 | 类型 | 必填 | 描述 | ||
|---|---|---|---|---|---|
| code | int | Y | 业务状态。0 为成功 其他为失败 | ||
| message | string | Y | 业务提示 | ||
| data | wallets[] | acct_sub_appid | string | Y | 补贴钱包子商户号 |
| name | string | Y | 补贴钱包名称 | ||
| logo | string | Y | 补贴钱包LOGO | ||
| remark | string | N | 使用说明 | ||
| balance | int | Y | 余额(分) | ||
| range | string | Y | 钱包使用范围(多商户逗号分隔) | ||
| range_description | string | N | 消费范围备注 | ||
| wallet_recharge | acct_sub_appid | string | Y | 充值钱包子商户号 | |
| name | string | Y | 充值钱包名称 | ||
| logo | string | Y | 充值钱包LOGO | ||
| remark | string | N | 使用说明 | ||
| balance | int | Y | 余额(分) | ||
| range_description | string | N | 消费范围备注 | ||
# 注意事项
[1] 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)
← 单个用户查询补贴账户余额 按部门查询台账 →