接口名称
可用额度详情
接口地址
/api/shipper/v1/finance/actBillingAccount/availableLimit
请求方式
GET
请求头
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sessionId | String | 是 | 登录会话ID |
language | String | 是 | 语言 |
Accept | String | 是 | application/json, text/plain, / |
语言取值：
值 | 说明 |
|---|---|
zh_CN | 中文 |
en_US | 英文 |
请求参数
无参数
请求示例
curl 'https://tracking-qa.etowertech.com/api/shipper/v1/finance/actBillingAccount/availableLimit' \ -H 'Accept: application/json, text/plain, */*' \ -H 'language: zh_CN' \ -H 'sessionId: 0HgJ-EO-Sq_ZQ6u93rjMnA'
返回示例
{
"success": true,
"code": "0",
"data": {
"currency": "CNY",
"availableAmount": -16087273.27,
"amount": -16086035.89,
"interimCredit": 15.47,
"frozenAmount": 0.00,
"notRecordedAdjustAmount": 1252.85,
"duePayment": 0,
"accountOdFlag": false,
"currencyOdFlag": false
},
"errors": []
}
返回字段说明
字段 | 类型 | 说明 |
|---|---|---|
success | Boolean | 请求是否成功 |
code | String | 响应状态码，"0"表示成功 |
data | Object | 返回数据对象 |
errors | Array | 错误信息列表 |
data 字段说明
字段 | 类型 | 说明（国际化key） |
|---|---|---|
currency | String | 币种 |
availableAmount | Number | 可用额度 |
amount | Number | 余额 |
interimCredit | Number | 信用额度 |
frozenAmount | Number | 冻结金额 |
notRecordedAdjustAmount | Number | 调整金额 |
duePayment | Number | 待付金额 |
accountOdFlag | Boolean | 账户透支标识 |
currencyOdFlag | Boolean | 币种透支标识 |
业务说明
该接口用于查询当前登录用户的可用额度详情，展示在"我的钱包"页面顶部。
可用额度计算公式：
可用额度 = 余额 + 信用额度 - 调整金额 - 冻结金额
字段说明：
- *可用额度 (availableAmount)*：当前可用于下单的金额（可为负数，表示透支）
- *余额 (amount)*：账户实际余额（可为负数，表示欠款）
- *信用额度 (interimCredit)*：系统授予的临时信用额度
- *调整金额 (notRecordedAdjustAmount)*：未入账的调整金额（减少可用额度）
- *冻结金额 (frozenAmount)*：被冻结的金额（减少可用额度）
- *待付金额 (duePayment)*：待付款金额
- *账户透支标识 (accountOdFlag)*：账户是否处于透支状态
- *币种透支标识 (currencyOdFlag)*：该币种是否处于透支状态