1.9、还款相关
<h3>1.9.1. 当期应还列表查询接口</h3>
<ul>
<li>请求路径:/repay/CurrentRepayPlan/{custNo}</li>
<li>请求方法:post</li>
<li>
<p>请求参数</p>
</li>
<li>
<p>本接口返回数据为该用户所有借款列表,显示在第二页列表中
![用户所有借款列表](<a href="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=365bd1c563b6a55ca736e4acd663a46e&file=file.png">https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=365bd1c563b6a55ca736e4acd663a46e&file=file.png</a> "用户所有借款列表")</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;orderNo&quot;: &quot;1&quot;, // 分期订单号
&quot;outOrderNo&quot;: &quot;11&quot;, // 合同号
&quot;totalTerm&quot;: 12, // 总期次,即整个贷款分为多少期偿还
&quot;totalAmount&quot;: &quot;1000.00&quot;, // 应还总额
&quot;termNo&quot;: 3, // 第几期,当前是第几期的还款信息
&quot;earliestRepayDate&quot;: &quot;20241215&quot;, // 最早还款日期,格式为yyyyMMdd
&quot;shouldRepayDate&quot;: &quot;20241215&quot;, // 应还款日期,格式为yyyyMMdd
&quot;termStatus&quot;: &quot;0&quot;, // 期次状态:&quot;0&quot;表示正常,&quot;1&quot;表示还款中
&quot;termAmount&quot;: &quot;975.00&quot;, // 本期应还总额
&quot;termPrincipal&quot;: &quot;800.00&quot;, // 本期应还本金(剩余未还本金)
&quot;termInterest&quot;: &quot;150.00&quot;, // 本期应还利息(不包含担保费)
&quot;termGuaranteed&quot;: &quot;25.00&quot;, // 本期应还担保费(某些渠道特有拆费需要)
&quot;termPrincipalPenalty&quot;: &quot;0.00&quot;, // 本期应还本金罚息
&quot;termInterPenalty&quot;: &quot;0.00&quot;, // 本期应还利息罚息
&quot;overdueDays&quot;: null, // 逾期天数,若没有逾期则可能为空或0
&quot;overdueAmt&quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空
&quot;overdue&quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期
&quot;loanDate&quot;: &quot;20240101&quot;, // 借款日期,格式为yyyyMMdd
&quot;haveRepayAmount&quot;: &quot;2400.00&quot;, // 已还金额,已经偿还的总金额
&quot;valueDate&quot;: &quot;20240101&quot; // 起息日,格式为yyyyMMdd
},
{
&quot;orderNo&quot;: &quot;2&quot;, // 分期订单号
&quot;outOrderNo&quot;: &quot;22&quot;, // 合同号
&quot;totalTerm&quot;: 12, // 总期次,即整个贷款分为多少期偿还
&quot;totalAmount&quot;: &quot;1000.00&quot;, // 应还总额
&quot;termNo&quot;: 3, // 第几期,当前是第几期的还款信息
&quot;earliestRepayDate&quot;: &quot;20241215&quot;, // 最早还款日期,格式为yyyyMMdd
&quot;shouldRepayDate&quot;: &quot;20241215&quot;, // 应还款日期,格式为yyyyMMdd
&quot;termStatus&quot;: &quot;0&quot;, // 期次状态:&quot;0&quot;表示正常,&quot;1&quot;表示还款中
&quot;termAmount&quot;: &quot;975.00&quot;, // 本期应还总额
&quot;termPrincipal&quot;: &quot;800.00&quot;, // 本期应还本金(剩余未还本金)
&quot;termInterest&quot;: &quot;150.00&quot;, // 本期应还利息(不包含担保费)
&quot;termGuaranteed&quot;: &quot;25.00&quot;, // 本期应还担保费(某些渠道特有拆费需要)
&quot;termPrincipalPenalty&quot;: &quot;0.00&quot;, // 本期应还本金罚息
&quot;termInterPenalty&quot;: &quot;0.00&quot;, // 本期应还利息罚息
&quot;overdueDays&quot;: null, // 逾期天数,若没有逾期则可能为空或0
&quot;overdueAmt&quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空
&quot;overdue&quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期
&quot;loanDate&quot;: &quot;20240101&quot;, // 借款日期,格式为yyyyMMdd
&quot;haveRepayAmount&quot;: &quot;2400.00&quot;, // 已还金额,已经偿还的总金额
&quot;valueDate&quot;: &quot;20240101&quot; // 起息日,格式为yyyyMMdd
},
]
}
}</code></pre>
<h3>1.9.2. 查询分期订单信息接口</h3>
<ul>
<li>请求路径:/repay/repayPlanList</li>
<li>请求方法:post</li>
<li>请求参数</li>
</ul>
<table>
<thead>
<tr>
<th>参数名 </th>
<th>参数说明</th>
<th>备注 </th>
</tr>
</thead>
<tbody>
<tr>
<td>orderNo</td>
<td>分期订单号 </td>
<td>不能为空</td>
</tr>
<tr>
<td>outOrderNo</td>
<td>合同号 </td>
<td>不能为空</td>
</tr>
</tbody>
</table>
<ul>
<li>
<p>orderInfo是点击去还款按钮是获取的当前借据的订单信息,repayPlanList是当前借据的分期信息</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;orderInfo&quot;:{
&quot;orderNo&quot;: &quot;123456789&quot;, // 分期订单号
&quot;outOrderNo&quot;: &quot;987654321&quot;, // 合同号
&quot;totalTerm&quot;: 12, // 总期次,即整个贷款分为多少期偿还
&quot;totalAmount&quot;: 20000.00, // 当前借据总借款金额
&quot;termNo&quot;: 3, // 第几期,当前是第几期的还款信息
&quot;termPrincipal&quot;: &quot;800.00&quot;, // 应还本金(剩余未还本金)
&quot;termInterest&quot;: &quot;150.00&quot;, // 应还利息(不包含担保费)
&quot;termGuaranteed&quot;: &quot;25.00&quot;, // 应还担保费(某些渠道特有拆费需要)
&quot;termPrincipalPenalty&quot;: &quot;0.00&quot;, // 应还本金罚息
&quot;termInterPenalty&quot;: &quot;0.00&quot;, // 应还利息罚息
&quot;overdueDays&quot;: null, // 逾期天数,若没有逾期则可能为空或0
&quot;overdueAmt&quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空
&quot;overdue&quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期
&quot;loanDate&quot;: &quot;20240101&quot;, // 借款日期,格式为yyyyMMdd
&quot;haveRepayAmount&quot;: &quot;2400.00&quot;, // 已还金额,已经偿还的总金额
&quot;valueDate&quot;: &quot;20240101&quot; // 起息日,格式为yyyyMMdd
},
&quot;repayPlanList&quot;: [ // 剩余还款列表,包含所有待还款和未结清的订单期次信息
{
&quot;orderNo&quot;: &quot;123456789&quot;, // 分期订单号
&quot;outOrderNo&quot;: &quot;987654321&quot;, // 合同号
&quot;totalTerm&quot;: 12, // 总期次,即整个贷款分为多少期偿还
&quot;termNo&quot;: 3, // 第几期,当前是第几期的还款信息
&quot;earliestRepayDate&quot;: &quot;20241215&quot;, // 最早还款日期,格式为yyyyMMdd
&quot;shouldRepayDate&quot;: &quot;20241215&quot;, // 应还款日期,格式为yyyyMMdd
&quot;termStatus&quot;: &quot;0&quot;, // 期次状态:&quot;0&quot;表示正常,&quot;1&quot;表示还款中
&quot;termAmount&quot;: &quot;1000.00&quot;, // 本期应还总额(剩余未还金额)
&quot;termPrincipal&quot;: &quot;800.00&quot;, // 本期应还本金(剩余未还本金)
&quot;termInterest&quot;: &quot;150.00&quot;, // 本期应还利息(不包含担保费)
&quot;termGuaranteed&quot;: &quot;25.00&quot;, // 本期应还担保费(某些渠道特有拆费需要)
&quot;termPrincipalPenalty&quot;: &quot;0.00&quot;, // 本期应还本金罚息
&quot;termInterPenalty&quot;: &quot;0.00&quot;, // 本期应还利息罚息
&quot;overdueDays&quot;: null, // 逾期天数,若没有逾期则可能为空或0
&quot;overdueAmt&quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空
&quot;overdue&quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期
&quot;isCurrentRepayPlan&quot;: &quot;Y&quot;, // 是否当期还款计划,Y表示是,N表示不是
&quot;loanDate&quot;: &quot;20240101&quot;, // 借款日期,格式为yyyyMMdd
&quot;haveRepayAmount&quot;: &quot;2400.00&quot;, // 已还金额,已经偿还的总金额
&quot;valueDate&quot;: &quot;20240101&quot; // 起息日,格式为yyyyMMdd
},
{
&quot;orderNo&quot;: &quot;123456789&quot;, // 分期订单号
&quot;outOrderNo&quot;: &quot;987654321&quot;, // 合同号
&quot;totalTerm&quot;: 12, // 总期次,即整个贷款分为多少期偿还
&quot;termNo&quot;: 3, // 第几期,当前是第几期的还款信息
&quot;earliestRepayDate&quot;: &quot;20241215&quot;, // 最早还款日期,格式为yyyyMMdd
&quot;shouldRepayDate&quot;: &quot;20241215&quot;, // 应还款日期,格式为yyyyMMdd
&quot;termStatus&quot;: &quot;0&quot;, // 期次状态:&quot;0&quot;表示正常,&quot;1&quot;表示还款中
&quot;termAmount&quot;: &quot;1000.00&quot;, // 本期应还总额(剩余未还金额)
&quot;termPrincipal&quot;: &quot;800.00&quot;, // 本期应还本金(剩余未还本金)
&quot;termInterest&quot;: &quot;150.00&quot;, // 本期应还利息(不包含担保费)
&quot;termGuaranteed&quot;: &quot;25.00&quot;, // 本期应还担保费(某些渠道特有拆费需要)
&quot;termPrincipalPenalty&quot;: &quot;0.00&quot;, // 本期应还本金罚息
&quot;termInterPenalty&quot;: &quot;0.00&quot;, // 本期应还利息罚息
&quot;overdueDays&quot;: null, // 逾期天数,若没有逾期则可能为空或0
&quot;overdueAmt&quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空
&quot;overdue&quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期
&quot;isCurrentRepayPlan&quot;: &quot;N&quot;, // 是否当期还款计划,Y表示是,N表示不是
&quot;loanDate&quot;: &quot;20240101&quot;, // 借款日期,格式为yyyyMMdd
&quot;haveRepayAmount&quot;: &quot;2400.00&quot;, // 已还金额,已经偿还的总金额
&quot;valueDate&quot;: &quot;20240101&quot; // 起息日,格式为yyyyMMdd
},
]
}
}</code></pre>
<h3>1.9.3. 还款申请接口</h3>
<ul>
<li>请求路径:/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>userId </td>
<td>String</td>
<td>是 </td>
<td>用户ID </td>
<td> </td>
</tr>
<tr>
<td>repayList </td>
<td>数组 </td>
<td>是 </td>
<td>还款列表 </td>
<td>数组里面保存分期orderNo </td>
</tr>
<tr>
<td>mobileNo </td>
<td>String</td>
<td>否 </td>
<td>手机号 </td>
<td>动码不为空时必填 </td>
</tr>
<tr>
<td>totalAmount</td>
<td>String</td>
<td>是 </td>
<td>总还款金额 </td>
<td>调用试算后的减免金额 </td>
</tr>
<tr>
<td>repayType </td>
<td>String</td>
<td>是 </td>
<td>还款类型 </td>
<td>PRE:提前还款;DO:正常还款 </td>
</tr>
<tr>
<td>bankCardId </td>
<td>String</td>
<td>是 </td>
<td>绑卡ID </td>
<td> </td>
</tr>
<tr>
<td>smsCode </td>
<td>String</td>
<td>否 </td>
<td>短信验证码 </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>