# 4.4 还款
# 4.4.1 用户还款计划查询
# 接口说明
- 接口由机构提供，宜享花调用；
- 查询还款计划；
# 接口地址:
repay.plan.query
# 请求参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| openId | String | 是 | 用户 ID | |
| orderNo | String | 是 | 流水号 | 宜享花补充信息单号，长度限制50 |
# 响应参数
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| status | String | 是 | 查询状态 | 参考CodeDescEnum 枚举中的status |
| msgDesc | String | 是 | 状态具体描述 | 参考CodeDescEnum 枚举中的desc |
| loanAmount | Long | 是 | 借款金额 | 单位（分） |
| termNum | Integer | 是 | 借款期数 | 总期次 |
| repayPlanList | List | 是 | 每期账单 | 见账单详情 |
| loanStatus | String | 是 | 借款状态 | 借款状态： 30:正常还款中 ； 50:已逾期 ； 60:已结清 ； |
| applyTime | String | 是 | 借款申请时间 | 格式： yyyy-MM-dd HH:mm:ss |
| effectiveTime | String | 否 | 借款起息日 | 格式： yyyy-MM-dd |
| clearTime | String | 否 | 结清日时间 | 格式： yyyy-MM-dd HH:mm:ss |
| totalDestAmount | Long | 是 | 总共应还总金额 | 单位（分） 该笔合同的总应还，对应期次中的应还 |
| totalPaidAmount | Long | 是 | 总共实收总金额 | 单位（分） 该笔合同的总实收，对应期次中的实收 |
| totalUnpaidAmount | Long | 是 | 尚欠总金额 | 单位（分） 该笔合同的总尚欠，对应期次中的尚欠 总金额=本金+利息+服务费+罚息 |
| totalUnpaidPrincipal | Long | 是 | 尚欠总本金 | 单位（分） |
| totalUnpaidInterest | Long | 是 | 尚欠总利息 | 单位（分） |
| totalUnpaidServiceFee | Long | 是 | 尚欠总服务费 | 单位（分） |
| totalUnpaidPenalty | Long | 是 | 尚欠罚息 | 单位（分） |
| totalUnpaidClearServiceFee | Long | 否 | 尚欠提前结清手续费 | 单位（分） |
<repayPlanList>账单详情
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| period | Integer | 是 | 期次 | |
| destAmount | Long | 是 | 本期应还总金额 | 单位（分） 总金额=本金+利息+服务费+罚息 |
| destPrincipal | Long | 是 | 本期应还本金 | 单位（分） |
| destInterest | Long | 是 | 本期应还利息 | 单位（分） |
| destServiceFee | Long | 是 | 本期应还服务费 | 单位（分） |
| destPenalty | Long | 是 | 本期应还罚息 | 单位（分） |
| destClearServiceFee | Long | 否 | 本期应还提前结清手续费 | 单位（分） |
| shouldRepayDate | String | 是 | 本期应还款日 | 格式： yyyy-MM-dd |
| shouldBillDate | String | 是 | 本期账单日 | 格式：yyyy-MM-dd |
| paidAmount | Long | 是 | 本期实还金额 | 单位（分） 总金额=本金+利息+服务费+罚息 |
| paidPrincipal | Long | 是 | 本期实还本金 | 单位（分） |
| paidInterest | Long | 是 | 本期实还利息 | 单位（分） |
| paidServiceFee | Long | 是 | 本期实还服务费 | 单位（分） |
| paidPenalty | Long | 是 | 本期实还罚息 | 单位（分） |
| paidClearServiceFee | Long | 否 | 本期实还提前结清手续费 | 单位（分） |
| actualRepayTime | String | 否 | 本期实际还款时间 | 格式： yyyy-MM-dd HH:mm:ss |
| unPaidAmount | Long | 是 | 本期尚欠总金额 | 单位（分） 公式=应收-实收 |
| unPaidPrincipal | Long | 是 | 本期尚欠本金 | 单位（分） |
| unPaidInterest | Long | 是 | 本期尚欠利息 | 单位（分） |
| unPaidServiceFee | Long | 是 | 本期尚欠服务费 | 单位（分） |
| unPaidPenalty | Long | 是 | 本期尚欠罚息 | 单位（分） |
| unPaidClearServiceFee | Long | 否 | 本期尚欠提前结清手续费 | 单位（分） |
| termStatus | Integer | 是 | 本期还款状态 | 本期还款状态 1: 未到期(未到账单日) 2: 未逾期可还款(已过账单日且未过应还日) 3: 已逾期 4: 已结清 |
| overdueDays | Integer | 是 | 逾期天数 | 默认0 |
# CodeDescEnum状态枚举:
| status | desc |
|---|---|
| 0000 | 成功 |
| 1001 | 未发现可查询还款计划的进件 |
| 1101 | 该笔进件没有生成对应的还款计划 |
| 9999 | 其他(具体信息透传) |
← 4.3 订单状态查询 枚举项 →