1.9、还款相关
<h3>1.9.1. 当期应还列表查询接口</h3>
<ul>
<li>请求路径:/h5/repay/currentRepayPlan</li>
<li>请求方法:get</li>
<li>
<p>请求参数</p>
</li>
<li>
<p>本接口返回数据为该用户所有借款列表,显示在第二页列表中
</p>
</li>
<li>响应数据</li>
</ul>
<pre><code class="language-json"> {
&quot;meta&quot;: {
&quot;msg&quot;: &quot;成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;: {
&quot;CurrentRepayPlanList&quot;: [ // 当前用户应还列表
{
&quot;custNo&quot;: &quot;10005&quot;, // 客户号
&quot;loanNo&quot;: &quot;543543532432432432&quot;, // 合同号
&quot;periods&quot;: 12, // 借款期限
&quot;amount&quot;: 10000, // 借款金额
&quot;currentPeriods&quot;: 2, // 第几期,当前是第几期的还款信息
&quot;repayDate&quot;: 2025-03-15, // 应还款日期,格式为yyyy-MM-dd
&quot;loanStatus&quot;: &quot;disbursed&quot;, // 借款状态 disbursed:已放款, closed:已结清
&quot;currentAmount&quot;: 1200, // 本期应还总额
&quot;currentPrincipal&quot;: 800, // 本期应还本金
&quot;currentInterest&quot;: 200, // 本期应还利息
&quot;currentServiceFee&quot;: 200, // 本期应还服务费(除本金,利息,罚息以外的其他费用)
&quot;currentPenalty&quot;: 0, // 本期应还罚息
&quot;overdueDays&quot;: 0, // 逾期天数,若没有逾期则可能为空或0
&quot;loanApplyDate&quot;: 2025-02-15, // 借款日期,格式为yyyy-MM-dd
},
{
&quot;custNo&quot;: &quot;10005&quot;, // 客户号
&quot;loanNo&quot;: &quot;754354354353&quot;, // 合同号
&quot;periods&quot;: 12, // 借款期限
&quot;amount&quot;: 10000, // 借款金额
&quot;currentPeriods&quot;: 3, // 第几期,当前是第几期的还款信息
&quot;repayDate&quot;: 2025-03-12, // 应还款日期,格式为yyyy-MM-dd
&quot;loanStatus&quot;: &quot;&quot;, // 借款状态
&quot;currentAmount&quot;: 1200, // 本期应还总额
&quot;currentPrincipal&quot;: 800, // 本期应还本金
&quot;currentInterest&quot;: 200, // 本期应还利息
&quot;currentServiceFee&quot;: 200, // 本期应还服务费(除本金,利息,罚息以外的其他费用)
&quot;currentPenalty&quot;: 0, // 本期应还罚息
&quot;overdueDays&quot;: 0, // 逾期天数,若没有逾期则可能为空或0
&quot;loanApplyDate&quot;: 2025-01-12, // 借款日期,格式为yyyy-MM-dd
},
]
}
}</code></pre>
<h3>1.9.2. 查询全部借款信息接口</h3>
<ul>
<li>请求路径:/h5/repay/repayPlanList/{loanNo}</li>
<li>请求方法:get</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<pre><code class="language-json"> {
&quot;meta&quot;: {
&quot;msg&quot;: &quot;成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;: {
&quot;custNo&quot;: &quot;10005&quot;, // 客户号
&quot;loanNo&quot;: &quot;543543532432432432&quot;, // 合同号
&quot;periods&quot;: 12, // 借款期限
&quot;amount&quot;: 10000, // 借款金额
&quot;loanStatus&quot;: &quot;disbursed&quot;, // 借款状态 disbursed:已放款, closed:已结清
&quot;remainingAmount&quot;: &quot;&quot;, // 剩余待还金额
&quot;repayPlanList&quot;:[
{
&quot;loanNo&quot;: &quot;543543532432432432&quot;, // 合同号
&quot;currentPeriods&quot;: 1, // 第几期
&quot;repayDate&quot;: 2025-01-10, // 应还款日期
&quot;status&quot;: &quot;open&quot;, // 期次状态:&quot;open&quot;表示待还,&quot;settled&quot;表示已还,&quot;overdue&quot;表示逾期
&quot;amount&quot;: 1200, // 本期应还总额
&quot;principal&quot;: 1000, // 本期应还本金
&quot;interest&quot;: 200, // 本期应还利息
&quot;guaranteeFee&quot;: 200,// 本期应还担保费
&quot;serviceFee&quot;: 100,// 本期应还服务费
&quot;discountFee&quot;: 0,// 优惠
&quot;penalty&quot;: 0, // 本期应还罚息
&quot;overdueDays&quot;: 0, // 逾期天数,若没有逾期则可能为空或0
},
{
&quot;loanNo&quot;: &quot;543543532432432432&quot;, // 合同号
&quot;currentPeriods&quot;: 2, // 第几期
&quot;repayDate&quot;: 2025-02-10, // 应还款日期
&quot;status&quot;: &quot;open&quot;, // 期次状态:&quot;open&quot;表示待还,&quot;settled&quot;表示已还,&quot;overdue&quot;表示逾期
&quot;amount&quot;: 1200, // 本期应还总额
&quot;principal&quot;: 1000, // 本期应还本金
&quot;interest&quot;: 200, // 本期应还利息
&quot;guaranteeFee&quot;: 200,// 本期应还担保费
&quot;serviceFee&quot;: 100,// 本期应还服务费
&quot;discountFee&quot;: 0,// 优惠
&quot;penalty&quot;: 0, // 本期应还罚息
&quot;overdueDays&quot;: 0, // 逾期天数,若没有逾期则可能为空或0
},
{
&quot;loanNo&quot;: &quot;543543532432432432&quot;, // 合同号
&quot;currentPeriods&quot;: 3, // 第几期
&quot;repayDate&quot;: 2025-03-10, // 应还款日期
&quot;status&quot;: &quot;open&quot;, // 期次状态:&quot;open&quot;表示待还,&quot;settled&quot;表示已还,&quot;overdue&quot;表示逾期
&quot;amount&quot;: 1200, // 本期应还总额
&quot;principal&quot;: 1000, // 本期应还本金
&quot;interest&quot;: 200, // 本期应还利息
&quot;guaranteeFee&quot;: 200,// 本期应还担保费
&quot;serviceFee&quot;: 100,// 本期应还服务费
&quot;discountFee&quot;: 0,// 优惠
&quot;penalty&quot;: 0, // 本期应还罚息
&quot;overdueDays&quot;: 0, // 逾期天数,若没有逾期则可能为空或0
}
],
&quot;bankcardInfo&quot;: {
&quot;bankcardId&quot;: &quot;1223&quot;, // 银行卡ID
&quot;bankcardNo&quot;: &quot;54354354354354354354&quot;, // 银行卡号
&quot;bankCode&quot;: &quot;ICBC&quot;, // 银行代码
&quot;bankName&quot;: &quot;工商银行&quot;, // 银行名称
&quot;mobile&quot;: &quot;13800138000&quot;, // 银行卡绑定手机号
}
}
}</code></pre>
<h3>1.9.3. 还款申请接口</h3>
<ul>
<li>请求路径:/h5/repay/apply</li>
<li>请求方法:post</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>类型 </th>
<th>是否必须</th>
<th>说明 </th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>loanNo </td>
<td>String</td>
<td>是 </td>
<td>借款号 </td>
<td> </td>
</tr>
<tr>
<td>repayType </td>
<td>String </td>
<td>是 </td>
<td>还款类型 </td>
<td>overdue:还清全部逾期;payoff:全额还清;current:按期还款 </td>
</tr>
<tr>
<td>bankCardId </td>
<td>int</td>
<td>否 </td>
<td>银行卡ID </td>
<td> </td>
</tr>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<pre><code class="language-json"> {
&quot;meta&quot;: {
&quot;msg&quot;: &quot;成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;:{
&quot;repaySeqNo&quot;:11232321,//还款流水号
}
}</code></pre>
<h3>1.9.4. 查询还款详情接口</h3>
<ul>
<li>请求路径:/h5/repay/getRepayDetailList</li>
<li>请求方法:get</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>month</td>
<td>月份 </td>
<td>根据月份查询如查一年内的传12, 全部不用传</td>
</tr>
<tr>
<td>loanState</td>
<td>贷款状态 </td>
<td>success:还款成功 , failed:还款失败, processing: 还款中, 全部不用传</td>
</tr>
</tbody>
</table>
<ul>
<li>响应数据</li>
</ul>
<pre><code class="language-json"> {
&quot;meta&quot;: {
&quot;msg&quot;: &quot;成功&quot;,
&quot;status&quot;: 200
},
&quot;data&quot;: [
{
&quot;loanNo&quot;: &quot;5454545454545454545454545&quot;,
&quot;amount&quot;: 2000,
&quot;state&quot;: &quot;success&quot;,//success:还款成功 , failed:还款失败, processing: 还款中
&quot;type&quot;: &quot;10&quot;,// 10:主动还款,20:代扣
&quot;bankcardNo&quot;: &quot;545435435435435345&quot;,
&quot;bankName&quot;: &quot;工商银行&quot;,
&quot;repaySeqNo&quot;: &quot;43243243243243&quot;,
&quot;repayDate&quot;: &quot;2025-03-12T04:30:38.000+00:00&quot;,
&quot;dueDate&quot;: &quot;2025-03-14T16:00:00.000+00:00&quot;
},
]
}</code></pre>