员工代扣资产检查¶
使用场景¶
- 员工在进入应用之前,一定要先绑定需要使用的资产
- 供应商在扣取员工资产之前,先检查员工余额是否足够支付
- 余额检查时会自动算上服务费(如果有服务费的话)
该接口适用于: - 打车等预检查用户余额的情况
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/seller/quickPayCheck
- 生产环境: https://openapi.guanaitong.com/seller/quickPayCheck
参数说明¶
-
公有参数
发送请求是必须传入公共参数,详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| buyer_open_id | 是 | string | 32 | 员工唯一标识 |
| total_amount | 是 | decimal | [0.01,99999999.99] | 检查金额 |
请求示例¶
POST: /seller/quickPayCheck HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=b983eef183a789a693b91406f38b7e23×tamp=1529046657&total_amount=100.00&buyer_open_id=d87797eea12a2f80ad72ed93214a0908&
timestamp=1531120153&sign=31f531d0ca40e6d7fb02688564f637f458e63ec8
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码 |
| msg | 如果错误,返回错误信息。 |
| data | is_enough代表余额是否足够支付,available_amount代表员工资产能够支付的金额,lackable_amount代表需要补充的金额 |
正确返回示例¶
##余额足够情况
{
"code": 0,
"msg": "OK",
"data": {
"order_amount":100.00,
"available_amount":100.00,
"lackable_amount":0.00,
"is_enough":true
}
}
##余额不足情况
{
"code": 0,
"msg": "OK",
"data": {
"order_amount":120.00,
"available_amount":100.00,
"lackable_amount":20.00,
"is_enough":false
}
}
##余额不足情况(员工余额100,含服务费3元时)
{
"code": 0,
"msg": "OK",
"data": {
"order_amount":120.00,
"available_amount":97.00,
"lackable_amount":23.00,
"is_enough":false
}
}