# 5.1 合同
# 5.1.1 借款试算
# 接口说明：
- 接口由宜信提供，合作方调用。根据用户选择的借款金额、期数、还款方式， 宜信返回还款计划。
# 接口地址：
loan.trial
# 请求参数：
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| openId | String | 是 | 用户 ID | |
| loanAmount | Long | 是 | 借款金额 | 单位为分 示例：500000 表示 5000元 |
| scene | Integer | 是 | 场景 | 0：预试算 1：真实试算 |
# 响应参数：
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| status | String | 是 | 借款试算返回状态码 | 0000：成功 0001：失败 |
| desc | String | 否 | 失败描述 | 错误描述 |
| trialDetails | List | 是 | 试算详情 |
== 试算详情trialDetails==
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| termNum | Integer | 是 | 借款期次（成功时必传） | 总期次 |
| interestType | Integer | 否 | 计息方式 | 见计息方式枚举 |
| compositeRate | String | 是 | 综合年化利率（成功时必传） | 示例：19.92 表示19.92% |
| repayPrincipal | Long | 是 | 应还本金总额（成功时必传） | 单位 （分） |
| totalInterest | Long | 是 | 应还利息总额（成功时必传） | 单位 （分） |
| totalServiceFee | Long | 是 | 应还服务费总额（成功时必传） | 单位 （分） |
| repayPenalty | Long | 否 | 应还罚息 | 单位 （分） |
| repayDate | String | 是 | 首次还款日（成功时必传） | yyyy-MM-dd 示例：2020-07-30 |
| repayPlanList | List | 是 | 还款计划（成功时必传） | 详见还款计划列表 |
== 还款计划信息RepayPlanItem ==
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| period | Integer | 是 | 期次 | 示例：12 |
| shouldRepayDate | String | 是 | 应还款日期 | yyyy-MM-dd 示例：2020-07-30 |
| termAmount | Long | 是 | 本期应还总额 | 单位（分） |
| termPrincipal | Long | 是 | 本期应还本金 | 单位（分） |
| termInterest | Long | 是 | 本期应还利息 | 单位（分） |
| termServiceFee | Long | 是 | 本期应还服务费 | 单位（分） |
| termPenalty | Long | 否 | 本期应还罚息 | 单位（分） |
注意说明：
除利息之外的费用，都算进服务费，服务费可为0 公式：totalAmount =repayPrincipal +totalInterest +totalServiceFee
# 5.1.2 协议预览
# 接口说明：
- 接口由宜信提供，合作方调用。在授信、绑卡、借款环节合作方可调用该接口，拉取需展示给用户的协议。
# 接口地址：
agreement.query
# 请求参数：
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| openId | String | 是 | 用户 ID | |
| flowId | String | 是 | 宜信流水号 | |
| busiType | String | 是 | 协议类型 | 授信:CREDIT 绑卡:BIND 借款:LOAN |
| extendInfo | jsonObject | 否 | 扩展字段 | 根据业务需求确定 |
扩展字段extendInfo
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| transNo | String | 否 | 业务编号 | |
| name | String | 否 | 用户姓名 | |
| idNo | String | 否 | 用户身份证号 | |
| mobileNo | String | 否 | 用户手机号 | |
| bankCardNo | String | 否 | 收款银行卡号 | |
| loanAmount | String | 否 | 借款金额(借款时必传) | |
| totalTerms | String | 否 | 借款期数 |
# 响应参数：
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| agreementsList | List | 是 | 协议列表 | 见<agreementsList>协议列表 |
agreementsList 协议列表
| 参数名称 | 类型 | 是否必须 | 说明 | 备注 |
|---|---|---|---|---|
| url | String | 是 | 协议url | |
| name | String | 是 | 协议名称 |