百福得开放平台 百福得开放平台
  • H5输出
  • 供应链输出
  • 三方供应商接入
  • H5输出
  • 供应链输出
  • 三方供应商接入
  • 开发指南

  • 一、免密登录

  • 二、组织架构同步

  • 三、积分对接

  • 四、订单

  • 五、小程序现金支付

  • 六、用户资金

    • 6.1 查询员工账户余额信息
    • 6.3 分页查询福豆充值记录
    • 6.4 分页查询员工账户明细
      • 6.5 员工账户福豆充值
      • 6.6 分页查询员工兑换统计
      • 6.7 查询员工兑换统计数据最新更新时间
      • 6.8 创建资金发放计划
    • 七、差旅

    • 八、勋章

    • 九、消息对接

    • 十、客户定制

    • 十一、其它

    • 附录

    • 接口文档
    • 六、用户资金
    2023-09-26
    目录

    6.4 分页查询员工账户明细

    # 6.4 分页查询员工账户明细

    # 接口URL

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

    注: 1、该接口为分页接口,当返回的结果条数等于itemsPerPage的条数时,请进行下一页查询,否则终止查询
    2、该接口页码最大为500
    3、分页查询企业员工账户明细(签收状态、卡状态、过期信息、锁定信息等)

    # HTTP请求方式

    POST

    # 公共参数

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

    # body参数

    字段 类型 是否必填 中文意描述
    currentPage Integer 否 页码,默认1
    itemsPerPage Integer 否 页数,默认100,最大500

    # 请求示例

    POST /openApi/open/coins/getUserAccountCardDetail?access_token=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
    Content-Type: application/json
    Cache-Control: no-cache
    {
        "currentPage":1,
        "itemsPerPage":10
    }
    
    1
    2
    3
    4
    5
    6
    7

    # 返回参数说明

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

    ResponseData:

    字段 类型 中文意描述
    account String 账号
    balance String 剩余数量
    blockedInfo String 锁定信息
    cardContractId String 合同编号
    cardId String 卡号
    cardStatus String 卡状态:1:激活 2:锁定
    companyName String 单位名称
    departmentNames String 部门名称
    expiredTime String 到期时间 格式 yyyy-MM-dd HH:mm:ss
    initiationStatus String 员工状态
    kindName String 卡种名称
    mobile String 手机号
    outdatedInfo String 过期信息
    signStatusString String 签收状态 1需要签收未签收 2 不需要签收 3 已签收
    status String 账号状态
    userName String 姓名
    value String 卡面金额/次数

    # 返回示例

    success:

    {
      "code": "0",
      "data": [
        {
          "account": "abc",
          "userName": "",
          "mobile": "13011112222",
          "initiationStatus": "在职",
          "departmentNames": "百福得测试工会",
          "companyName": "百福得测试工会",
          "status": "正常",
          "cardContractId": "123",
          "value": "1000.000",
          "cardId": "123",
          "kindName": "体检健康A-测试",
          "cardStatus": "已激活",
          "balance": "317.980",
          "signStatusString": "无需签收",
          "outdatedInfo": "未过期",
          "blockedInfo": "未锁定",
          "expiredTime": "2023-09-24 00:00:00"
        }
      ],
      "msg": "success"
    }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25

    fail:

    {
      "code": "10016",
      "data": null,
      "msg": "签名错误"
    }
    
    1
    2
    3
    4
    5

    ← 6.3 分页查询福豆充值记录 6.5 员工账户福豆充值→

    Theme by Vdoing
    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式