兄弟公司前端接口

后端接口api返回数据格式


1.9、还款相关

<h3>1.9.1. 当期应还列表查询接口</h3> <ul> <li>请求路径:/h5/repay/currentRepayPlan</li> <li>请求方法:get</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;custNo&amp;quot;: &amp;quot;10005&amp;quot;, // 客户号                 &amp;quot;loanNo&amp;quot;: &amp;quot;543543532432432432&amp;quot;, // 合同号 &amp;quot;periods&amp;quot;: 12, // 借款期限 &amp;quot;amount&amp;quot;: 10000, // 借款金额 &amp;quot;currentPeriods&amp;quot;: 2, // 第几期,当前是第几期的还款信息 &amp;quot;repayDate&amp;quot;: 2025-03-15, // 应还款日期,格式为yyyy-MM-dd &amp;quot;loanStatus&amp;quot;: &amp;quot;disbursed&amp;quot;, // 借款状态 disbursed:已放款, closed:已结清 &amp;quot;currentAmount&amp;quot;: 1200, // 本期应还总额 &amp;quot;currentPrincipal&amp;quot;: 800, // 本期应还本金 &amp;quot;currentInterest&amp;quot;: 200, // 本期应还利息 &amp;quot;currentServiceFee&amp;quot;: 200, // 本期应还服务费(除本金,利息,罚息以外的其他费用) &amp;quot;currentPenalty&amp;quot;: 0, // 本期应还罚息 &amp;quot;overdueDays&amp;quot;: 0, // 逾期天数,若没有逾期则可能为空或0 &amp;quot;loanApplyDate&amp;quot;: 2025-02-15, // 借款日期,格式为yyyy-MM-dd             },             { &amp;quot;custNo&amp;quot;: &amp;quot;10005&amp;quot;, // 客户号 &amp;quot;loanNo&amp;quot;: &amp;quot;754354354353&amp;quot;, // 合同号 &amp;quot;periods&amp;quot;: 12, // 借款期限 &amp;quot;amount&amp;quot;: 10000, // 借款金额 &amp;quot;currentPeriods&amp;quot;: 3, // 第几期,当前是第几期的还款信息 &amp;quot;repayDate&amp;quot;: 2025-03-12, // 应还款日期,格式为yyyy-MM-dd &amp;quot;loanStatus&amp;quot;: &amp;quot;&amp;quot;, // 借款状态 &amp;quot;currentAmount&amp;quot;: 1200, // 本期应还总额 &amp;quot;currentPrincipal&amp;quot;: 800, // 本期应还本金 &amp;quot;currentInterest&amp;quot;: 200, // 本期应还利息 &amp;quot;currentServiceFee&amp;quot;: 200, // 本期应还服务费(除本金,利息,罚息以外的其他费用) &amp;quot;currentPenalty&amp;quot;: 0, // 本期应还罚息 &amp;quot;overdueDays&amp;quot;: 0, // 逾期天数,若没有逾期则可能为空或0 &amp;quot;loanApplyDate&amp;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">  {       &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;custNo&amp;quot;: &amp;quot;10005&amp;quot;, // 客户号         &amp;quot;loanNo&amp;quot;: &amp;quot;543543532432432432&amp;quot;, // 合同号 &amp;quot;periods&amp;quot;: 12, // 借款期限 &amp;quot;amount&amp;quot;: 10000, // 借款金额 &amp;quot;loanStatus&amp;quot;: &amp;quot;disbursed&amp;quot;, // 借款状态 disbursed:已放款, closed:已结清 &amp;quot;remainingAmount&amp;quot;: &amp;quot;&amp;quot;, // 剩余待还金额         &amp;quot;repayPlanList&amp;quot;:[ { &amp;quot;loanNo&amp;quot;: &amp;quot;543543532432432432&amp;quot;, // 合同号 &amp;quot;currentPeriods&amp;quot;: 1, // 第几期 &amp;quot;repayDate&amp;quot;: 2025-01-10, // 应还款日期 &amp;quot;status&amp;quot;: &amp;quot;open&amp;quot;, // 期次状态:&amp;quot;open&amp;quot;表示待还,&amp;quot;settled&amp;quot;表示已还,&amp;quot;overdue&amp;quot;表示逾期 &amp;quot;amount&amp;quot;: 1200, // 本期应还总额 &amp;quot;principal&amp;quot;: 1000, // 本期应还本金 &amp;quot;interest&amp;quot;: 200, // 本期应还利息 &amp;quot;guaranteeFee&amp;quot;: 200,// 本期应还担保费 &amp;quot;serviceFee&amp;quot;: 100,// 本期应还服务费 &amp;quot;discountFee&amp;quot;: 0,// 优惠 &amp;quot;penalty&amp;quot;: 0, // 本期应还罚息 &amp;quot;overdueDays&amp;quot;: 0, // 逾期天数,若没有逾期则可能为空或0 }, { &amp;quot;loanNo&amp;quot;: &amp;quot;543543532432432432&amp;quot;, // 合同号 &amp;quot;currentPeriods&amp;quot;: 2, // 第几期 &amp;quot;repayDate&amp;quot;: 2025-02-10, // 应还款日期 &amp;quot;status&amp;quot;: &amp;quot;open&amp;quot;, // 期次状态:&amp;quot;open&amp;quot;表示待还,&amp;quot;settled&amp;quot;表示已还,&amp;quot;overdue&amp;quot;表示逾期 &amp;quot;amount&amp;quot;: 1200, // 本期应还总额 &amp;quot;principal&amp;quot;: 1000, // 本期应还本金 &amp;quot;interest&amp;quot;: 200, // 本期应还利息 &amp;quot;guaranteeFee&amp;quot;: 200,// 本期应还担保费 &amp;quot;serviceFee&amp;quot;: 100,// 本期应还服务费 &amp;quot;discountFee&amp;quot;: 0,// 优惠 &amp;quot;penalty&amp;quot;: 0, // 本期应还罚息 &amp;quot;overdueDays&amp;quot;: 0, // 逾期天数,若没有逾期则可能为空或0 }, { &amp;quot;loanNo&amp;quot;: &amp;quot;543543532432432432&amp;quot;, // 合同号 &amp;quot;currentPeriods&amp;quot;: 3, // 第几期 &amp;quot;repayDate&amp;quot;: 2025-03-10, // 应还款日期 &amp;quot;status&amp;quot;: &amp;quot;open&amp;quot;, // 期次状态:&amp;quot;open&amp;quot;表示待还,&amp;quot;settled&amp;quot;表示已还,&amp;quot;overdue&amp;quot;表示逾期 &amp;quot;amount&amp;quot;: 1200, // 本期应还总额 &amp;quot;principal&amp;quot;: 1000, // 本期应还本金 &amp;quot;interest&amp;quot;: 200, // 本期应还利息 &amp;quot;guaranteeFee&amp;quot;: 200,// 本期应还担保费 &amp;quot;serviceFee&amp;quot;: 100,// 本期应还服务费 &amp;quot;discountFee&amp;quot;: 0,// 优惠 &amp;quot;penalty&amp;quot;: 0, // 本期应还罚息 &amp;quot;overdueDays&amp;quot;: 0, // 逾期天数,若没有逾期则可能为空或0 } ],         &amp;quot;bankcardInfo&amp;quot;: { &amp;quot;bankcardId&amp;quot;: &amp;quot;1223&amp;quot;, // 银行卡ID &amp;quot;bankcardNo&amp;quot;: &amp;quot;54354354354354354354&amp;quot;, // 银行卡号 &amp;quot;bankCode&amp;quot;: &amp;quot;ICBC&amp;quot;, // 银行代码 &amp;quot;bankName&amp;quot;: &amp;quot;工商银行&amp;quot;, // 银行名称 &amp;quot;mobile&amp;quot;: &amp;quot;13800138000&amp;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">  {       &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> <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">  {       &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;loanNo&amp;quot;: &amp;quot;5454545454545454545454545&amp;quot;, &amp;quot;amount&amp;quot;: 2000, &amp;quot;state&amp;quot;: &amp;quot;success&amp;quot;,//success:还款成功 , failed:还款失败, processing: 还款中 &amp;quot;type&amp;quot;: &amp;quot;10&amp;quot;,// 10:主动还款,20:代扣 &amp;quot;bankcardNo&amp;quot;: &amp;quot;545435435435435345&amp;quot;, &amp;quot;bankName&amp;quot;: &amp;quot;工商银行&amp;quot;, &amp;quot;repaySeqNo&amp;quot;: &amp;quot;43243243243243&amp;quot;, &amp;quot;repayDate&amp;quot;: &amp;quot;2025-03-12T04:30:38.000+00:00&amp;quot;, &amp;quot;dueDate&amp;quot;: &amp;quot;2025-03-14T16:00:00.000+00:00&amp;quot; }, ] }</code></pre>

页面列表

ITEM_HTML