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×tamp=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
2
3
4
5
fail:
{
"code": "10016",
"data": null,
"msg": "签名错误"
}
1
2
3
4
5
2
3
4
5