兄弟公司前端接口

后端接口api返回数据格式


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&amp;file=file.png">https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=365bd1c563b6a55ca736e4acd663a46e&amp;file=file.png</a> &quot;用户所有借款列表&quot;)</p> </li> <li>响应数据</li> </ul> <pre><code class="language-json">  {       &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     },     &amp;quot;data&amp;quot;: {         &amp;quot;CurrentRepayPlanList&amp;quot;: [ // 当前用户应还列表             {                 &amp;quot;orderNo&amp;quot;: &amp;quot;1&amp;quot;, // 分期订单号                 &amp;quot;outOrderNo&amp;quot;: &amp;quot;11&amp;quot;, // 合同号                 &amp;quot;totalTerm&amp;quot;: 12, // 总期次,即整个贷款分为多少期偿还 &amp;quot;totalAmount&amp;quot;: &amp;quot;1000.00&amp;quot;, // 应还总额                 &amp;quot;termNo&amp;quot;: 3, // 第几期,当前是第几期的还款信息                 &amp;quot;earliestRepayDate&amp;quot;: &amp;quot;20241215&amp;quot;, // 最早还款日期,格式为yyyyMMdd                 &amp;quot;shouldRepayDate&amp;quot;: &amp;quot;20241215&amp;quot;, // 应还款日期,格式为yyyyMMdd                 &amp;quot;termStatus&amp;quot;: &amp;quot;0&amp;quot;, // 期次状态:&amp;quot;0&amp;quot;表示正常,&amp;quot;1&amp;quot;表示还款中 &amp;quot;termAmount&amp;quot;: &amp;quot;975.00&amp;quot;, // 本期应还总额                 &amp;quot;termPrincipal&amp;quot;: &amp;quot;800.00&amp;quot;, // 本期应还本金(剩余未还本金)                 &amp;quot;termInterest&amp;quot;: &amp;quot;150.00&amp;quot;, // 本期应还利息(不包含担保费)                 &amp;quot;termGuaranteed&amp;quot;: &amp;quot;25.00&amp;quot;, // 本期应还担保费(某些渠道特有拆费需要)                 &amp;quot;termPrincipalPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 本期应还本金罚息                 &amp;quot;termInterPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 本期应还利息罚息                 &amp;quot;overdueDays&amp;quot;: null, // 逾期天数,若没有逾期则可能为空或0                 &amp;quot;overdueAmt&amp;quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空                 &amp;quot;overdue&amp;quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期                 &amp;quot;loanDate&amp;quot;: &amp;quot;20240101&amp;quot;, // 借款日期,格式为yyyyMMdd                 &amp;quot;haveRepayAmount&amp;quot;: &amp;quot;2400.00&amp;quot;, // 已还金额,已经偿还的总金额                 &amp;quot;valueDate&amp;quot;: &amp;quot;20240101&amp;quot; // 起息日,格式为yyyyMMdd             },             {                 &amp;quot;orderNo&amp;quot;: &amp;quot;2&amp;quot;, // 分期订单号                 &amp;quot;outOrderNo&amp;quot;: &amp;quot;22&amp;quot;, // 合同号                 &amp;quot;totalTerm&amp;quot;: 12, // 总期次,即整个贷款分为多少期偿还 &amp;quot;totalAmount&amp;quot;: &amp;quot;1000.00&amp;quot;, // 应还总额                 &amp;quot;termNo&amp;quot;: 3, // 第几期,当前是第几期的还款信息                 &amp;quot;earliestRepayDate&amp;quot;: &amp;quot;20241215&amp;quot;, // 最早还款日期,格式为yyyyMMdd                 &amp;quot;shouldRepayDate&amp;quot;: &amp;quot;20241215&amp;quot;, // 应还款日期,格式为yyyyMMdd                 &amp;quot;termStatus&amp;quot;: &amp;quot;0&amp;quot;, // 期次状态:&amp;quot;0&amp;quot;表示正常,&amp;quot;1&amp;quot;表示还款中 &amp;quot;termAmount&amp;quot;: &amp;quot;975.00&amp;quot;, // 本期应还总额                 &amp;quot;termPrincipal&amp;quot;: &amp;quot;800.00&amp;quot;, // 本期应还本金(剩余未还本金)                 &amp;quot;termInterest&amp;quot;: &amp;quot;150.00&amp;quot;, // 本期应还利息(不包含担保费)                 &amp;quot;termGuaranteed&amp;quot;: &amp;quot;25.00&amp;quot;, // 本期应还担保费(某些渠道特有拆费需要)                 &amp;quot;termPrincipalPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 本期应还本金罚息                 &amp;quot;termInterPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 本期应还利息罚息                 &amp;quot;overdueDays&amp;quot;: null, // 逾期天数,若没有逾期则可能为空或0                 &amp;quot;overdueAmt&amp;quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空                 &amp;quot;overdue&amp;quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期                 &amp;quot;loanDate&amp;quot;: &amp;quot;20240101&amp;quot;, // 借款日期,格式为yyyyMMdd                 &amp;quot;haveRepayAmount&amp;quot;: &amp;quot;2400.00&amp;quot;, // 已还金额,已经偿还的总金额                 &amp;quot;valueDate&amp;quot;: &amp;quot;20240101&amp;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">  {       &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     },     &amp;quot;data&amp;quot;: {         &amp;quot;orderInfo&amp;quot;:{             &amp;quot;orderNo&amp;quot;: &amp;quot;123456789&amp;quot;, // 分期订单号                 &amp;quot;outOrderNo&amp;quot;: &amp;quot;987654321&amp;quot;, // 合同号                 &amp;quot;totalTerm&amp;quot;: 12, // 总期次,即整个贷款分为多少期偿还 &amp;quot;totalAmount&amp;quot;: 20000.00, // 当前借据总借款金额                 &amp;quot;termNo&amp;quot;: 3, // 第几期,当前是第几期的还款信息                 &amp;quot;termPrincipal&amp;quot;: &amp;quot;800.00&amp;quot;, // 应还本金(剩余未还本金)                 &amp;quot;termInterest&amp;quot;: &amp;quot;150.00&amp;quot;, // 应还利息(不包含担保费)                 &amp;quot;termGuaranteed&amp;quot;: &amp;quot;25.00&amp;quot;, // 应还担保费(某些渠道特有拆费需要)                 &amp;quot;termPrincipalPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 应还本金罚息                 &amp;quot;termInterPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 应还利息罚息                 &amp;quot;overdueDays&amp;quot;: null, // 逾期天数,若没有逾期则可能为空或0                 &amp;quot;overdueAmt&amp;quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空                 &amp;quot;overdue&amp;quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期                 &amp;quot;loanDate&amp;quot;: &amp;quot;20240101&amp;quot;, // 借款日期,格式为yyyyMMdd                 &amp;quot;haveRepayAmount&amp;quot;: &amp;quot;2400.00&amp;quot;, // 已还金额,已经偿还的总金额                 &amp;quot;valueDate&amp;quot;: &amp;quot;20240101&amp;quot; // 起息日,格式为yyyyMMdd         },         &amp;quot;repayPlanList&amp;quot;: [ // 剩余还款列表,包含所有待还款和未结清的订单期次信息             {                 &amp;quot;orderNo&amp;quot;: &amp;quot;123456789&amp;quot;, // 分期订单号                 &amp;quot;outOrderNo&amp;quot;: &amp;quot;987654321&amp;quot;, // 合同号                 &amp;quot;totalTerm&amp;quot;: 12, // 总期次,即整个贷款分为多少期偿还                 &amp;quot;termNo&amp;quot;: 3, // 第几期,当前是第几期的还款信息                 &amp;quot;earliestRepayDate&amp;quot;: &amp;quot;20241215&amp;quot;, // 最早还款日期,格式为yyyyMMdd                 &amp;quot;shouldRepayDate&amp;quot;: &amp;quot;20241215&amp;quot;, // 应还款日期,格式为yyyyMMdd                 &amp;quot;termStatus&amp;quot;: &amp;quot;0&amp;quot;, // 期次状态:&amp;quot;0&amp;quot;表示正常,&amp;quot;1&amp;quot;表示还款中                 &amp;quot;termAmount&amp;quot;: &amp;quot;1000.00&amp;quot;, // 本期应还总额(剩余未还金额)                 &amp;quot;termPrincipal&amp;quot;: &amp;quot;800.00&amp;quot;, // 本期应还本金(剩余未还本金)                 &amp;quot;termInterest&amp;quot;: &amp;quot;150.00&amp;quot;, // 本期应还利息(不包含担保费)                 &amp;quot;termGuaranteed&amp;quot;: &amp;quot;25.00&amp;quot;, // 本期应还担保费(某些渠道特有拆费需要)                 &amp;quot;termPrincipalPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 本期应还本金罚息                 &amp;quot;termInterPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 本期应还利息罚息                 &amp;quot;overdueDays&amp;quot;: null, // 逾期天数,若没有逾期则可能为空或0                 &amp;quot;overdueAmt&amp;quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空                 &amp;quot;overdue&amp;quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期                 &amp;quot;isCurrentRepayPlan&amp;quot;: &amp;quot;Y&amp;quot;, // 是否当期还款计划,Y表示是,N表示不是                 &amp;quot;loanDate&amp;quot;: &amp;quot;20240101&amp;quot;, // 借款日期,格式为yyyyMMdd                 &amp;quot;haveRepayAmount&amp;quot;: &amp;quot;2400.00&amp;quot;, // 已还金额,已经偿还的总金额                 &amp;quot;valueDate&amp;quot;: &amp;quot;20240101&amp;quot; // 起息日,格式为yyyyMMdd             },             {                 &amp;quot;orderNo&amp;quot;: &amp;quot;123456789&amp;quot;, // 分期订单号                 &amp;quot;outOrderNo&amp;quot;: &amp;quot;987654321&amp;quot;, // 合同号                 &amp;quot;totalTerm&amp;quot;: 12, // 总期次,即整个贷款分为多少期偿还                 &amp;quot;termNo&amp;quot;: 3, // 第几期,当前是第几期的还款信息                 &amp;quot;earliestRepayDate&amp;quot;: &amp;quot;20241215&amp;quot;, // 最早还款日期,格式为yyyyMMdd                 &amp;quot;shouldRepayDate&amp;quot;: &amp;quot;20241215&amp;quot;, // 应还款日期,格式为yyyyMMdd                 &amp;quot;termStatus&amp;quot;: &amp;quot;0&amp;quot;, // 期次状态:&amp;quot;0&amp;quot;表示正常,&amp;quot;1&amp;quot;表示还款中                 &amp;quot;termAmount&amp;quot;: &amp;quot;1000.00&amp;quot;, // 本期应还总额(剩余未还金额)                 &amp;quot;termPrincipal&amp;quot;: &amp;quot;800.00&amp;quot;, // 本期应还本金(剩余未还本金)                 &amp;quot;termInterest&amp;quot;: &amp;quot;150.00&amp;quot;, // 本期应还利息(不包含担保费)                 &amp;quot;termGuaranteed&amp;quot;: &amp;quot;25.00&amp;quot;, // 本期应还担保费(某些渠道特有拆费需要)                 &amp;quot;termPrincipalPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 本期应还本金罚息                 &amp;quot;termInterPenalty&amp;quot;: &amp;quot;0.00&amp;quot;, // 本期应还利息罚息                 &amp;quot;overdueDays&amp;quot;: null, // 逾期天数,若没有逾期则可能为空或0                 &amp;quot;overdueAmt&amp;quot;: null, // 逾期金额=本金+利息+罚息,若没有逾期则为空                 &amp;quot;overdue&amp;quot;: null, // 逾期标志,Y表示逾期,N表示没有逾期                 &amp;quot;isCurrentRepayPlan&amp;quot;: &amp;quot;N&amp;quot;, // 是否当期还款计划,Y表示是,N表示不是                 &amp;quot;loanDate&amp;quot;: &amp;quot;20240101&amp;quot;, // 借款日期,格式为yyyyMMdd                 &amp;quot;haveRepayAmount&amp;quot;: &amp;quot;2400.00&amp;quot;, // 已还金额,已经偿还的总金额                 &amp;quot;valueDate&amp;quot;: &amp;quot;20240101&amp;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">  {       &amp;quot;meta&amp;quot;: {         &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;,         &amp;quot;status&amp;quot;: 200     },     &amp;quot;data&amp;quot;:{         &amp;quot;repaySeqNo&amp;quot;:11232321,//还款流水号     } }</code></pre>

页面列表

ITEM_HTML