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

  • 一、免密登录

  • 二、组织架构同步

  • 三、积分对接

  • 四、订单

  • 五、小程序现金支付

  • 六、用户资金

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

    • 八、勋章

    • 九、消息对接

    • 十、客户定制

    • 十一、其它

    • 附录

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

    6.5 员工账户福豆充值

    # 6.5 员工账户福豆充值

    # 接口URL

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

    注: 1、从企业账户扣钱,充值到员工账户
    2、企业账户Id需要由东福方提供,是一个Long类型的数字

    # HTTP请求方式

    POST

    # 公共参数

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

    # body参数

    字段 类型 是否必填 中文意描述
    businessCode String 是 充值单据号,保证幂等性
    businessDesc String 否 福利名称,不传递默认“福利发放”
    companyAccountId Long 是 企业资金账户Id,由百福得线下提供
    remark String 否 备注说明
    changeAmounts UserBalanceRechargeItemVO 是 员工和金额信息明细 注:员工数量不能超过100个且员工账号不能重复

    UserBalanceRechargeItemVO:

    字段 类型 中文意描述
    account String 帐号
    amt BigDecimal 金额(单位:分)

    # 请求示例

    POST /openApi/open/coins/balance/recharge?access_token=abc&timestamp=1597300776947&sign=fa66cb4d8604413b8fb30afd32e3e73e HTTP/1.1
    Content-Type: application/json
    Cache-Control: no-cache
    {
          "businessCode": "2021090811012384",
          "businessDesc": "生日福利发放",
          "remark": "xx备注",
          "companyAccountId": 2207181400000036,
          "changeAmounts": [
                {
                  "account": "zhansan1",
                  "amt": 100
                },
                {
                  "account": "lisi",
                  "amt": 200
                }
          ]
       }
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19

    # 返回参数说明

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

    # 返回示例

    success:

    {
      "code": "0",
      "data": true,
      "msg": "success"
    }
    
    1
    2
    3
    4
    5

    fail:

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

    ← 6.4 分页查询员工账户明细 6.6 分页查询员工兑换统计→

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