6.1 查询员工账户余额信息

接口URL

{开放平台域名地址}/openApi/open/coins/balance/query

注： 1、查询员工账户余额和卡信息资产集合

HTTP请求方式

POST

公共参数

字段	类型	是否必填	中文意描述
access_token	String	是	授权访问凭证
timestamp	String	是	毫秒级时间戳 防止重复攻击
sign	String	是	签名
version	String	否	业务接口版本号，如1.0.0

body参数

字段	类型	是否必填	中文意描述
account	String	是	登录帐号

请求示例

POST /openApi/open/coins/balance/query?access_token=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
Content-Type: application/json
Cache-Control: no-cache
{
	"account": "zengxiaoxian"
}

返回参数说明

字段	类型	中文意描述
code	String	返回码
data	ResponseData	相应报文
msg	String	如果错误，返回错误信息

ResponseData：

字段	类型	中文意描述
amountDetails	List<AmountDetail>	可用福豆余额列表
cardInfos	List<CardInfo>	可用卡余额列表

AmountDetail：

字段	类型	中文意描述
accountId	String	账户Id
accountName	String	账户名称
accountAmt	BigDecimal	账户可用余额

CardInfo：

字段	类型	中文意描述
cardNo	String	卡号
parValue	Integer	卡面值
balance	Integer	卡余额
type	Integer	卡类型，1点卡，2次卡
isBlocked	Integer	是否锁定 0-未锁定 1-锁定
expireDate	Date	过期时间

返回示例

success:

{
  "code": "0",
  "data": {
    "amountDetails": [{
      "accountId": "83230993494803",
      "accountName": "福豆账户",
      "accountAmt": 47.85
    }],
    "cardInfos": [{
      "cardNo": "468268739237",
      "parValue": 86,
      "balance": 86,
      "isBlocked": 0,
      "expireDate": "2026-06-18 05:50:14",
      "type": 1,
      "status": 1
    }]
  },
  "msg": "success"
}

fail:

{
  "code": "10016",
  "data": null,
  "msg": "签名错误"
}