查询单uin后付费账户信息
最近更新时间: 2026-04-10 00:05:53
1. 接口描述
接口请求域名： bill.api3.fincloud.tencent.cn。
查询单uin后付费账户信息，SubAcctid=CREDIT_FIXED 时才返回新账期NextDueDelay
默认接口请求频率限制：20次/秒。
接口更新时间：2025-03-31 15:36:32。
接口既验签名又鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数，本接口取值：DescribeUserAccount |
| Version | 是 | 否 | String | 公共参数，本接口取值：2018-10-25 |
| Region | 是 | 否 | String | 公共参数，地域信息本接口不需要传递此参数。 |
| AcctId | 是 | 否 | String | 接入后付费账户的唯一标识 示例值： 1001 |
| SubAcctid | 是 | 否 | String | 传后付费固定额度子账户标识: CREDIT_FIXED 示例值： CREDIT_FIXED |
| Device | 是 | 否 | Int64 | 请求方设备，0表示PC，1表示手机 示例值： 1 |
| Ts | 是 | 否 | Int64 | UNIX时间戳（从格林威治时间1970年01月01日00时00分00秒起至现在的总秒数） 示例值： 1730702488 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Status | String | 账户状态，0为未开户或销户，1为正常，其他异常 （可根据账户状态来判断是否开户） 示例值： 1 |
| Balance | String | 后付费余额（包含了cash） 示例值： 4000000 |
| AllIn | String | 累计金额，后付费账户表示累积还款额（当前接口无需关心） 示例值： 0 |
| AllOut | String | 历史累计支出金额，后付费账户表示累积消耗额（当前接口无需关心） 示例值： 26177810000000 |
| Exptime | String | 过期时间，非过期类返回0，否则返回时间UNIX时间戳（当前接口无需关心） 示例值： 0 |
| ExpireinfoExtend | String | 过期订单信息（当前接口无需关心） 示例值： "" |
| Dplimit | String | 后付费额度上限 示例值： 4000000 |
| Dpbalance | String | 后付费剩余可用额度（包含了cash） 示例值： 4000000 |
| Debt | String | 当前额度使用量（包含转出和预授权等） 示例值： 26177810000000 |
| Cash | String | 后付费账户，存储现金/溢出金额，下次出账时抵消欠款 示例值： 4000000 |
| BillingDate | String | 出账日，1-28的数字，每个月第几天出账单 示例值： 23 |
| DueDate | String | 还款日，1-28的数字，每个月第几天还款 示例值： 1 |
| MerchantType | String | 商户类型，1：代理，2：子客，3：直客 示例值： 1 |
| RelatedMerchant | String | 关联商户信息，当商户类型为代理或直客时，该字段为空；当为子客时，标识代理账户信息 示例值： "" |
| DueDelayType | String | 账期类型，1：按月，2：按天 示例值： 1 |
| DueDelay | String | 账期，还款允许延期时间，当账期类型按月时，表示月份数，按天时，表示天数 示例值： 1 |
| NextDueDelay | String | 下一个出账日将生效的新账期（无新账期则返回空） 示例值： "" |
| RecoverImmediately | String | 还款时账单未还清是否立即恢复额度 0 (默认)不立即恢复 1 立即恢复 示例值： 1 |
| RefundSequence | String | 是否校验账单还款顺序 0 (默认)按顺序 1 不按顺序 示例值： 1 |
| CashRecoverImmediately | String | 提前还款是否立即恢复额度 0 (默认)不立即恢复，出账时抵消账单才恢复； 1 立即恢复 示例值： 1 |
| BillingCycleType | String | 出账周期类型，1：按月。其他暂不支持 示例值： 1 |
| BillingCycle | String | 出账周期，若按月则表示月份数，按天则表示天数 示例值： 1 |
| DayOut | String | 当天累计消耗 示例值： 4000000 |
| SubDplimit | String | 后付费二级额度。未设置则返回-1 示例值： -1 |
| UsableLimit | Uint64 | 可用额度 示例值： 4000000 |
| Fixedlimit | String | 固定额度 示例值： 4000000 |
| CashBalance | Uint64 | 现金余额 示例值： 4000000 |
| UsedLimit | Uint64 | 已用额度 示例值： 4000000 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation | 操作失败 |
| InvalidParameter | 参数错误 |